xref: /openbmc/linux/net/mac80211/main.c (revision e114cad7)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright 2002-2005, Instant802 Networks, Inc.
4  * Copyright 2005-2006, Devicescape Software, Inc.
5  * Copyright 2006-2007	Jiri Benc <jbenc@suse.cz>
6  * Copyright 2013-2014  Intel Mobile Communications GmbH
7  * Copyright (C) 2017     Intel Deutschland GmbH
8  * Copyright (C) 2018-2023 Intel Corporation
9  */
10 
11 #include <net/mac80211.h>
12 #include <linux/module.h>
13 #include <linux/fips.h>
14 #include <linux/init.h>
15 #include <linux/netdevice.h>
16 #include <linux/types.h>
17 #include <linux/slab.h>
18 #include <linux/skbuff.h>
19 #include <linux/etherdevice.h>
20 #include <linux/if_arp.h>
21 #include <linux/rtnetlink.h>
22 #include <linux/bitmap.h>
23 #include <linux/inetdevice.h>
24 #include <net/net_namespace.h>
25 #include <net/dropreason.h>
26 #include <net/cfg80211.h>
27 #include <net/addrconf.h>
28 
29 #include "ieee80211_i.h"
30 #include "driver-ops.h"
31 #include "rate.h"
32 #include "mesh.h"
33 #include "wep.h"
34 #include "led.h"
35 #include "debugfs.h"
36 
ieee80211_configure_filter(struct ieee80211_local * local)37 void ieee80211_configure_filter(struct ieee80211_local *local)
38 {
39 	u64 mc;
40 	unsigned int changed_flags;
41 	unsigned int new_flags = 0;
42 
43 	if (atomic_read(&local->iff_allmultis))
44 		new_flags |= FIF_ALLMULTI;
45 
46 	if (local->monitors || test_bit(SCAN_SW_SCANNING, &local->scanning) ||
47 	    test_bit(SCAN_ONCHANNEL_SCANNING, &local->scanning))
48 		new_flags |= FIF_BCN_PRBRESP_PROMISC;
49 
50 	if (local->fif_probe_req || local->probe_req_reg)
51 		new_flags |= FIF_PROBE_REQ;
52 
53 	if (local->fif_fcsfail)
54 		new_flags |= FIF_FCSFAIL;
55 
56 	if (local->fif_plcpfail)
57 		new_flags |= FIF_PLCPFAIL;
58 
59 	if (local->fif_control)
60 		new_flags |= FIF_CONTROL;
61 
62 	if (local->fif_other_bss)
63 		new_flags |= FIF_OTHER_BSS;
64 
65 	if (local->fif_pspoll)
66 		new_flags |= FIF_PSPOLL;
67 
68 	if (local->rx_mcast_action_reg)
69 		new_flags |= FIF_MCAST_ACTION;
70 
71 	spin_lock_bh(&local->filter_lock);
72 	changed_flags = local->filter_flags ^ new_flags;
73 
74 	mc = drv_prepare_multicast(local, &local->mc_list);
75 	spin_unlock_bh(&local->filter_lock);
76 
77 	/* be a bit nasty */
78 	new_flags |= (1<<31);
79 
80 	drv_configure_filter(local, changed_flags, &new_flags, mc);
81 
82 	WARN_ON(new_flags & (1<<31));
83 
84 	local->filter_flags = new_flags & ~(1<<31);
85 }
86 
ieee80211_reconfig_filter(struct work_struct * work)87 static void ieee80211_reconfig_filter(struct work_struct *work)
88 {
89 	struct ieee80211_local *local =
90 		container_of(work, struct ieee80211_local, reconfig_filter);
91 
92 	ieee80211_configure_filter(local);
93 }
94 
ieee80211_hw_conf_chan(struct ieee80211_local * local)95 static u32 ieee80211_hw_conf_chan(struct ieee80211_local *local)
96 {
97 	struct ieee80211_sub_if_data *sdata;
98 	struct cfg80211_chan_def chandef = {};
99 	u32 changed = 0;
100 	int power;
101 	u32 offchannel_flag;
102 
103 	offchannel_flag = local->hw.conf.flags & IEEE80211_CONF_OFFCHANNEL;
104 
105 	if (local->scan_chandef.chan) {
106 		chandef = local->scan_chandef;
107 	} else if (local->tmp_channel) {
108 		chandef.chan = local->tmp_channel;
109 		chandef.width = NL80211_CHAN_WIDTH_20_NOHT;
110 		chandef.center_freq1 = chandef.chan->center_freq;
111 		chandef.freq1_offset = chandef.chan->freq_offset;
112 	} else
113 		chandef = local->_oper_chandef;
114 
115 	WARN(!cfg80211_chandef_valid(&chandef),
116 	     "control:%d.%03d MHz width:%d center: %d.%03d/%d MHz",
117 	     chandef.chan->center_freq, chandef.chan->freq_offset,
118 	     chandef.width, chandef.center_freq1, chandef.freq1_offset,
119 	     chandef.center_freq2);
120 
121 	if (!cfg80211_chandef_identical(&chandef, &local->_oper_chandef))
122 		local->hw.conf.flags |= IEEE80211_CONF_OFFCHANNEL;
123 	else
124 		local->hw.conf.flags &= ~IEEE80211_CONF_OFFCHANNEL;
125 
126 	offchannel_flag ^= local->hw.conf.flags & IEEE80211_CONF_OFFCHANNEL;
127 
128 	if (offchannel_flag ||
129 	    !cfg80211_chandef_identical(&local->hw.conf.chandef,
130 					&local->_oper_chandef)) {
131 		local->hw.conf.chandef = chandef;
132 		changed |= IEEE80211_CONF_CHANGE_CHANNEL;
133 	}
134 
135 	if (!conf_is_ht(&local->hw.conf)) {
136 		/*
137 		 * mac80211.h documents that this is only valid
138 		 * when the channel is set to an HT type, and
139 		 * that otherwise STATIC is used.
140 		 */
141 		local->hw.conf.smps_mode = IEEE80211_SMPS_STATIC;
142 	} else if (local->hw.conf.smps_mode != local->smps_mode) {
143 		local->hw.conf.smps_mode = local->smps_mode;
144 		changed |= IEEE80211_CONF_CHANGE_SMPS;
145 	}
146 
147 	power = ieee80211_chandef_max_power(&chandef);
148 
149 	rcu_read_lock();
150 	list_for_each_entry_rcu(sdata, &local->interfaces, list) {
151 		if (!rcu_access_pointer(sdata->vif.bss_conf.chanctx_conf))
152 			continue;
153 		if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
154 			continue;
155 		if (sdata->vif.bss_conf.txpower == INT_MIN)
156 			continue;
157 		power = min(power, sdata->vif.bss_conf.txpower);
158 	}
159 	rcu_read_unlock();
160 
161 	if (local->hw.conf.power_level != power) {
162 		changed |= IEEE80211_CONF_CHANGE_POWER;
163 		local->hw.conf.power_level = power;
164 	}
165 
166 	return changed;
167 }
168 
ieee80211_hw_config(struct ieee80211_local * local,u32 changed)169 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed)
170 {
171 	int ret = 0;
172 
173 	might_sleep();
174 
175 	if (!local->use_chanctx)
176 		changed |= ieee80211_hw_conf_chan(local);
177 	else
178 		changed &= ~(IEEE80211_CONF_CHANGE_CHANNEL |
179 			     IEEE80211_CONF_CHANGE_POWER |
180 			     IEEE80211_CONF_CHANGE_SMPS);
181 
182 	if (changed && local->open_count) {
183 		ret = drv_config(local, changed);
184 		/*
185 		 * Goal:
186 		 * HW reconfiguration should never fail, the driver has told
187 		 * us what it can support so it should live up to that promise.
188 		 *
189 		 * Current status:
190 		 * rfkill is not integrated with mac80211 and a
191 		 * configuration command can thus fail if hardware rfkill
192 		 * is enabled
193 		 *
194 		 * FIXME: integrate rfkill with mac80211 and then add this
195 		 * WARN_ON() back
196 		 *
197 		 */
198 		/* WARN_ON(ret); */
199 	}
200 
201 	return ret;
202 }
203 
204 #define BSS_CHANGED_VIF_CFG_FLAGS (BSS_CHANGED_ASSOC |\
205 				   BSS_CHANGED_IDLE |\
206 				   BSS_CHANGED_PS |\
207 				   BSS_CHANGED_IBSS |\
208 				   BSS_CHANGED_ARP_FILTER |\
209 				   BSS_CHANGED_SSID)
210 
ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data * sdata,u64 changed)211 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
212 				      u64 changed)
213 {
214 	struct ieee80211_local *local = sdata->local;
215 
216 	might_sleep();
217 
218 	if (!changed || sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
219 		return;
220 
221 	if (WARN_ON_ONCE(changed & (BSS_CHANGED_BEACON |
222 				    BSS_CHANGED_BEACON_ENABLED) &&
223 			 sdata->vif.type != NL80211_IFTYPE_AP &&
224 			 sdata->vif.type != NL80211_IFTYPE_ADHOC &&
225 			 sdata->vif.type != NL80211_IFTYPE_MESH_POINT &&
226 			 sdata->vif.type != NL80211_IFTYPE_OCB))
227 		return;
228 
229 	if (WARN_ON_ONCE(sdata->vif.type == NL80211_IFTYPE_P2P_DEVICE ||
230 			 sdata->vif.type == NL80211_IFTYPE_NAN ||
231 			 (sdata->vif.type == NL80211_IFTYPE_MONITOR &&
232 			  !sdata->vif.bss_conf.mu_mimo_owner &&
233 			  !(changed & BSS_CHANGED_TXPOWER))))
234 		return;
235 
236 	if (!check_sdata_in_driver(sdata))
237 		return;
238 
239 	if (changed & BSS_CHANGED_VIF_CFG_FLAGS) {
240 		u64 ch = changed & BSS_CHANGED_VIF_CFG_FLAGS;
241 
242 		trace_drv_vif_cfg_changed(local, sdata, changed);
243 		if (local->ops->vif_cfg_changed)
244 			local->ops->vif_cfg_changed(&local->hw, &sdata->vif, ch);
245 	}
246 
247 	if (changed & ~BSS_CHANGED_VIF_CFG_FLAGS) {
248 		u64 ch = changed & ~BSS_CHANGED_VIF_CFG_FLAGS;
249 
250 		/* FIXME: should be for each link */
251 		trace_drv_link_info_changed(local, sdata, &sdata->vif.bss_conf,
252 					    changed);
253 		if (local->ops->link_info_changed)
254 			local->ops->link_info_changed(&local->hw, &sdata->vif,
255 						      &sdata->vif.bss_conf, ch);
256 	}
257 
258 	if (local->ops->bss_info_changed)
259 		local->ops->bss_info_changed(&local->hw, &sdata->vif,
260 					     &sdata->vif.bss_conf, changed);
261 	trace_drv_return_void(local);
262 }
263 
ieee80211_vif_cfg_change_notify(struct ieee80211_sub_if_data * sdata,u64 changed)264 void ieee80211_vif_cfg_change_notify(struct ieee80211_sub_if_data *sdata,
265 				     u64 changed)
266 {
267 	struct ieee80211_local *local = sdata->local;
268 
269 	WARN_ON_ONCE(changed & ~BSS_CHANGED_VIF_CFG_FLAGS);
270 
271 	if (!changed || sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
272 		return;
273 
274 	drv_vif_cfg_changed(local, sdata, changed);
275 }
276 
ieee80211_link_info_change_notify(struct ieee80211_sub_if_data * sdata,struct ieee80211_link_data * link,u64 changed)277 void ieee80211_link_info_change_notify(struct ieee80211_sub_if_data *sdata,
278 				       struct ieee80211_link_data *link,
279 				       u64 changed)
280 {
281 	struct ieee80211_local *local = sdata->local;
282 
283 	WARN_ON_ONCE(changed & BSS_CHANGED_VIF_CFG_FLAGS);
284 
285 	if (!changed || sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
286 		return;
287 
288 	if (!check_sdata_in_driver(sdata))
289 		return;
290 
291 	drv_link_info_changed(local, sdata, link->conf, link->link_id, changed);
292 }
293 
ieee80211_reset_erp_info(struct ieee80211_sub_if_data * sdata)294 u64 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata)
295 {
296 	sdata->vif.bss_conf.use_cts_prot = false;
297 	sdata->vif.bss_conf.use_short_preamble = false;
298 	sdata->vif.bss_conf.use_short_slot = false;
299 	return BSS_CHANGED_ERP_CTS_PROT |
300 	       BSS_CHANGED_ERP_PREAMBLE |
301 	       BSS_CHANGED_ERP_SLOT;
302 }
303 
ieee80211_tasklet_handler(struct tasklet_struct * t)304 static void ieee80211_tasklet_handler(struct tasklet_struct *t)
305 {
306 	struct ieee80211_local *local = from_tasklet(local, t, tasklet);
307 	struct sk_buff *skb;
308 
309 	while ((skb = skb_dequeue(&local->skb_queue)) ||
310 	       (skb = skb_dequeue(&local->skb_queue_unreliable))) {
311 		switch (skb->pkt_type) {
312 		case IEEE80211_RX_MSG:
313 			/* Clear skb->pkt_type in order to not confuse kernel
314 			 * netstack. */
315 			skb->pkt_type = 0;
316 			ieee80211_rx(&local->hw, skb);
317 			break;
318 		case IEEE80211_TX_STATUS_MSG:
319 			skb->pkt_type = 0;
320 			ieee80211_tx_status(&local->hw, skb);
321 			break;
322 		default:
323 			WARN(1, "mac80211: Packet is of unknown type %d\n",
324 			     skb->pkt_type);
325 			dev_kfree_skb(skb);
326 			break;
327 		}
328 	}
329 }
330 
ieee80211_restart_work(struct work_struct * work)331 static void ieee80211_restart_work(struct work_struct *work)
332 {
333 	struct ieee80211_local *local =
334 		container_of(work, struct ieee80211_local, restart_work);
335 	struct ieee80211_sub_if_data *sdata;
336 	int ret;
337 
338 	flush_workqueue(local->workqueue);
339 
340 	rtnl_lock();
341 	/* we might do interface manipulations, so need both */
342 	wiphy_lock(local->hw.wiphy);
343 
344 	WARN(test_bit(SCAN_HW_SCANNING, &local->scanning),
345 	     "%s called with hardware scan in progress\n", __func__);
346 
347 	list_for_each_entry(sdata, &local->interfaces, list) {
348 		/*
349 		 * XXX: there may be more work for other vif types and even
350 		 * for station mode: a good thing would be to run most of
351 		 * the iface type's dependent _stop (ieee80211_mg_stop,
352 		 * ieee80211_ibss_stop) etc...
353 		 * For now, fix only the specific bug that was seen: race
354 		 * between csa_connection_drop_work and us.
355 		 */
356 		if (sdata->vif.type == NL80211_IFTYPE_STATION) {
357 			/*
358 			 * This worker is scheduled from the iface worker that
359 			 * runs on mac80211's workqueue, so we can't be
360 			 * scheduling this worker after the cancel right here.
361 			 * The exception is ieee80211_chswitch_done.
362 			 * Then we can have a race...
363 			 */
364 			wiphy_work_cancel(local->hw.wiphy,
365 					  &sdata->u.mgd.csa_connection_drop_work);
366 			if (sdata->vif.bss_conf.csa_active) {
367 				sdata_lock(sdata);
368 				ieee80211_sta_connection_lost(sdata,
369 							      WLAN_REASON_UNSPECIFIED,
370 							      false);
371 				sdata_unlock(sdata);
372 			}
373 		}
374 		flush_delayed_work(&sdata->dec_tailroom_needed_wk);
375 	}
376 	ieee80211_scan_cancel(local);
377 
378 	/* make sure any new ROC will consider local->in_reconfig */
379 	wiphy_delayed_work_flush(local->hw.wiphy, &local->roc_work);
380 	wiphy_work_flush(local->hw.wiphy, &local->hw_roc_done);
381 
382 	/* wait for all packet processing to be done */
383 	synchronize_net();
384 
385 	ret = ieee80211_reconfig(local);
386 	wiphy_unlock(local->hw.wiphy);
387 
388 	if (ret)
389 		cfg80211_shutdown_all_interfaces(local->hw.wiphy);
390 
391 	rtnl_unlock();
392 }
393 
ieee80211_restart_hw(struct ieee80211_hw * hw)394 void ieee80211_restart_hw(struct ieee80211_hw *hw)
395 {
396 	struct ieee80211_local *local = hw_to_local(hw);
397 
398 	trace_api_restart_hw(local);
399 
400 	wiphy_info(hw->wiphy,
401 		   "Hardware restart was requested\n");
402 
403 	/* use this reason, ieee80211_reconfig will unblock it */
404 	ieee80211_stop_queues_by_reason(hw, IEEE80211_MAX_QUEUE_MAP,
405 					IEEE80211_QUEUE_STOP_REASON_SUSPEND,
406 					false);
407 
408 	/*
409 	 * Stop all Rx during the reconfig. We don't want state changes
410 	 * or driver callbacks while this is in progress.
411 	 */
412 	local->in_reconfig = true;
413 	barrier();
414 
415 	queue_work(system_freezable_wq, &local->restart_work);
416 }
417 EXPORT_SYMBOL(ieee80211_restart_hw);
418 
419 #ifdef CONFIG_INET
ieee80211_ifa_changed(struct notifier_block * nb,unsigned long data,void * arg)420 static int ieee80211_ifa_changed(struct notifier_block *nb,
421 				 unsigned long data, void *arg)
422 {
423 	struct in_ifaddr *ifa = arg;
424 	struct ieee80211_local *local =
425 		container_of(nb, struct ieee80211_local,
426 			     ifa_notifier);
427 	struct net_device *ndev = ifa->ifa_dev->dev;
428 	struct wireless_dev *wdev = ndev->ieee80211_ptr;
429 	struct in_device *idev;
430 	struct ieee80211_sub_if_data *sdata;
431 	struct ieee80211_vif_cfg *vif_cfg;
432 	struct ieee80211_if_managed *ifmgd;
433 	int c = 0;
434 
435 	/* Make sure it's our interface that got changed */
436 	if (!wdev)
437 		return NOTIFY_DONE;
438 
439 	if (wdev->wiphy != local->hw.wiphy)
440 		return NOTIFY_DONE;
441 
442 	sdata = IEEE80211_DEV_TO_SUB_IF(ndev);
443 	vif_cfg = &sdata->vif.cfg;
444 
445 	/* ARP filtering is only supported in managed mode */
446 	if (sdata->vif.type != NL80211_IFTYPE_STATION)
447 		return NOTIFY_DONE;
448 
449 	idev = __in_dev_get_rtnl(sdata->dev);
450 	if (!idev)
451 		return NOTIFY_DONE;
452 
453 	ifmgd = &sdata->u.mgd;
454 	sdata_lock(sdata);
455 
456 	/* Copy the addresses to the vif config list */
457 	ifa = rtnl_dereference(idev->ifa_list);
458 	while (ifa) {
459 		if (c < IEEE80211_BSS_ARP_ADDR_LIST_LEN)
460 			vif_cfg->arp_addr_list[c] = ifa->ifa_address;
461 		ifa = rtnl_dereference(ifa->ifa_next);
462 		c++;
463 	}
464 
465 	vif_cfg->arp_addr_cnt = c;
466 
467 	/* Configure driver only if associated (which also implies it is up) */
468 	if (ifmgd->associated)
469 		ieee80211_vif_cfg_change_notify(sdata, BSS_CHANGED_ARP_FILTER);
470 
471 	sdata_unlock(sdata);
472 
473 	return NOTIFY_OK;
474 }
475 #endif
476 
477 #if IS_ENABLED(CONFIG_IPV6)
ieee80211_ifa6_changed(struct notifier_block * nb,unsigned long data,void * arg)478 static int ieee80211_ifa6_changed(struct notifier_block *nb,
479 				  unsigned long data, void *arg)
480 {
481 	struct inet6_ifaddr *ifa = (struct inet6_ifaddr *)arg;
482 	struct inet6_dev *idev = ifa->idev;
483 	struct net_device *ndev = ifa->idev->dev;
484 	struct ieee80211_local *local =
485 		container_of(nb, struct ieee80211_local, ifa6_notifier);
486 	struct wireless_dev *wdev = ndev->ieee80211_ptr;
487 	struct ieee80211_sub_if_data *sdata;
488 
489 	/* Make sure it's our interface that got changed */
490 	if (!wdev || wdev->wiphy != local->hw.wiphy)
491 		return NOTIFY_DONE;
492 
493 	sdata = IEEE80211_DEV_TO_SUB_IF(ndev);
494 
495 	/*
496 	 * For now only support station mode. This is mostly because
497 	 * doing AP would have to handle AP_VLAN in some way ...
498 	 */
499 	if (sdata->vif.type != NL80211_IFTYPE_STATION)
500 		return NOTIFY_DONE;
501 
502 	drv_ipv6_addr_change(local, sdata, idev);
503 
504 	return NOTIFY_OK;
505 }
506 #endif
507 
508 /* There isn't a lot of sense in it, but you can transmit anything you like */
509 static const struct ieee80211_txrx_stypes
510 ieee80211_default_mgmt_stypes[NUM_NL80211_IFTYPES] = {
511 	[NL80211_IFTYPE_ADHOC] = {
512 		.tx = 0xffff,
513 		.rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
514 			BIT(IEEE80211_STYPE_AUTH >> 4) |
515 			BIT(IEEE80211_STYPE_DEAUTH >> 4) |
516 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
517 	},
518 	[NL80211_IFTYPE_STATION] = {
519 		.tx = 0xffff,
520 		/*
521 		 * To support Pre Association Security Negotiation (PASN) while
522 		 * already associated to one AP, allow user space to register to
523 		 * Rx authentication frames, so that the user space logic would
524 		 * be able to receive/handle authentication frames from a
525 		 * different AP as part of PASN.
526 		 * It is expected that user space would intelligently register
527 		 * for Rx authentication frames, i.e., only when PASN is used
528 		 * and configure a match filter only for PASN authentication
529 		 * algorithm, as otherwise the MLME functionality of mac80211
530 		 * would be broken.
531 		 */
532 		.rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
533 			BIT(IEEE80211_STYPE_AUTH >> 4) |
534 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
535 	},
536 	[NL80211_IFTYPE_AP] = {
537 		.tx = 0xffff,
538 		.rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
539 			BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
540 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
541 			BIT(IEEE80211_STYPE_DISASSOC >> 4) |
542 			BIT(IEEE80211_STYPE_AUTH >> 4) |
543 			BIT(IEEE80211_STYPE_DEAUTH >> 4) |
544 			BIT(IEEE80211_STYPE_ACTION >> 4),
545 	},
546 	[NL80211_IFTYPE_AP_VLAN] = {
547 		/* copy AP */
548 		.tx = 0xffff,
549 		.rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
550 			BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
551 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
552 			BIT(IEEE80211_STYPE_DISASSOC >> 4) |
553 			BIT(IEEE80211_STYPE_AUTH >> 4) |
554 			BIT(IEEE80211_STYPE_DEAUTH >> 4) |
555 			BIT(IEEE80211_STYPE_ACTION >> 4),
556 	},
557 	[NL80211_IFTYPE_P2P_CLIENT] = {
558 		.tx = 0xffff,
559 		.rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
560 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
561 	},
562 	[NL80211_IFTYPE_P2P_GO] = {
563 		.tx = 0xffff,
564 		.rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
565 			BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
566 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
567 			BIT(IEEE80211_STYPE_DISASSOC >> 4) |
568 			BIT(IEEE80211_STYPE_AUTH >> 4) |
569 			BIT(IEEE80211_STYPE_DEAUTH >> 4) |
570 			BIT(IEEE80211_STYPE_ACTION >> 4),
571 	},
572 	[NL80211_IFTYPE_MESH_POINT] = {
573 		.tx = 0xffff,
574 		.rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
575 			BIT(IEEE80211_STYPE_AUTH >> 4) |
576 			BIT(IEEE80211_STYPE_DEAUTH >> 4),
577 	},
578 	[NL80211_IFTYPE_P2P_DEVICE] = {
579 		.tx = 0xffff,
580 		.rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
581 			BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
582 	},
583 };
584 
585 static const struct ieee80211_ht_cap mac80211_ht_capa_mod_mask = {
586 	.ampdu_params_info = IEEE80211_HT_AMPDU_PARM_FACTOR |
587 			     IEEE80211_HT_AMPDU_PARM_DENSITY,
588 
589 	.cap_info = cpu_to_le16(IEEE80211_HT_CAP_SUP_WIDTH_20_40 |
590 				IEEE80211_HT_CAP_MAX_AMSDU |
591 				IEEE80211_HT_CAP_SGI_20 |
592 				IEEE80211_HT_CAP_SGI_40 |
593 				IEEE80211_HT_CAP_TX_STBC |
594 				IEEE80211_HT_CAP_RX_STBC |
595 				IEEE80211_HT_CAP_LDPC_CODING |
596 				IEEE80211_HT_CAP_40MHZ_INTOLERANT),
597 	.mcs = {
598 		.rx_mask = { 0xff, 0xff, 0xff, 0xff, 0xff,
599 			     0xff, 0xff, 0xff, 0xff, 0xff, },
600 	},
601 };
602 
603 static const struct ieee80211_vht_cap mac80211_vht_capa_mod_mask = {
604 	.vht_cap_info =
605 		cpu_to_le32(IEEE80211_VHT_CAP_RXLDPC |
606 			    IEEE80211_VHT_CAP_SHORT_GI_80 |
607 			    IEEE80211_VHT_CAP_SHORT_GI_160 |
608 			    IEEE80211_VHT_CAP_RXSTBC_MASK |
609 			    IEEE80211_VHT_CAP_TXSTBC |
610 			    IEEE80211_VHT_CAP_SU_BEAMFORMER_CAPABLE |
611 			    IEEE80211_VHT_CAP_SU_BEAMFORMEE_CAPABLE |
612 			    IEEE80211_VHT_CAP_TX_ANTENNA_PATTERN |
613 			    IEEE80211_VHT_CAP_RX_ANTENNA_PATTERN |
614 			    IEEE80211_VHT_CAP_MAX_A_MPDU_LENGTH_EXPONENT_MASK),
615 	.supp_mcs = {
616 		.rx_mcs_map = cpu_to_le16(~0),
617 		.tx_mcs_map = cpu_to_le16(~0),
618 	},
619 };
620 
ieee80211_alloc_hw_nm(size_t priv_data_len,const struct ieee80211_ops * ops,const char * requested_name)621 struct ieee80211_hw *ieee80211_alloc_hw_nm(size_t priv_data_len,
622 					   const struct ieee80211_ops *ops,
623 					   const char *requested_name)
624 {
625 	struct ieee80211_local *local;
626 	int priv_size, i;
627 	struct wiphy *wiphy;
628 	bool use_chanctx;
629 
630 	if (WARN_ON(!ops->tx || !ops->start || !ops->stop || !ops->config ||
631 		    !ops->add_interface || !ops->remove_interface ||
632 		    !ops->configure_filter || !ops->wake_tx_queue))
633 		return NULL;
634 
635 	if (WARN_ON(ops->sta_state && (ops->sta_add || ops->sta_remove)))
636 		return NULL;
637 
638 	if (WARN_ON(!!ops->link_info_changed != !!ops->vif_cfg_changed ||
639 		    (ops->link_info_changed && ops->bss_info_changed)))
640 		return NULL;
641 
642 	/* check all or no channel context operations exist */
643 	i = !!ops->add_chanctx + !!ops->remove_chanctx +
644 	    !!ops->change_chanctx + !!ops->assign_vif_chanctx +
645 	    !!ops->unassign_vif_chanctx;
646 	if (WARN_ON(i != 0 && i != 5))
647 		return NULL;
648 	use_chanctx = i == 5;
649 
650 	/* Ensure 32-byte alignment of our private data and hw private data.
651 	 * We use the wiphy priv data for both our ieee80211_local and for
652 	 * the driver's private data
653 	 *
654 	 * In memory it'll be like this:
655 	 *
656 	 * +-------------------------+
657 	 * | struct wiphy	    |
658 	 * +-------------------------+
659 	 * | struct ieee80211_local  |
660 	 * +-------------------------+
661 	 * | driver's private data   |
662 	 * +-------------------------+
663 	 *
664 	 */
665 	priv_size = ALIGN(sizeof(*local), NETDEV_ALIGN) + priv_data_len;
666 
667 	wiphy = wiphy_new_nm(&mac80211_config_ops, priv_size, requested_name);
668 
669 	if (!wiphy)
670 		return NULL;
671 
672 	wiphy->mgmt_stypes = ieee80211_default_mgmt_stypes;
673 
674 	wiphy->privid = mac80211_wiphy_privid;
675 
676 	wiphy->flags |= WIPHY_FLAG_NETNS_OK |
677 			WIPHY_FLAG_4ADDR_AP |
678 			WIPHY_FLAG_4ADDR_STATION |
679 			WIPHY_FLAG_REPORTS_OBSS |
680 			WIPHY_FLAG_OFFCHAN_TX;
681 
682 	if (!use_chanctx || ops->remain_on_channel)
683 		wiphy->flags |= WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL;
684 
685 	wiphy->features |= NL80211_FEATURE_SK_TX_STATUS |
686 			   NL80211_FEATURE_SAE |
687 			   NL80211_FEATURE_HT_IBSS |
688 			   NL80211_FEATURE_VIF_TXPOWER |
689 			   NL80211_FEATURE_MAC_ON_CREATE |
690 			   NL80211_FEATURE_USERSPACE_MPM |
691 			   NL80211_FEATURE_FULL_AP_CLIENT_STATE;
692 	wiphy_ext_feature_set(wiphy, NL80211_EXT_FEATURE_FILS_STA);
693 	wiphy_ext_feature_set(wiphy,
694 			      NL80211_EXT_FEATURE_CONTROL_PORT_OVER_NL80211);
695 	wiphy_ext_feature_set(wiphy,
696 			      NL80211_EXT_FEATURE_CONTROL_PORT_NO_PREAUTH);
697 	wiphy_ext_feature_set(wiphy,
698 			      NL80211_EXT_FEATURE_CONTROL_PORT_OVER_NL80211_TX_STATUS);
699 	wiphy_ext_feature_set(wiphy,
700 			      NL80211_EXT_FEATURE_SCAN_FREQ_KHZ);
701 	wiphy_ext_feature_set(wiphy,
702 			      NL80211_EXT_FEATURE_POWERED_ADDR_CHANGE);
703 
704 	if (!ops->hw_scan) {
705 		wiphy->features |= NL80211_FEATURE_LOW_PRIORITY_SCAN |
706 				   NL80211_FEATURE_AP_SCAN;
707 		/*
708 		 * if the driver behaves correctly using the probe request
709 		 * (template) from mac80211, then both of these should be
710 		 * supported even with hw scan - but let drivers opt in.
711 		 */
712 		wiphy_ext_feature_set(wiphy,
713 				      NL80211_EXT_FEATURE_SCAN_RANDOM_SN);
714 		wiphy_ext_feature_set(wiphy,
715 				      NL80211_EXT_FEATURE_SCAN_MIN_PREQ_CONTENT);
716 	}
717 
718 	if (!ops->set_key)
719 		wiphy->flags |= WIPHY_FLAG_IBSS_RSN;
720 
721 	wiphy_ext_feature_set(wiphy, NL80211_EXT_FEATURE_TXQS);
722 	wiphy_ext_feature_set(wiphy, NL80211_EXT_FEATURE_RRM);
723 
724 	wiphy->bss_priv_size = sizeof(struct ieee80211_bss);
725 
726 	local = wiphy_priv(wiphy);
727 
728 	if (sta_info_init(local))
729 		goto err_free;
730 
731 	local->hw.wiphy = wiphy;
732 
733 	local->hw.priv = (char *)local + ALIGN(sizeof(*local), NETDEV_ALIGN);
734 
735 	local->ops = ops;
736 	local->use_chanctx = use_chanctx;
737 
738 	/*
739 	 * We need a bit of data queued to build aggregates properly, so
740 	 * instruct the TCP stack to allow more than a single ms of data
741 	 * to be queued in the stack. The value is a bit-shift of 1
742 	 * second, so 7 is ~8ms of queued data. Only affects local TCP
743 	 * sockets.
744 	 * This is the default, anyhow - drivers may need to override it
745 	 * for local reasons (longer buffers, longer completion time, or
746 	 * similar).
747 	 */
748 	local->hw.tx_sk_pacing_shift = 7;
749 
750 	/* set up some defaults */
751 	local->hw.queues = 1;
752 	local->hw.max_rates = 1;
753 	local->hw.max_report_rates = 0;
754 	local->hw.max_rx_aggregation_subframes = IEEE80211_MAX_AMPDU_BUF_HT;
755 	local->hw.max_tx_aggregation_subframes = IEEE80211_MAX_AMPDU_BUF_HT;
756 	local->hw.offchannel_tx_hw_queue = IEEE80211_INVAL_HW_QUEUE;
757 	local->hw.conf.long_frame_max_tx_count = wiphy->retry_long;
758 	local->hw.conf.short_frame_max_tx_count = wiphy->retry_short;
759 	local->hw.radiotap_mcs_details = IEEE80211_RADIOTAP_MCS_HAVE_MCS |
760 					 IEEE80211_RADIOTAP_MCS_HAVE_GI |
761 					 IEEE80211_RADIOTAP_MCS_HAVE_BW;
762 	local->hw.radiotap_vht_details = IEEE80211_RADIOTAP_VHT_KNOWN_GI |
763 					 IEEE80211_RADIOTAP_VHT_KNOWN_BANDWIDTH;
764 	local->hw.uapsd_queues = IEEE80211_DEFAULT_UAPSD_QUEUES;
765 	local->hw.uapsd_max_sp_len = IEEE80211_DEFAULT_MAX_SP_LEN;
766 	local->hw.max_mtu = IEEE80211_MAX_DATA_LEN;
767 	local->user_power_level = IEEE80211_UNSET_POWER_LEVEL;
768 	wiphy->ht_capa_mod_mask = &mac80211_ht_capa_mod_mask;
769 	wiphy->vht_capa_mod_mask = &mac80211_vht_capa_mod_mask;
770 
771 	local->ext_capa[7] = WLAN_EXT_CAPA8_OPMODE_NOTIF;
772 
773 	wiphy->extended_capabilities = local->ext_capa;
774 	wiphy->extended_capabilities_mask = local->ext_capa;
775 	wiphy->extended_capabilities_len =
776 		ARRAY_SIZE(local->ext_capa);
777 
778 	INIT_LIST_HEAD(&local->interfaces);
779 	INIT_LIST_HEAD(&local->mon_list);
780 
781 	__hw_addr_init(&local->mc_list);
782 
783 	mutex_init(&local->iflist_mtx);
784 	mutex_init(&local->mtx);
785 
786 	mutex_init(&local->key_mtx);
787 	spin_lock_init(&local->filter_lock);
788 	spin_lock_init(&local->rx_path_lock);
789 	spin_lock_init(&local->queue_stop_reason_lock);
790 
791 	for (i = 0; i < IEEE80211_NUM_ACS; i++) {
792 		INIT_LIST_HEAD(&local->active_txqs[i]);
793 		spin_lock_init(&local->active_txq_lock[i]);
794 		local->aql_txq_limit_low[i] = IEEE80211_DEFAULT_AQL_TXQ_LIMIT_L;
795 		local->aql_txq_limit_high[i] =
796 			IEEE80211_DEFAULT_AQL_TXQ_LIMIT_H;
797 		atomic_set(&local->aql_ac_pending_airtime[i], 0);
798 	}
799 
800 	local->airtime_flags = AIRTIME_USE_TX | AIRTIME_USE_RX;
801 	local->aql_threshold = IEEE80211_AQL_THRESHOLD;
802 	atomic_set(&local->aql_total_pending_airtime, 0);
803 
804 	spin_lock_init(&local->handle_wake_tx_queue_lock);
805 
806 	INIT_LIST_HEAD(&local->chanctx_list);
807 	mutex_init(&local->chanctx_mtx);
808 
809 	wiphy_delayed_work_init(&local->scan_work, ieee80211_scan_work);
810 
811 	INIT_WORK(&local->restart_work, ieee80211_restart_work);
812 
813 	wiphy_work_init(&local->radar_detected_work,
814 			ieee80211_dfs_radar_detected_work);
815 
816 	INIT_WORK(&local->reconfig_filter, ieee80211_reconfig_filter);
817 	local->smps_mode = IEEE80211_SMPS_OFF;
818 
819 	INIT_WORK(&local->dynamic_ps_enable_work,
820 		  ieee80211_dynamic_ps_enable_work);
821 	INIT_WORK(&local->dynamic_ps_disable_work,
822 		  ieee80211_dynamic_ps_disable_work);
823 	timer_setup(&local->dynamic_ps_timer, ieee80211_dynamic_ps_timer, 0);
824 
825 	wiphy_work_init(&local->sched_scan_stopped_work,
826 			ieee80211_sched_scan_stopped_work);
827 
828 	spin_lock_init(&local->ack_status_lock);
829 	idr_init(&local->ack_status_frames);
830 
831 	for (i = 0; i < IEEE80211_MAX_QUEUES; i++) {
832 		skb_queue_head_init(&local->pending[i]);
833 		atomic_set(&local->agg_queue_stop[i], 0);
834 	}
835 	tasklet_setup(&local->tx_pending_tasklet, ieee80211_tx_pending);
836 	tasklet_setup(&local->wake_txqs_tasklet, ieee80211_wake_txqs);
837 	tasklet_setup(&local->tasklet, ieee80211_tasklet_handler);
838 
839 	skb_queue_head_init(&local->skb_queue);
840 	skb_queue_head_init(&local->skb_queue_unreliable);
841 
842 	ieee80211_alloc_led_names(local);
843 
844 	ieee80211_roc_setup(local);
845 
846 	local->hw.radiotap_timestamp.units_pos = -1;
847 	local->hw.radiotap_timestamp.accuracy = -1;
848 
849 	return &local->hw;
850  err_free:
851 	wiphy_free(wiphy);
852 	return NULL;
853 }
854 EXPORT_SYMBOL(ieee80211_alloc_hw_nm);
855 
ieee80211_init_cipher_suites(struct ieee80211_local * local)856 static int ieee80211_init_cipher_suites(struct ieee80211_local *local)
857 {
858 	bool have_wep = !fips_enabled; /* FIPS does not permit the use of RC4 */
859 	bool have_mfp = ieee80211_hw_check(&local->hw, MFP_CAPABLE);
860 	int r = 0, w = 0;
861 	u32 *suites;
862 	static const u32 cipher_suites[] = {
863 		/* keep WEP first, it may be removed below */
864 		WLAN_CIPHER_SUITE_WEP40,
865 		WLAN_CIPHER_SUITE_WEP104,
866 		WLAN_CIPHER_SUITE_TKIP,
867 		WLAN_CIPHER_SUITE_CCMP,
868 		WLAN_CIPHER_SUITE_CCMP_256,
869 		WLAN_CIPHER_SUITE_GCMP,
870 		WLAN_CIPHER_SUITE_GCMP_256,
871 
872 		/* keep last -- depends on hw flags! */
873 		WLAN_CIPHER_SUITE_AES_CMAC,
874 		WLAN_CIPHER_SUITE_BIP_CMAC_256,
875 		WLAN_CIPHER_SUITE_BIP_GMAC_128,
876 		WLAN_CIPHER_SUITE_BIP_GMAC_256,
877 	};
878 
879 	if (ieee80211_hw_check(&local->hw, SW_CRYPTO_CONTROL) ||
880 	    local->hw.wiphy->cipher_suites) {
881 		/* If the driver advertises, or doesn't support SW crypto,
882 		 * we only need to remove WEP if necessary.
883 		 */
884 		if (have_wep)
885 			return 0;
886 
887 		/* well if it has _no_ ciphers ... fine */
888 		if (!local->hw.wiphy->n_cipher_suites)
889 			return 0;
890 
891 		/* Driver provides cipher suites, but we need to exclude WEP */
892 		suites = kmemdup(local->hw.wiphy->cipher_suites,
893 				 sizeof(u32) * local->hw.wiphy->n_cipher_suites,
894 				 GFP_KERNEL);
895 		if (!suites)
896 			return -ENOMEM;
897 
898 		for (r = 0; r < local->hw.wiphy->n_cipher_suites; r++) {
899 			u32 suite = local->hw.wiphy->cipher_suites[r];
900 
901 			if (suite == WLAN_CIPHER_SUITE_WEP40 ||
902 			    suite == WLAN_CIPHER_SUITE_WEP104)
903 				continue;
904 			suites[w++] = suite;
905 		}
906 	} else {
907 		/* assign the (software supported and perhaps offloaded)
908 		 * cipher suites
909 		 */
910 		local->hw.wiphy->cipher_suites = cipher_suites;
911 		local->hw.wiphy->n_cipher_suites = ARRAY_SIZE(cipher_suites);
912 
913 		if (!have_mfp)
914 			local->hw.wiphy->n_cipher_suites -= 4;
915 
916 		if (!have_wep) {
917 			local->hw.wiphy->cipher_suites += 2;
918 			local->hw.wiphy->n_cipher_suites -= 2;
919 		}
920 
921 		/* not dynamically allocated, so just return */
922 		return 0;
923 	}
924 
925 	local->hw.wiphy->cipher_suites = suites;
926 	local->hw.wiphy->n_cipher_suites = w;
927 	local->wiphy_ciphers_allocated = true;
928 
929 	return 0;
930 }
931 
ieee80211_register_hw(struct ieee80211_hw * hw)932 int ieee80211_register_hw(struct ieee80211_hw *hw)
933 {
934 	struct ieee80211_local *local = hw_to_local(hw);
935 	int result, i;
936 	enum nl80211_band band;
937 	int channels, max_bitrates;
938 	bool supp_ht, supp_vht, supp_he, supp_eht;
939 	struct cfg80211_chan_def dflt_chandef = {};
940 
941 	if (ieee80211_hw_check(hw, QUEUE_CONTROL) &&
942 	    (local->hw.offchannel_tx_hw_queue == IEEE80211_INVAL_HW_QUEUE ||
943 	     local->hw.offchannel_tx_hw_queue >= local->hw.queues))
944 		return -EINVAL;
945 
946 	if ((hw->wiphy->features & NL80211_FEATURE_TDLS_CHANNEL_SWITCH) &&
947 	    (!local->ops->tdls_channel_switch ||
948 	     !local->ops->tdls_cancel_channel_switch ||
949 	     !local->ops->tdls_recv_channel_switch))
950 		return -EOPNOTSUPP;
951 
952 	if (WARN_ON(ieee80211_hw_check(hw, SUPPORTS_TX_FRAG) &&
953 		    !local->ops->set_frag_threshold))
954 		return -EINVAL;
955 
956 	if (WARN_ON(local->hw.wiphy->interface_modes &
957 			BIT(NL80211_IFTYPE_NAN) &&
958 		    (!local->ops->start_nan || !local->ops->stop_nan)))
959 		return -EINVAL;
960 
961 	if (hw->wiphy->flags & WIPHY_FLAG_SUPPORTS_MLO) {
962 		/*
963 		 * For drivers capable of doing MLO, assume modern driver
964 		 * or firmware facilities, so software doesn't have to do
965 		 * as much, e.g. monitoring beacons would be hard if we
966 		 * might not even know which link is active at which time.
967 		 */
968 		if (WARN_ON(!local->use_chanctx))
969 			return -EINVAL;
970 
971 		if (WARN_ON(!local->ops->link_info_changed))
972 			return -EINVAL;
973 
974 		if (WARN_ON(!ieee80211_hw_check(hw, HAS_RATE_CONTROL)))
975 			return -EINVAL;
976 
977 		if (WARN_ON(!ieee80211_hw_check(hw, AMPDU_AGGREGATION)))
978 			return -EINVAL;
979 
980 		if (WARN_ON(ieee80211_hw_check(hw, HOST_BROADCAST_PS_BUFFERING)))
981 			return -EINVAL;
982 
983 		if (WARN_ON(ieee80211_hw_check(hw, SUPPORTS_PS) &&
984 			    (!ieee80211_hw_check(hw, SUPPORTS_DYNAMIC_PS) ||
985 			     ieee80211_hw_check(hw, PS_NULLFUNC_STACK))))
986 			return -EINVAL;
987 
988 		if (WARN_ON(!ieee80211_hw_check(hw, MFP_CAPABLE)))
989 			return -EINVAL;
990 
991 		if (WARN_ON(!ieee80211_hw_check(hw, CONNECTION_MONITOR)))
992 			return -EINVAL;
993 
994 		if (WARN_ON(ieee80211_hw_check(hw, NEED_DTIM_BEFORE_ASSOC)))
995 			return -EINVAL;
996 
997 		if (WARN_ON(ieee80211_hw_check(hw, TIMING_BEACON_ONLY)))
998 			return -EINVAL;
999 
1000 		if (WARN_ON(!ieee80211_hw_check(hw, AP_LINK_PS)))
1001 			return -EINVAL;
1002 
1003 		if (WARN_ON(ieee80211_hw_check(hw, DEAUTH_NEED_MGD_TX_PREP)))
1004 			return -EINVAL;
1005 	}
1006 
1007 #ifdef CONFIG_PM
1008 	if (hw->wiphy->wowlan && (!local->ops->suspend || !local->ops->resume))
1009 		return -EINVAL;
1010 #endif
1011 
1012 	if (!local->use_chanctx) {
1013 		for (i = 0; i < local->hw.wiphy->n_iface_combinations; i++) {
1014 			const struct ieee80211_iface_combination *comb;
1015 
1016 			comb = &local->hw.wiphy->iface_combinations[i];
1017 
1018 			if (comb->num_different_channels > 1)
1019 				return -EINVAL;
1020 		}
1021 	} else {
1022 		/* DFS is not supported with multi-channel combinations yet */
1023 		for (i = 0; i < local->hw.wiphy->n_iface_combinations; i++) {
1024 			const struct ieee80211_iface_combination *comb;
1025 
1026 			comb = &local->hw.wiphy->iface_combinations[i];
1027 
1028 			if (comb->radar_detect_widths &&
1029 			    comb->num_different_channels > 1)
1030 				return -EINVAL;
1031 		}
1032 	}
1033 
1034 	/* Only HW csum features are currently compatible with mac80211 */
1035 	if (WARN_ON(hw->netdev_features & ~MAC80211_SUPPORTED_FEATURES))
1036 		return -EINVAL;
1037 
1038 	if (hw->max_report_rates == 0)
1039 		hw->max_report_rates = hw->max_rates;
1040 
1041 	local->rx_chains = 1;
1042 
1043 	/*
1044 	 * generic code guarantees at least one band,
1045 	 * set this very early because much code assumes
1046 	 * that hw.conf.channel is assigned
1047 	 */
1048 	channels = 0;
1049 	max_bitrates = 0;
1050 	supp_ht = false;
1051 	supp_vht = false;
1052 	supp_he = false;
1053 	supp_eht = false;
1054 	for (band = 0; band < NUM_NL80211_BANDS; band++) {
1055 		struct ieee80211_supported_band *sband;
1056 
1057 		sband = local->hw.wiphy->bands[band];
1058 		if (!sband)
1059 			continue;
1060 
1061 		if (!dflt_chandef.chan) {
1062 			/*
1063 			 * Assign the first enabled channel to dflt_chandef
1064 			 * from the list of channels
1065 			 */
1066 			for (i = 0; i < sband->n_channels; i++)
1067 				if (!(sband->channels[i].flags &
1068 						IEEE80211_CHAN_DISABLED))
1069 					break;
1070 			/* if none found then use the first anyway */
1071 			if (i == sband->n_channels)
1072 				i = 0;
1073 			cfg80211_chandef_create(&dflt_chandef,
1074 						&sband->channels[i],
1075 						NL80211_CHAN_NO_HT);
1076 			/* init channel we're on */
1077 			if (!local->use_chanctx && !local->_oper_chandef.chan) {
1078 				local->hw.conf.chandef = dflt_chandef;
1079 				local->_oper_chandef = dflt_chandef;
1080 			}
1081 			local->monitor_chandef = dflt_chandef;
1082 		}
1083 
1084 		channels += sband->n_channels;
1085 
1086 		/*
1087 		 * Due to the way the aggregation code handles this and it
1088 		 * being an HT capability, we can't really support delayed
1089 		 * BA in MLO (yet).
1090 		 */
1091 		if (WARN_ON(sband->ht_cap.ht_supported &&
1092 			    (sband->ht_cap.cap & IEEE80211_HT_CAP_DELAY_BA) &&
1093 			    hw->wiphy->flags & WIPHY_FLAG_SUPPORTS_MLO))
1094 			return -EINVAL;
1095 
1096 		if (max_bitrates < sband->n_bitrates)
1097 			max_bitrates = sband->n_bitrates;
1098 		supp_ht = supp_ht || sband->ht_cap.ht_supported;
1099 		supp_vht = supp_vht || sband->vht_cap.vht_supported;
1100 
1101 		for (i = 0; i < sband->n_iftype_data; i++) {
1102 			const struct ieee80211_sband_iftype_data *iftd;
1103 
1104 			iftd = &sband->iftype_data[i];
1105 
1106 			supp_he = supp_he || iftd->he_cap.has_he;
1107 			supp_eht = supp_eht || iftd->eht_cap.has_eht;
1108 		}
1109 
1110 		/* HT, VHT, HE require QoS, thus >= 4 queues */
1111 		if (WARN_ON(local->hw.queues < IEEE80211_NUM_ACS &&
1112 			    (supp_ht || supp_vht || supp_he)))
1113 			return -EINVAL;
1114 
1115 		/* EHT requires HE support */
1116 		if (WARN_ON(supp_eht && !supp_he))
1117 			return -EINVAL;
1118 
1119 		if (!sband->ht_cap.ht_supported)
1120 			continue;
1121 
1122 		/* TODO: consider VHT for RX chains, hopefully it's the same */
1123 		local->rx_chains =
1124 			max(ieee80211_mcs_to_chains(&sband->ht_cap.mcs),
1125 			    local->rx_chains);
1126 
1127 		/* no need to mask, SM_PS_DISABLED has all bits set */
1128 		sband->ht_cap.cap |= WLAN_HT_CAP_SM_PS_DISABLED <<
1129 			             IEEE80211_HT_CAP_SM_PS_SHIFT;
1130 	}
1131 
1132 	/* if low-level driver supports AP, we also support VLAN.
1133 	 * drivers advertising SW_CRYPTO_CONTROL should enable AP_VLAN
1134 	 * based on their support to transmit SW encrypted packets.
1135 	 */
1136 	if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_AP) &&
1137 	    !ieee80211_hw_check(&local->hw, SW_CRYPTO_CONTROL)) {
1138 		hw->wiphy->interface_modes |= BIT(NL80211_IFTYPE_AP_VLAN);
1139 		hw->wiphy->software_iftypes |= BIT(NL80211_IFTYPE_AP_VLAN);
1140 	}
1141 
1142 	/* mac80211 always supports monitor */
1143 	hw->wiphy->interface_modes |= BIT(NL80211_IFTYPE_MONITOR);
1144 	hw->wiphy->software_iftypes |= BIT(NL80211_IFTYPE_MONITOR);
1145 
1146 	/* mac80211 doesn't support more than one IBSS interface right now */
1147 	for (i = 0; i < hw->wiphy->n_iface_combinations; i++) {
1148 		const struct ieee80211_iface_combination *c;
1149 		int j;
1150 
1151 		c = &hw->wiphy->iface_combinations[i];
1152 
1153 		for (j = 0; j < c->n_limits; j++)
1154 			if ((c->limits[j].types & BIT(NL80211_IFTYPE_ADHOC)) &&
1155 			    c->limits[j].max > 1)
1156 				return -EINVAL;
1157 	}
1158 
1159 	local->int_scan_req = kzalloc(sizeof(*local->int_scan_req) +
1160 				      sizeof(void *) * channels, GFP_KERNEL);
1161 	if (!local->int_scan_req)
1162 		return -ENOMEM;
1163 
1164 	eth_broadcast_addr(local->int_scan_req->bssid);
1165 
1166 	for (band = 0; band < NUM_NL80211_BANDS; band++) {
1167 		if (!local->hw.wiphy->bands[band])
1168 			continue;
1169 		local->int_scan_req->rates[band] = (u32) -1;
1170 	}
1171 
1172 #ifndef CONFIG_MAC80211_MESH
1173 	/* mesh depends on Kconfig, but drivers should set it if they want */
1174 	local->hw.wiphy->interface_modes &= ~BIT(NL80211_IFTYPE_MESH_POINT);
1175 #endif
1176 
1177 	/* if the underlying driver supports mesh, mac80211 will (at least)
1178 	 * provide routing of mesh authentication frames to userspace */
1179 	if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_MESH_POINT))
1180 		local->hw.wiphy->flags |= WIPHY_FLAG_MESH_AUTH;
1181 
1182 	/* mac80211 supports control port protocol changing */
1183 	local->hw.wiphy->flags |= WIPHY_FLAG_CONTROL_PORT_PROTOCOL;
1184 
1185 	if (ieee80211_hw_check(&local->hw, SIGNAL_DBM)) {
1186 		local->hw.wiphy->signal_type = CFG80211_SIGNAL_TYPE_MBM;
1187 	} else if (ieee80211_hw_check(&local->hw, SIGNAL_UNSPEC)) {
1188 		local->hw.wiphy->signal_type = CFG80211_SIGNAL_TYPE_UNSPEC;
1189 		if (hw->max_signal <= 0) {
1190 			result = -EINVAL;
1191 			goto fail_workqueue;
1192 		}
1193 	}
1194 
1195 	/* Mac80211 and therefore all drivers using SW crypto only
1196 	 * are able to handle PTK rekeys and Extended Key ID.
1197 	 */
1198 	if (!local->ops->set_key) {
1199 		wiphy_ext_feature_set(local->hw.wiphy,
1200 				      NL80211_EXT_FEATURE_CAN_REPLACE_PTK0);
1201 		wiphy_ext_feature_set(local->hw.wiphy,
1202 				      NL80211_EXT_FEATURE_EXT_KEY_ID);
1203 	}
1204 
1205 	if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_ADHOC))
1206 		wiphy_ext_feature_set(local->hw.wiphy,
1207 				      NL80211_EXT_FEATURE_DEL_IBSS_STA);
1208 
1209 	/*
1210 	 * Calculate scan IE length -- we need this to alloc
1211 	 * memory and to subtract from the driver limit. It
1212 	 * includes the DS Params, (extended) supported rates, and HT
1213 	 * information -- SSID is the driver's responsibility.
1214 	 */
1215 	local->scan_ies_len = 4 + max_bitrates /* (ext) supp rates */ +
1216 		3 /* DS Params */;
1217 	if (supp_ht)
1218 		local->scan_ies_len += 2 + sizeof(struct ieee80211_ht_cap);
1219 
1220 	if (supp_vht)
1221 		local->scan_ies_len +=
1222 			2 + sizeof(struct ieee80211_vht_cap);
1223 
1224 	/*
1225 	 * HE cap element is variable in size - set len to allow max size */
1226 	if (supp_he) {
1227 		local->scan_ies_len +=
1228 			3 + sizeof(struct ieee80211_he_cap_elem) +
1229 			sizeof(struct ieee80211_he_mcs_nss_supp) +
1230 			IEEE80211_HE_PPE_THRES_MAX_LEN;
1231 
1232 		if (supp_eht)
1233 			local->scan_ies_len +=
1234 				3 + sizeof(struct ieee80211_eht_cap_elem) +
1235 				sizeof(struct ieee80211_eht_mcs_nss_supp) +
1236 				IEEE80211_EHT_PPE_THRES_MAX_LEN;
1237 	}
1238 
1239 	if (!local->ops->hw_scan) {
1240 		/* For hw_scan, driver needs to set these up. */
1241 		local->hw.wiphy->max_scan_ssids = 4;
1242 		local->hw.wiphy->max_scan_ie_len = IEEE80211_MAX_DATA_LEN;
1243 	}
1244 
1245 	/*
1246 	 * If the driver supports any scan IEs, then assume the
1247 	 * limit includes the IEs mac80211 will add, otherwise
1248 	 * leave it at zero and let the driver sort it out; we
1249 	 * still pass our IEs to the driver but userspace will
1250 	 * not be allowed to in that case.
1251 	 */
1252 	if (local->hw.wiphy->max_scan_ie_len)
1253 		local->hw.wiphy->max_scan_ie_len -= local->scan_ies_len;
1254 
1255 	result = ieee80211_init_cipher_suites(local);
1256 	if (result < 0)
1257 		goto fail_workqueue;
1258 
1259 	if (!local->ops->remain_on_channel)
1260 		local->hw.wiphy->max_remain_on_channel_duration = 5000;
1261 
1262 	/* mac80211 based drivers don't support internal TDLS setup */
1263 	if (local->hw.wiphy->flags & WIPHY_FLAG_SUPPORTS_TDLS)
1264 		local->hw.wiphy->flags |= WIPHY_FLAG_TDLS_EXTERNAL_SETUP;
1265 
1266 	/* mac80211 supports eCSA, if the driver supports STA CSA at all */
1267 	if (ieee80211_hw_check(&local->hw, CHANCTX_STA_CSA))
1268 		local->ext_capa[0] |= WLAN_EXT_CAPA1_EXT_CHANNEL_SWITCHING;
1269 
1270 	/* mac80211 supports multi BSSID, if the driver supports it */
1271 	if (ieee80211_hw_check(&local->hw, SUPPORTS_MULTI_BSSID)) {
1272 		local->hw.wiphy->support_mbssid = true;
1273 		if (ieee80211_hw_check(&local->hw,
1274 				       SUPPORTS_ONLY_HE_MULTI_BSSID))
1275 			local->hw.wiphy->support_only_he_mbssid = true;
1276 		else
1277 			local->ext_capa[2] |=
1278 				WLAN_EXT_CAPA3_MULTI_BSSID_SUPPORT;
1279 	}
1280 
1281 	local->hw.wiphy->max_num_csa_counters = IEEE80211_MAX_CNTDWN_COUNTERS_NUM;
1282 
1283 	/*
1284 	 * We use the number of queues for feature tests (QoS, HT) internally
1285 	 * so restrict them appropriately.
1286 	 */
1287 	if (hw->queues > IEEE80211_MAX_QUEUES)
1288 		hw->queues = IEEE80211_MAX_QUEUES;
1289 
1290 	local->workqueue =
1291 		alloc_ordered_workqueue("%s", 0, wiphy_name(local->hw.wiphy));
1292 	if (!local->workqueue) {
1293 		result = -ENOMEM;
1294 		goto fail_workqueue;
1295 	}
1296 
1297 	/*
1298 	 * The hardware needs headroom for sending the frame,
1299 	 * and we need some headroom for passing the frame to monitor
1300 	 * interfaces, but never both at the same time.
1301 	 */
1302 	local->tx_headroom = max_t(unsigned int , local->hw.extra_tx_headroom,
1303 				   IEEE80211_TX_STATUS_HEADROOM);
1304 
1305 	/*
1306 	 * if the driver doesn't specify a max listen interval we
1307 	 * use 5 which should be a safe default
1308 	 */
1309 	if (local->hw.max_listen_interval == 0)
1310 		local->hw.max_listen_interval = 5;
1311 
1312 	local->hw.conf.listen_interval = local->hw.max_listen_interval;
1313 
1314 	local->dynamic_ps_forced_timeout = -1;
1315 
1316 	if (!local->hw.max_nan_de_entries)
1317 		local->hw.max_nan_de_entries = IEEE80211_MAX_NAN_INSTANCE_ID;
1318 
1319 	if (!local->hw.weight_multiplier)
1320 		local->hw.weight_multiplier = 1;
1321 
1322 	ieee80211_wep_init(local);
1323 
1324 	local->hw.conf.flags = IEEE80211_CONF_IDLE;
1325 
1326 	ieee80211_led_init(local);
1327 
1328 	result = ieee80211_txq_setup_flows(local);
1329 	if (result)
1330 		goto fail_flows;
1331 
1332 	rtnl_lock();
1333 	result = ieee80211_init_rate_ctrl_alg(local,
1334 					      hw->rate_control_algorithm);
1335 	rtnl_unlock();
1336 	if (result < 0) {
1337 		wiphy_debug(local->hw.wiphy,
1338 			    "Failed to initialize rate control algorithm\n");
1339 		goto fail_rate;
1340 	}
1341 
1342 	if (local->rate_ctrl) {
1343 		clear_bit(IEEE80211_HW_SUPPORTS_VHT_EXT_NSS_BW, hw->flags);
1344 		if (local->rate_ctrl->ops->capa & RATE_CTRL_CAPA_VHT_EXT_NSS_BW)
1345 			ieee80211_hw_set(hw, SUPPORTS_VHT_EXT_NSS_BW);
1346 	}
1347 
1348 	/*
1349 	 * If the VHT capabilities don't have IEEE80211_VHT_EXT_NSS_BW_CAPABLE,
1350 	 * or have it when we don't, copy the sband structure and set/clear it.
1351 	 * This is necessary because rate scaling algorithms could be switched
1352 	 * and have different support values.
1353 	 * Print a message so that in the common case the reallocation can be
1354 	 * avoided.
1355 	 */
1356 	BUILD_BUG_ON(NUM_NL80211_BANDS > 8 * sizeof(local->sband_allocated));
1357 	for (band = 0; band < NUM_NL80211_BANDS; band++) {
1358 		struct ieee80211_supported_band *sband;
1359 		bool local_cap, ie_cap;
1360 
1361 		local_cap = ieee80211_hw_check(hw, SUPPORTS_VHT_EXT_NSS_BW);
1362 
1363 		sband = local->hw.wiphy->bands[band];
1364 		if (!sband || !sband->vht_cap.vht_supported)
1365 			continue;
1366 
1367 		ie_cap = !!(sband->vht_cap.vht_mcs.tx_highest &
1368 			    cpu_to_le16(IEEE80211_VHT_EXT_NSS_BW_CAPABLE));
1369 
1370 		if (local_cap == ie_cap)
1371 			continue;
1372 
1373 		sband = kmemdup(sband, sizeof(*sband), GFP_KERNEL);
1374 		if (!sband) {
1375 			result = -ENOMEM;
1376 			goto fail_rate;
1377 		}
1378 
1379 		wiphy_dbg(hw->wiphy, "copying sband (band %d) due to VHT EXT NSS BW flag\n",
1380 			  band);
1381 
1382 		sband->vht_cap.vht_mcs.tx_highest ^=
1383 			cpu_to_le16(IEEE80211_VHT_EXT_NSS_BW_CAPABLE);
1384 
1385 		local->hw.wiphy->bands[band] = sband;
1386 		local->sband_allocated |= BIT(band);
1387 	}
1388 
1389 	result = wiphy_register(local->hw.wiphy);
1390 	if (result < 0)
1391 		goto fail_wiphy_register;
1392 
1393 	debugfs_hw_add(local);
1394 	rate_control_add_debugfs(local);
1395 
1396 	rtnl_lock();
1397 	wiphy_lock(hw->wiphy);
1398 
1399 	/* add one default STA interface if supported */
1400 	if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_STATION) &&
1401 	    !ieee80211_hw_check(hw, NO_AUTO_VIF)) {
1402 		struct vif_params params = {0};
1403 
1404 		result = ieee80211_if_add(local, "wlan%d", NET_NAME_ENUM, NULL,
1405 					  NL80211_IFTYPE_STATION, &params);
1406 		if (result)
1407 			wiphy_warn(local->hw.wiphy,
1408 				   "Failed to add default virtual iface\n");
1409 	}
1410 
1411 	wiphy_unlock(hw->wiphy);
1412 	rtnl_unlock();
1413 
1414 #ifdef CONFIG_INET
1415 	local->ifa_notifier.notifier_call = ieee80211_ifa_changed;
1416 	result = register_inetaddr_notifier(&local->ifa_notifier);
1417 	if (result)
1418 		goto fail_ifa;
1419 #endif
1420 
1421 #if IS_ENABLED(CONFIG_IPV6)
1422 	local->ifa6_notifier.notifier_call = ieee80211_ifa6_changed;
1423 	result = register_inet6addr_notifier(&local->ifa6_notifier);
1424 	if (result)
1425 		goto fail_ifa6;
1426 #endif
1427 
1428 	return 0;
1429 
1430 #if IS_ENABLED(CONFIG_IPV6)
1431  fail_ifa6:
1432 #ifdef CONFIG_INET
1433 	unregister_inetaddr_notifier(&local->ifa_notifier);
1434 #endif
1435 #endif
1436 #if defined(CONFIG_INET) || defined(CONFIG_IPV6)
1437  fail_ifa:
1438 #endif
1439 	wiphy_unregister(local->hw.wiphy);
1440  fail_wiphy_register:
1441 	rtnl_lock();
1442 	rate_control_deinitialize(local);
1443 	ieee80211_remove_interfaces(local);
1444 	rtnl_unlock();
1445  fail_rate:
1446  fail_flows:
1447 	ieee80211_led_exit(local);
1448 	destroy_workqueue(local->workqueue);
1449  fail_workqueue:
1450 	if (local->wiphy_ciphers_allocated) {
1451 		kfree(local->hw.wiphy->cipher_suites);
1452 		local->wiphy_ciphers_allocated = false;
1453 	}
1454 	kfree(local->int_scan_req);
1455 	return result;
1456 }
1457 EXPORT_SYMBOL(ieee80211_register_hw);
1458 
ieee80211_unregister_hw(struct ieee80211_hw * hw)1459 void ieee80211_unregister_hw(struct ieee80211_hw *hw)
1460 {
1461 	struct ieee80211_local *local = hw_to_local(hw);
1462 
1463 	tasklet_kill(&local->tx_pending_tasklet);
1464 	tasklet_kill(&local->tasklet);
1465 
1466 #ifdef CONFIG_INET
1467 	unregister_inetaddr_notifier(&local->ifa_notifier);
1468 #endif
1469 #if IS_ENABLED(CONFIG_IPV6)
1470 	unregister_inet6addr_notifier(&local->ifa6_notifier);
1471 #endif
1472 
1473 	rtnl_lock();
1474 
1475 	/*
1476 	 * At this point, interface list manipulations are fine
1477 	 * because the driver cannot be handing us frames any
1478 	 * more and the tasklet is killed.
1479 	 */
1480 	ieee80211_remove_interfaces(local);
1481 
1482 	wiphy_lock(local->hw.wiphy);
1483 	wiphy_delayed_work_cancel(local->hw.wiphy, &local->roc_work);
1484 	wiphy_work_cancel(local->hw.wiphy, &local->sched_scan_stopped_work);
1485 	wiphy_work_cancel(local->hw.wiphy, &local->radar_detected_work);
1486 	wiphy_unlock(local->hw.wiphy);
1487 	rtnl_unlock();
1488 
1489 	cancel_work_sync(&local->restart_work);
1490 	cancel_work_sync(&local->reconfig_filter);
1491 
1492 	ieee80211_clear_tx_pending(local);
1493 	rate_control_deinitialize(local);
1494 
1495 	if (skb_queue_len(&local->skb_queue) ||
1496 	    skb_queue_len(&local->skb_queue_unreliable))
1497 		wiphy_warn(local->hw.wiphy, "skb_queue not empty\n");
1498 	skb_queue_purge(&local->skb_queue);
1499 	skb_queue_purge(&local->skb_queue_unreliable);
1500 
1501 	wiphy_unregister(local->hw.wiphy);
1502 	destroy_workqueue(local->workqueue);
1503 	ieee80211_led_exit(local);
1504 	kfree(local->int_scan_req);
1505 }
1506 EXPORT_SYMBOL(ieee80211_unregister_hw);
1507 
ieee80211_free_ack_frame(int id,void * p,void * data)1508 static int ieee80211_free_ack_frame(int id, void *p, void *data)
1509 {
1510 	WARN_ONCE(1, "Have pending ack frames!\n");
1511 	kfree_skb(p);
1512 	return 0;
1513 }
1514 
ieee80211_free_hw(struct ieee80211_hw * hw)1515 void ieee80211_free_hw(struct ieee80211_hw *hw)
1516 {
1517 	struct ieee80211_local *local = hw_to_local(hw);
1518 	enum nl80211_band band;
1519 
1520 	mutex_destroy(&local->iflist_mtx);
1521 	mutex_destroy(&local->mtx);
1522 
1523 	if (local->wiphy_ciphers_allocated) {
1524 		kfree(local->hw.wiphy->cipher_suites);
1525 		local->wiphy_ciphers_allocated = false;
1526 	}
1527 
1528 	idr_for_each(&local->ack_status_frames,
1529 		     ieee80211_free_ack_frame, NULL);
1530 	idr_destroy(&local->ack_status_frames);
1531 
1532 	sta_info_stop(local);
1533 
1534 	ieee80211_free_led_names(local);
1535 
1536 	for (band = 0; band < NUM_NL80211_BANDS; band++) {
1537 		if (!(local->sband_allocated & BIT(band)))
1538 			continue;
1539 		kfree(local->hw.wiphy->bands[band]);
1540 	}
1541 
1542 	wiphy_free(local->hw.wiphy);
1543 }
1544 EXPORT_SYMBOL(ieee80211_free_hw);
1545 
1546 static const char * const drop_reasons_monitor[] = {
1547 #define V(x)	#x,
1548 	[0] = "RX_DROP_MONITOR",
1549 	MAC80211_DROP_REASONS_MONITOR(V)
1550 };
1551 
1552 static struct drop_reason_list drop_reason_list_monitor = {
1553 	.reasons = drop_reasons_monitor,
1554 	.n_reasons = ARRAY_SIZE(drop_reasons_monitor),
1555 };
1556 
1557 static const char * const drop_reasons_unusable[] = {
1558 	[0] = "RX_DROP_UNUSABLE",
1559 	MAC80211_DROP_REASONS_UNUSABLE(V)
1560 #undef V
1561 };
1562 
1563 static struct drop_reason_list drop_reason_list_unusable = {
1564 	.reasons = drop_reasons_unusable,
1565 	.n_reasons = ARRAY_SIZE(drop_reasons_unusable),
1566 };
1567 
ieee80211_init(void)1568 static int __init ieee80211_init(void)
1569 {
1570 	struct sk_buff *skb;
1571 	int ret;
1572 
1573 	BUILD_BUG_ON(sizeof(struct ieee80211_tx_info) > sizeof(skb->cb));
1574 	BUILD_BUG_ON(offsetof(struct ieee80211_tx_info, driver_data) +
1575 		     IEEE80211_TX_INFO_DRIVER_DATA_SIZE > sizeof(skb->cb));
1576 
1577 	ret = rc80211_minstrel_init();
1578 	if (ret)
1579 		return ret;
1580 
1581 	ret = ieee80211_iface_init();
1582 	if (ret)
1583 		goto err_netdev;
1584 
1585 	drop_reasons_register_subsys(SKB_DROP_REASON_SUBSYS_MAC80211_MONITOR,
1586 				     &drop_reason_list_monitor);
1587 	drop_reasons_register_subsys(SKB_DROP_REASON_SUBSYS_MAC80211_UNUSABLE,
1588 				     &drop_reason_list_unusable);
1589 
1590 	return 0;
1591  err_netdev:
1592 	rc80211_minstrel_exit();
1593 
1594 	return ret;
1595 }
1596 
ieee80211_exit(void)1597 static void __exit ieee80211_exit(void)
1598 {
1599 	rc80211_minstrel_exit();
1600 
1601 	ieee80211s_stop();
1602 
1603 	ieee80211_iface_exit();
1604 
1605 	drop_reasons_unregister_subsys(SKB_DROP_REASON_SUBSYS_MAC80211_MONITOR);
1606 	drop_reasons_unregister_subsys(SKB_DROP_REASON_SUBSYS_MAC80211_UNUSABLE);
1607 
1608 	rcu_barrier();
1609 }
1610 
1611 
1612 subsys_initcall(ieee80211_init);
1613 module_exit(ieee80211_exit);
1614 
1615 MODULE_DESCRIPTION("IEEE 802.11 subsystem");
1616 MODULE_LICENSE("GPL");
1617