2 * This is the linux wireless configuration interface.
4 * Copyright 2006-2009 Johannes Berg <johannes@sipsolutions.net>
8 #include <linux/module.h>
10 #include <linux/list.h>
11 #include <linux/nl80211.h>
12 #include <linux/debugfs.h>
13 #include <linux/notifier.h>
14 #include <linux/device.h>
15 #include <linux/rtnetlink.h>
16 #include <net/genetlink.h>
17 #include <net/cfg80211.h>
22 #include "wext-compat.h"
24 /* name for sysfs, %d is appended */
25 #define PHY_NAME "phy"
27 MODULE_AUTHOR("Johannes Berg");
28 MODULE_LICENSE("GPL");
29 MODULE_DESCRIPTION("wireless configuration support");
31 /* RCU might be appropriate here since we usually
32 * only read the list, and that can happen quite
33 * often because we need to do it for each command */
34 LIST_HEAD(cfg80211_rdev_list);
37 * This is used to protect the cfg80211_rdev_list, cfg80211_regdomain,
38 * country_ie_regdomain, the reg_beacon_list and the the last regulatory
39 * request receipt (last_request).
41 DEFINE_MUTEX(cfg80211_mutex);
44 static struct dentry *ieee80211_debugfs_dir;
46 /* requires cfg80211_mutex to be held! */
47 struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx)
49 struct cfg80211_registered_device *result = NULL, *rdev;
51 if (!wiphy_idx_valid(wiphy_idx))
54 assert_cfg80211_lock();
56 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
57 if (rdev->wiphy_idx == wiphy_idx) {
66 int get_wiphy_idx(struct wiphy *wiphy)
68 struct cfg80211_registered_device *rdev;
70 return WIPHY_IDX_STALE;
71 rdev = wiphy_to_dev(wiphy);
72 return rdev->wiphy_idx;
75 /* requires cfg80211_rdev_mutex to be held! */
76 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx)
78 struct cfg80211_registered_device *rdev;
80 if (!wiphy_idx_valid(wiphy_idx))
83 assert_cfg80211_lock();
85 rdev = cfg80211_rdev_by_wiphy_idx(wiphy_idx);
91 /* requires cfg80211_mutex to be held! */
92 struct cfg80211_registered_device *
93 __cfg80211_rdev_from_info(struct genl_info *info)
96 struct cfg80211_registered_device *bywiphyidx = NULL, *byifidx = NULL;
97 struct net_device *dev;
100 assert_cfg80211_lock();
102 if (info->attrs[NL80211_ATTR_WIPHY]) {
103 bywiphyidx = cfg80211_rdev_by_wiphy_idx(
104 nla_get_u32(info->attrs[NL80211_ATTR_WIPHY]));
108 if (info->attrs[NL80211_ATTR_IFINDEX]) {
109 ifindex = nla_get_u32(info->attrs[NL80211_ATTR_IFINDEX]);
110 dev = dev_get_by_index(genl_info_net(info), ifindex);
112 if (dev->ieee80211_ptr)
114 wiphy_to_dev(dev->ieee80211_ptr->wiphy);
120 if (bywiphyidx && byifidx) {
121 if (bywiphyidx != byifidx)
122 return ERR_PTR(-EINVAL);
124 return bywiphyidx; /* == byifidx */
135 struct cfg80211_registered_device *
136 cfg80211_get_dev_from_info(struct genl_info *info)
138 struct cfg80211_registered_device *rdev;
140 mutex_lock(&cfg80211_mutex);
141 rdev = __cfg80211_rdev_from_info(info);
143 /* if it is not an error we grab the lock on
144 * it to assure it won't be going away while
145 * we operate on it */
147 mutex_lock(&rdev->mtx);
149 mutex_unlock(&cfg80211_mutex);
154 struct cfg80211_registered_device *
155 cfg80211_get_dev_from_ifindex(struct net *net, int ifindex)
157 struct cfg80211_registered_device *rdev = ERR_PTR(-ENODEV);
158 struct net_device *dev;
160 mutex_lock(&cfg80211_mutex);
161 dev = dev_get_by_index(net, ifindex);
164 if (dev->ieee80211_ptr) {
165 rdev = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
166 mutex_lock(&rdev->mtx);
168 rdev = ERR_PTR(-ENODEV);
171 mutex_unlock(&cfg80211_mutex);
175 /* requires cfg80211_mutex to be held */
176 int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
179 struct cfg80211_registered_device *rdev2;
180 int wiphy_idx, taken = -1, result, digits;
182 assert_cfg80211_lock();
184 /* prohibit calling the thing phy%d when %d is not its number */
185 sscanf(newname, PHY_NAME "%d%n", &wiphy_idx, &taken);
186 if (taken == strlen(newname) && wiphy_idx != rdev->wiphy_idx) {
187 /* count number of places needed to print wiphy_idx */
189 while (wiphy_idx /= 10)
192 * deny the name if it is phy<idx> where <idx> is printed
193 * without leading zeroes. taken == strlen(newname) here
195 if (taken == strlen(PHY_NAME) + digits)
200 /* Ignore nop renames */
201 if (strcmp(newname, dev_name(&rdev->wiphy.dev)) == 0)
204 /* Ensure another device does not already have this name. */
205 list_for_each_entry(rdev2, &cfg80211_rdev_list, list)
206 if (strcmp(newname, dev_name(&rdev2->wiphy.dev)) == 0)
209 result = device_rename(&rdev->wiphy.dev, newname);
213 if (rdev->wiphy.debugfsdir &&
214 !debugfs_rename(rdev->wiphy.debugfsdir->d_parent,
215 rdev->wiphy.debugfsdir,
216 rdev->wiphy.debugfsdir->d_parent,
218 printk(KERN_ERR "cfg80211: failed to rename debugfs dir to %s!\n",
221 nl80211_notify_dev_rename(rdev);
226 int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
229 struct wireless_dev *wdev;
232 if (!rdev->wiphy.netnsok)
235 list_for_each_entry(wdev, &rdev->netdev_list, list) {
236 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
237 err = dev_change_net_namespace(wdev->netdev, net, "wlan%d");
240 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
244 /* failed -- clean up to old netns */
245 net = wiphy_net(&rdev->wiphy);
247 list_for_each_entry_continue_reverse(wdev, &rdev->netdev_list,
249 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
250 err = dev_change_net_namespace(wdev->netdev, net,
253 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
257 wiphy_net_set(&rdev->wiphy, net);
262 static void cfg80211_rfkill_poll(struct rfkill *rfkill, void *data)
264 struct cfg80211_registered_device *rdev = data;
266 rdev->ops->rfkill_poll(&rdev->wiphy);
269 static int cfg80211_rfkill_set_block(void *data, bool blocked)
271 struct cfg80211_registered_device *rdev = data;
272 struct wireless_dev *wdev;
278 mutex_lock(&rdev->devlist_mtx);
280 list_for_each_entry(wdev, &rdev->netdev_list, list)
281 dev_close(wdev->netdev);
283 mutex_unlock(&rdev->devlist_mtx);
289 static void cfg80211_rfkill_sync_work(struct work_struct *work)
291 struct cfg80211_registered_device *rdev;
293 rdev = container_of(work, struct cfg80211_registered_device, rfkill_sync);
294 cfg80211_rfkill_set_block(rdev, rfkill_blocked(rdev->rfkill));
297 static void cfg80211_process_events(struct wireless_dev *wdev)
299 struct cfg80211_event *ev;
302 spin_lock_irqsave(&wdev->event_lock, flags);
303 while (!list_empty(&wdev->event_list)) {
304 ev = list_first_entry(&wdev->event_list,
305 struct cfg80211_event, list);
307 spin_unlock_irqrestore(&wdev->event_lock, flags);
311 case EVENT_CONNECT_RESULT:
312 __cfg80211_connect_result(
313 wdev->netdev, ev->cr.bssid,
314 ev->cr.req_ie, ev->cr.req_ie_len,
315 ev->cr.resp_ie, ev->cr.resp_ie_len,
317 ev->cr.status == WLAN_STATUS_SUCCESS);
320 __cfg80211_roamed(wdev, ev->rm.bssid,
321 ev->rm.req_ie, ev->rm.req_ie_len,
322 ev->rm.resp_ie, ev->rm.resp_ie_len);
324 case EVENT_DISCONNECTED:
325 __cfg80211_disconnected(wdev->netdev,
326 ev->dc.ie, ev->dc.ie_len,
327 ev->dc.reason, true);
329 case EVENT_IBSS_JOINED:
330 __cfg80211_ibss_joined(wdev->netdev, ev->ij.bssid);
337 spin_lock_irqsave(&wdev->event_lock, flags);
339 spin_unlock_irqrestore(&wdev->event_lock, flags);
342 static void cfg80211_event_work(struct work_struct *work)
344 struct cfg80211_registered_device *rdev;
345 struct wireless_dev *wdev;
347 rdev = container_of(work, struct cfg80211_registered_device,
351 cfg80211_lock_rdev(rdev);
352 mutex_lock(&rdev->devlist_mtx);
354 list_for_each_entry(wdev, &rdev->netdev_list, list)
355 cfg80211_process_events(wdev);
357 mutex_unlock(&rdev->devlist_mtx);
358 cfg80211_unlock_rdev(rdev);
362 /* exported functions */
364 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
366 static int wiphy_counter;
368 struct cfg80211_registered_device *rdev;
371 WARN_ON(ops->add_key && (!ops->del_key || !ops->set_default_key));
372 WARN_ON(ops->auth && (!ops->assoc || !ops->deauth || !ops->disassoc));
373 WARN_ON(ops->connect && !ops->disconnect);
374 WARN_ON(ops->join_ibss && !ops->leave_ibss);
375 WARN_ON(ops->add_virtual_intf && !ops->del_virtual_intf);
376 WARN_ON(ops->add_station && !ops->del_station);
377 WARN_ON(ops->add_mpath && !ops->del_mpath);
379 alloc_size = sizeof(*rdev) + sizeof_priv;
381 rdev = kzalloc(alloc_size, GFP_KERNEL);
387 mutex_lock(&cfg80211_mutex);
389 rdev->wiphy_idx = wiphy_counter++;
391 if (unlikely(!wiphy_idx_valid(rdev->wiphy_idx))) {
393 mutex_unlock(&cfg80211_mutex);
399 mutex_unlock(&cfg80211_mutex);
401 /* give it a proper name */
402 dev_set_name(&rdev->wiphy.dev, PHY_NAME "%d", rdev->wiphy_idx);
404 mutex_init(&rdev->mtx);
405 mutex_init(&rdev->devlist_mtx);
406 INIT_LIST_HEAD(&rdev->netdev_list);
407 spin_lock_init(&rdev->bss_lock);
408 INIT_LIST_HEAD(&rdev->bss_list);
409 INIT_WORK(&rdev->scan_done_wk, __cfg80211_scan_done);
411 device_initialize(&rdev->wiphy.dev);
412 rdev->wiphy.dev.class = &ieee80211_class;
413 rdev->wiphy.dev.platform_data = rdev;
415 wiphy_net_set(&rdev->wiphy, &init_net);
417 rdev->rfkill_ops.set_block = cfg80211_rfkill_set_block;
418 rdev->rfkill = rfkill_alloc(dev_name(&rdev->wiphy.dev),
419 &rdev->wiphy.dev, RFKILL_TYPE_WLAN,
420 &rdev->rfkill_ops, rdev);
427 INIT_WORK(&rdev->rfkill_sync, cfg80211_rfkill_sync_work);
428 INIT_WORK(&rdev->conn_work, cfg80211_conn_work);
429 INIT_WORK(&rdev->event_work, cfg80211_event_work);
432 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
433 * Fragmentation and RTS threshold are disabled by default with the
436 rdev->wiphy.retry_short = 7;
437 rdev->wiphy.retry_long = 4;
438 rdev->wiphy.frag_threshold = (u32) -1;
439 rdev->wiphy.rts_threshold = (u32) -1;
443 EXPORT_SYMBOL(wiphy_new);
445 int wiphy_register(struct wiphy *wiphy)
447 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
449 enum ieee80211_band band;
450 struct ieee80211_supported_band *sband;
451 bool have_band = false;
453 u16 ifmodes = wiphy->interface_modes;
455 /* sanity check ifmodes */
457 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
458 if (WARN_ON(ifmodes != wiphy->interface_modes))
459 wiphy->interface_modes = ifmodes;
461 /* sanity check supported bands/channels */
462 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
463 sband = wiphy->bands[band];
469 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
473 * Since we use a u32 for rate bitmaps in
474 * ieee80211_get_response_rate, we cannot
475 * have more than 32 legacy rates.
477 if (WARN_ON(sband->n_bitrates > 32))
480 for (i = 0; i < sband->n_channels; i++) {
481 sband->channels[i].orig_flags =
482 sband->channels[i].flags;
483 sband->channels[i].orig_mag =
484 sband->channels[i].max_antenna_gain;
485 sband->channels[i].orig_mpwr =
486 sband->channels[i].max_power;
487 sband->channels[i].band = band;
498 /* check and set up bitrates */
499 ieee80211_set_bitrate_flags(wiphy);
501 res = device_add(&rdev->wiphy.dev);
505 res = rfkill_register(rdev->rfkill);
509 mutex_lock(&cfg80211_mutex);
511 /* set up regulatory info */
512 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
514 list_add(&rdev->list, &cfg80211_rdev_list);
516 mutex_unlock(&cfg80211_mutex);
519 rdev->wiphy.debugfsdir =
520 debugfs_create_dir(wiphy_name(&rdev->wiphy),
521 ieee80211_debugfs_dir);
522 if (IS_ERR(rdev->wiphy.debugfsdir))
523 rdev->wiphy.debugfsdir = NULL;
525 if (wiphy->custom_regulatory) {
526 struct regulatory_request request;
528 request.wiphy_idx = get_wiphy_idx(wiphy);
529 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
530 request.alpha2[0] = '9';
531 request.alpha2[1] = '9';
533 nl80211_send_reg_change_event(&request);
536 cfg80211_debugfs_rdev_add(rdev);
541 device_del(&rdev->wiphy.dev);
544 EXPORT_SYMBOL(wiphy_register);
546 void wiphy_rfkill_start_polling(struct wiphy *wiphy)
548 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
550 if (!rdev->ops->rfkill_poll)
552 rdev->rfkill_ops.poll = cfg80211_rfkill_poll;
553 rfkill_resume_polling(rdev->rfkill);
555 EXPORT_SYMBOL(wiphy_rfkill_start_polling);
557 void wiphy_rfkill_stop_polling(struct wiphy *wiphy)
559 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
561 rfkill_pause_polling(rdev->rfkill);
563 EXPORT_SYMBOL(wiphy_rfkill_stop_polling);
565 void wiphy_unregister(struct wiphy *wiphy)
567 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
569 rfkill_unregister(rdev->rfkill);
571 /* protect the device list */
572 mutex_lock(&cfg80211_mutex);
574 BUG_ON(!list_empty(&rdev->netdev_list));
577 * Try to grab rdev->mtx. If a command is still in progress,
578 * hopefully the driver will refuse it since it's tearing
579 * down the device already. We wait for this command to complete
580 * before unlinking the item from the list.
581 * Note: as codified by the BUG_ON above we cannot get here if
582 * a virtual interface is still associated. Hence, we can only
583 * get to lock contention here if userspace issues a command
584 * that identified the hardware by wiphy index.
586 mutex_lock(&rdev->mtx);
587 /* unlock again before freeing */
588 mutex_unlock(&rdev->mtx);
590 cfg80211_debugfs_rdev_del(rdev);
592 /* If this device got a regulatory hint tell core its
593 * free to listen now to a new shiny device regulatory hint */
594 reg_device_remove(wiphy);
596 list_del(&rdev->list);
597 device_del(&rdev->wiphy.dev);
598 debugfs_remove(rdev->wiphy.debugfsdir);
600 mutex_unlock(&cfg80211_mutex);
602 cancel_work_sync(&rdev->conn_work);
603 cancel_work_sync(&rdev->scan_done_wk);
604 kfree(rdev->scan_req);
605 flush_work(&rdev->event_work);
607 EXPORT_SYMBOL(wiphy_unregister);
609 void cfg80211_dev_free(struct cfg80211_registered_device *rdev)
611 struct cfg80211_internal_bss *scan, *tmp;
612 rfkill_destroy(rdev->rfkill);
613 mutex_destroy(&rdev->mtx);
614 mutex_destroy(&rdev->devlist_mtx);
615 list_for_each_entry_safe(scan, tmp, &rdev->bss_list, list)
616 cfg80211_put_bss(&scan->pub);
620 void wiphy_free(struct wiphy *wiphy)
622 put_device(&wiphy->dev);
624 EXPORT_SYMBOL(wiphy_free);
626 void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked)
628 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
630 if (rfkill_set_hw_state(rdev->rfkill, blocked))
631 schedule_work(&rdev->rfkill_sync);
633 EXPORT_SYMBOL(wiphy_rfkill_set_hw_state);
635 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
639 struct net_device *dev = ndev;
640 struct wireless_dev *wdev = dev->ieee80211_ptr;
641 struct cfg80211_registered_device *rdev;
646 rdev = wiphy_to_dev(wdev->wiphy);
648 WARN_ON(wdev->iftype == NL80211_IFTYPE_UNSPECIFIED);
651 case NETDEV_REGISTER:
652 mutex_init(&wdev->mtx);
653 INIT_LIST_HEAD(&wdev->event_list);
654 spin_lock_init(&wdev->event_lock);
655 mutex_lock(&rdev->devlist_mtx);
656 list_add(&wdev->list, &rdev->netdev_list);
657 /* can only change netns with wiphy */
658 dev->features |= NETIF_F_NETNS_LOCAL;
660 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
662 printk(KERN_ERR "wireless: failed to add phy80211 "
663 "symlink to netdev!\n");
666 wdev->sme_state = CFG80211_SME_IDLE;
667 mutex_unlock(&rdev->devlist_mtx);
668 #ifdef CONFIG_WIRELESS_EXT
669 if (!dev->wireless_handlers)
670 dev->wireless_handlers = &cfg80211_wext_handler;
671 wdev->wext.default_key = -1;
672 wdev->wext.default_mgmt_key = -1;
673 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
674 wdev->wext.ps = CONFIG_CFG80211_DEFAULT_PS_VALUE;
675 wdev->wext.ps_timeout = 500;
676 if (rdev->ops->set_power_mgmt)
677 if (rdev->ops->set_power_mgmt(wdev->wiphy, dev,
679 wdev->wext.ps_timeout)) {
680 /* assume this means it's off */
681 wdev->wext.ps = false;
685 case NETDEV_GOING_DOWN:
686 switch (wdev->iftype) {
687 case NL80211_IFTYPE_ADHOC:
688 cfg80211_leave_ibss(rdev, dev, true);
690 case NL80211_IFTYPE_STATION:
692 #ifdef CONFIG_WIRELESS_EXT
693 kfree(wdev->wext.ie);
694 wdev->wext.ie = NULL;
695 wdev->wext.ie_len = 0;
696 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
698 __cfg80211_disconnect(rdev, dev,
699 WLAN_REASON_DEAUTH_LEAVING, true);
700 cfg80211_mlme_down(rdev, dev);
708 #ifdef CONFIG_WIRELESS_EXT
709 cfg80211_lock_rdev(rdev);
711 switch (wdev->iftype) {
712 case NL80211_IFTYPE_ADHOC:
713 cfg80211_ibss_wext_join(rdev, wdev);
715 case NL80211_IFTYPE_STATION:
716 cfg80211_mgd_wext_connect(rdev, wdev);
722 cfg80211_unlock_rdev(rdev);
725 case NETDEV_UNREGISTER:
726 mutex_lock(&rdev->devlist_mtx);
727 if (!list_empty(&wdev->list)) {
728 sysfs_remove_link(&dev->dev.kobj, "phy80211");
729 list_del_init(&wdev->list);
731 mutex_unlock(&rdev->devlist_mtx);
732 mutex_destroy(&wdev->mtx);
733 #ifdef CONFIG_WIRELESS_EXT
734 kfree(wdev->wext.keys);
738 if (!(wdev->wiphy->interface_modes & BIT(wdev->iftype)))
739 return notifier_from_errno(-EOPNOTSUPP);
740 if (rfkill_blocked(rdev->rfkill))
741 return notifier_from_errno(-ERFKILL);
748 static struct notifier_block cfg80211_netdev_notifier = {
749 .notifier_call = cfg80211_netdev_notifier_call,
752 static void __net_exit cfg80211_pernet_exit(struct net *net)
754 struct cfg80211_registered_device *rdev;
757 mutex_lock(&cfg80211_mutex);
758 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
759 if (net_eq(wiphy_net(&rdev->wiphy), net))
760 WARN_ON(cfg80211_switch_netns(rdev, &init_net));
762 mutex_unlock(&cfg80211_mutex);
766 static struct pernet_operations cfg80211_pernet_ops = {
767 .exit = cfg80211_pernet_exit,
770 static int __init cfg80211_init(void)
774 err = register_pernet_device(&cfg80211_pernet_ops);
776 goto out_fail_pernet;
778 err = wiphy_sysfs_init();
782 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
784 goto out_fail_notifier;
786 err = nl80211_init();
788 goto out_fail_nl80211;
790 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
792 err = regulatory_init();
799 debugfs_remove(ieee80211_debugfs_dir);
801 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
805 unregister_pernet_device(&cfg80211_pernet_ops);
809 subsys_initcall(cfg80211_init);
811 static void cfg80211_exit(void)
813 debugfs_remove(ieee80211_debugfs_dir);
815 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
818 unregister_pernet_device(&cfg80211_pernet_ops);
820 module_exit(cfg80211_exit);