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
39 DEFINE_MUTEX(cfg80211_mutex);
42 static struct dentry *ieee80211_debugfs_dir;
44 /* requires cfg80211_mutex to be held! */
45 struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx)
47 struct cfg80211_registered_device *result = NULL, *rdev;
49 if (!wiphy_idx_valid(wiphy_idx))
52 assert_cfg80211_lock();
54 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
55 if (rdev->wiphy_idx == wiphy_idx) {
64 int get_wiphy_idx(struct wiphy *wiphy)
66 struct cfg80211_registered_device *rdev;
68 return WIPHY_IDX_STALE;
69 rdev = wiphy_to_dev(wiphy);
70 return rdev->wiphy_idx;
73 /* requires cfg80211_rdev_mutex to be held! */
74 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx)
76 struct cfg80211_registered_device *rdev;
78 if (!wiphy_idx_valid(wiphy_idx))
81 assert_cfg80211_lock();
83 rdev = cfg80211_rdev_by_wiphy_idx(wiphy_idx);
89 /* requires cfg80211_mutex to be held! */
90 struct cfg80211_registered_device *
91 __cfg80211_rdev_from_info(struct genl_info *info)
94 struct cfg80211_registered_device *bywiphyidx = NULL, *byifidx = NULL;
95 struct net_device *dev;
98 assert_cfg80211_lock();
100 if (info->attrs[NL80211_ATTR_WIPHY]) {
101 bywiphyidx = cfg80211_rdev_by_wiphy_idx(
102 nla_get_u32(info->attrs[NL80211_ATTR_WIPHY]));
106 if (info->attrs[NL80211_ATTR_IFINDEX]) {
107 ifindex = nla_get_u32(info->attrs[NL80211_ATTR_IFINDEX]);
108 dev = dev_get_by_index(genl_info_net(info), ifindex);
110 if (dev->ieee80211_ptr)
112 wiphy_to_dev(dev->ieee80211_ptr->wiphy);
118 if (bywiphyidx && byifidx) {
119 if (bywiphyidx != byifidx)
120 return ERR_PTR(-EINVAL);
122 return bywiphyidx; /* == byifidx */
133 struct cfg80211_registered_device *
134 cfg80211_get_dev_from_info(struct genl_info *info)
136 struct cfg80211_registered_device *rdev;
138 mutex_lock(&cfg80211_mutex);
139 rdev = __cfg80211_rdev_from_info(info);
141 /* if it is not an error we grab the lock on
142 * it to assure it won't be going away while
143 * we operate on it */
145 mutex_lock(&rdev->mtx);
147 mutex_unlock(&cfg80211_mutex);
152 struct cfg80211_registered_device *
153 cfg80211_get_dev_from_ifindex(struct net *net, int ifindex)
155 struct cfg80211_registered_device *rdev = ERR_PTR(-ENODEV);
156 struct net_device *dev;
158 mutex_lock(&cfg80211_mutex);
159 dev = dev_get_by_index(net, ifindex);
162 if (dev->ieee80211_ptr) {
163 rdev = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
164 mutex_lock(&rdev->mtx);
166 rdev = ERR_PTR(-ENODEV);
169 mutex_unlock(&cfg80211_mutex);
173 /* requires cfg80211_mutex to be held */
174 int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
177 struct cfg80211_registered_device *rdev2;
178 int wiphy_idx, taken = -1, result, digits;
180 assert_cfg80211_lock();
182 /* prohibit calling the thing phy%d when %d is not its number */
183 sscanf(newname, PHY_NAME "%d%n", &wiphy_idx, &taken);
184 if (taken == strlen(newname) && wiphy_idx != rdev->wiphy_idx) {
185 /* count number of places needed to print wiphy_idx */
187 while (wiphy_idx /= 10)
190 * deny the name if it is phy<idx> where <idx> is printed
191 * without leading zeroes. taken == strlen(newname) here
193 if (taken == strlen(PHY_NAME) + digits)
198 /* Ignore nop renames */
199 if (strcmp(newname, dev_name(&rdev->wiphy.dev)) == 0)
202 /* Ensure another device does not already have this name. */
203 list_for_each_entry(rdev2, &cfg80211_rdev_list, list)
204 if (strcmp(newname, dev_name(&rdev2->wiphy.dev)) == 0)
207 result = device_rename(&rdev->wiphy.dev, newname);
211 if (rdev->wiphy.debugfsdir &&
212 !debugfs_rename(rdev->wiphy.debugfsdir->d_parent,
213 rdev->wiphy.debugfsdir,
214 rdev->wiphy.debugfsdir->d_parent,
216 printk(KERN_ERR "cfg80211: failed to rename debugfs dir to %s!\n",
219 nl80211_notify_dev_rename(rdev);
224 int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
227 struct wireless_dev *wdev;
230 if (!rdev->wiphy.netnsok)
233 list_for_each_entry(wdev, &rdev->netdev_list, list) {
234 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
235 err = dev_change_net_namespace(wdev->netdev, net, "wlan%d");
238 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
242 /* failed -- clean up to old netns */
243 net = wiphy_net(&rdev->wiphy);
245 list_for_each_entry_continue_reverse(wdev, &rdev->netdev_list,
247 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
248 err = dev_change_net_namespace(wdev->netdev, net,
251 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
255 wiphy_net_set(&rdev->wiphy, net);
260 static void cfg80211_rfkill_poll(struct rfkill *rfkill, void *data)
262 struct cfg80211_registered_device *rdev = data;
264 rdev->ops->rfkill_poll(&rdev->wiphy);
267 static int cfg80211_rfkill_set_block(void *data, bool blocked)
269 struct cfg80211_registered_device *rdev = data;
270 struct wireless_dev *wdev;
276 mutex_lock(&rdev->devlist_mtx);
278 list_for_each_entry(wdev, &rdev->netdev_list, list)
279 dev_close(wdev->netdev);
281 mutex_unlock(&rdev->devlist_mtx);
287 static void cfg80211_rfkill_sync_work(struct work_struct *work)
289 struct cfg80211_registered_device *rdev;
291 rdev = container_of(work, struct cfg80211_registered_device, rfkill_sync);
292 cfg80211_rfkill_set_block(rdev, rfkill_blocked(rdev->rfkill));
295 static void cfg80211_process_events(struct wireless_dev *wdev)
297 struct cfg80211_event *ev;
300 spin_lock_irqsave(&wdev->event_lock, flags);
301 while (!list_empty(&wdev->event_list)) {
302 ev = list_first_entry(&wdev->event_list,
303 struct cfg80211_event, list);
305 spin_unlock_irqrestore(&wdev->event_lock, flags);
309 case EVENT_CONNECT_RESULT:
310 __cfg80211_connect_result(
311 wdev->netdev, ev->cr.bssid,
312 ev->cr.req_ie, ev->cr.req_ie_len,
313 ev->cr.resp_ie, ev->cr.resp_ie_len,
315 ev->cr.status == WLAN_STATUS_SUCCESS,
319 __cfg80211_roamed(wdev, ev->rm.bssid,
320 ev->rm.req_ie, ev->rm.req_ie_len,
321 ev->rm.resp_ie, ev->rm.resp_ie_len);
323 case EVENT_DISCONNECTED:
324 __cfg80211_disconnected(wdev->netdev,
325 ev->dc.ie, ev->dc.ie_len,
326 ev->dc.reason, true);
328 case EVENT_IBSS_JOINED:
329 __cfg80211_ibss_joined(wdev->netdev, ev->ij.bssid);
336 spin_lock_irqsave(&wdev->event_lock, flags);
338 spin_unlock_irqrestore(&wdev->event_lock, flags);
341 static void cfg80211_event_work(struct work_struct *work)
343 struct cfg80211_registered_device *rdev;
344 struct wireless_dev *wdev;
346 rdev = container_of(work, struct cfg80211_registered_device,
350 cfg80211_lock_rdev(rdev);
351 mutex_lock(&rdev->devlist_mtx);
353 list_for_each_entry(wdev, &rdev->netdev_list, list)
354 cfg80211_process_events(wdev);
356 mutex_unlock(&rdev->devlist_mtx);
357 cfg80211_unlock_rdev(rdev);
361 /* exported functions */
363 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
365 static int wiphy_counter;
367 struct cfg80211_registered_device *rdev;
370 WARN_ON(ops->add_key && (!ops->del_key || !ops->set_default_key));
371 WARN_ON(ops->auth && (!ops->assoc || !ops->deauth || !ops->disassoc));
372 WARN_ON(ops->connect && !ops->disconnect);
373 WARN_ON(ops->join_ibss && !ops->leave_ibss);
374 WARN_ON(ops->add_virtual_intf && !ops->del_virtual_intf);
375 WARN_ON(ops->add_station && !ops->del_station);
376 WARN_ON(ops->add_mpath && !ops->del_mpath);
378 alloc_size = sizeof(*rdev) + sizeof_priv;
380 rdev = kzalloc(alloc_size, GFP_KERNEL);
386 mutex_lock(&cfg80211_mutex);
388 rdev->wiphy_idx = wiphy_counter++;
390 if (unlikely(!wiphy_idx_valid(rdev->wiphy_idx))) {
392 mutex_unlock(&cfg80211_mutex);
398 mutex_unlock(&cfg80211_mutex);
400 /* give it a proper name */
401 dev_set_name(&rdev->wiphy.dev, PHY_NAME "%d", rdev->wiphy_idx);
403 mutex_init(&rdev->mtx);
404 mutex_init(&rdev->devlist_mtx);
405 INIT_LIST_HEAD(&rdev->netdev_list);
406 spin_lock_init(&rdev->bss_lock);
407 INIT_LIST_HEAD(&rdev->bss_list);
408 INIT_WORK(&rdev->scan_done_wk, __cfg80211_scan_done);
410 device_initialize(&rdev->wiphy.dev);
411 rdev->wiphy.dev.class = &ieee80211_class;
412 rdev->wiphy.dev.platform_data = rdev;
414 wiphy_net_set(&rdev->wiphy, &init_net);
416 rdev->rfkill_ops.set_block = cfg80211_rfkill_set_block;
417 rdev->rfkill = rfkill_alloc(dev_name(&rdev->wiphy.dev),
418 &rdev->wiphy.dev, RFKILL_TYPE_WLAN,
419 &rdev->rfkill_ops, rdev);
426 INIT_WORK(&rdev->rfkill_sync, cfg80211_rfkill_sync_work);
427 INIT_WORK(&rdev->conn_work, cfg80211_conn_work);
428 INIT_WORK(&rdev->event_work, cfg80211_event_work);
431 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
432 * Fragmentation and RTS threshold are disabled by default with the
435 rdev->wiphy.retry_short = 7;
436 rdev->wiphy.retry_long = 4;
437 rdev->wiphy.frag_threshold = (u32) -1;
438 rdev->wiphy.rts_threshold = (u32) -1;
442 EXPORT_SYMBOL(wiphy_new);
444 int wiphy_register(struct wiphy *wiphy)
446 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
448 enum ieee80211_band band;
449 struct ieee80211_supported_band *sband;
450 bool have_band = false;
452 u16 ifmodes = wiphy->interface_modes;
454 /* sanity check ifmodes */
456 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
457 if (WARN_ON(ifmodes != wiphy->interface_modes))
458 wiphy->interface_modes = ifmodes;
460 /* sanity check supported bands/channels */
461 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
462 sband = wiphy->bands[band];
468 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
472 * Since we use a u32 for rate bitmaps in
473 * ieee80211_get_response_rate, we cannot
474 * have more than 32 legacy rates.
476 if (WARN_ON(sband->n_bitrates > 32))
479 for (i = 0; i < sband->n_channels; i++) {
480 sband->channels[i].orig_flags =
481 sband->channels[i].flags;
482 sband->channels[i].orig_mag =
483 sband->channels[i].max_antenna_gain;
484 sband->channels[i].orig_mpwr =
485 sband->channels[i].max_power;
486 sband->channels[i].band = band;
497 /* check and set up bitrates */
498 ieee80211_set_bitrate_flags(wiphy);
500 res = device_add(&rdev->wiphy.dev);
504 res = rfkill_register(rdev->rfkill);
508 mutex_lock(&cfg80211_mutex);
510 /* set up regulatory info */
511 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
513 list_add(&rdev->list, &cfg80211_rdev_list);
515 mutex_unlock(&cfg80211_mutex);
518 rdev->wiphy.debugfsdir =
519 debugfs_create_dir(wiphy_name(&rdev->wiphy),
520 ieee80211_debugfs_dir);
521 if (IS_ERR(rdev->wiphy.debugfsdir))
522 rdev->wiphy.debugfsdir = NULL;
524 if (wiphy->custom_regulatory) {
525 struct regulatory_request request;
527 request.wiphy_idx = get_wiphy_idx(wiphy);
528 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
529 request.alpha2[0] = '9';
530 request.alpha2[1] = '9';
532 nl80211_send_reg_change_event(&request);
535 cfg80211_debugfs_rdev_add(rdev);
540 device_del(&rdev->wiphy.dev);
543 EXPORT_SYMBOL(wiphy_register);
545 void wiphy_rfkill_start_polling(struct wiphy *wiphy)
547 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
549 if (!rdev->ops->rfkill_poll)
551 rdev->rfkill_ops.poll = cfg80211_rfkill_poll;
552 rfkill_resume_polling(rdev->rfkill);
554 EXPORT_SYMBOL(wiphy_rfkill_start_polling);
556 void wiphy_rfkill_stop_polling(struct wiphy *wiphy)
558 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
560 rfkill_pause_polling(rdev->rfkill);
562 EXPORT_SYMBOL(wiphy_rfkill_stop_polling);
564 void wiphy_unregister(struct wiphy *wiphy)
566 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
568 rfkill_unregister(rdev->rfkill);
570 /* protect the device list */
571 mutex_lock(&cfg80211_mutex);
573 BUG_ON(!list_empty(&rdev->netdev_list));
576 * Try to grab rdev->mtx. If a command is still in progress,
577 * hopefully the driver will refuse it since it's tearing
578 * down the device already. We wait for this command to complete
579 * before unlinking the item from the list.
580 * Note: as codified by the BUG_ON above we cannot get here if
581 * a virtual interface is still associated. Hence, we can only
582 * get to lock contention here if userspace issues a command
583 * that identified the hardware by wiphy index.
585 mutex_lock(&rdev->mtx);
586 /* unlock again before freeing */
587 mutex_unlock(&rdev->mtx);
589 cfg80211_debugfs_rdev_del(rdev);
591 /* If this device got a regulatory hint tell core its
592 * free to listen now to a new shiny device regulatory hint */
593 reg_device_remove(wiphy);
595 list_del(&rdev->list);
596 device_del(&rdev->wiphy.dev);
597 debugfs_remove(rdev->wiphy.debugfsdir);
599 mutex_unlock(&cfg80211_mutex);
601 cancel_work_sync(&rdev->conn_work);
602 cancel_work_sync(&rdev->scan_done_wk);
603 kfree(rdev->scan_req);
604 flush_work(&rdev->event_work);
606 EXPORT_SYMBOL(wiphy_unregister);
608 void cfg80211_dev_free(struct cfg80211_registered_device *rdev)
610 struct cfg80211_internal_bss *scan, *tmp;
611 rfkill_destroy(rdev->rfkill);
612 mutex_destroy(&rdev->mtx);
613 mutex_destroy(&rdev->devlist_mtx);
614 list_for_each_entry_safe(scan, tmp, &rdev->bss_list, list)
615 cfg80211_put_bss(&scan->pub);
619 void wiphy_free(struct wiphy *wiphy)
621 put_device(&wiphy->dev);
623 EXPORT_SYMBOL(wiphy_free);
625 void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked)
627 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
629 if (rfkill_set_hw_state(rdev->rfkill, blocked))
630 schedule_work(&rdev->rfkill_sync);
632 EXPORT_SYMBOL(wiphy_rfkill_set_hw_state);
634 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
638 struct net_device *dev = ndev;
639 struct wireless_dev *wdev = dev->ieee80211_ptr;
640 struct cfg80211_registered_device *rdev;
645 rdev = wiphy_to_dev(wdev->wiphy);
647 WARN_ON(wdev->iftype == NL80211_IFTYPE_UNSPECIFIED);
650 case NETDEV_REGISTER:
651 mutex_init(&wdev->mtx);
652 INIT_LIST_HEAD(&wdev->event_list);
653 spin_lock_init(&wdev->event_lock);
654 mutex_lock(&rdev->devlist_mtx);
655 list_add(&wdev->list, &rdev->netdev_list);
656 /* can only change netns with wiphy */
657 dev->features |= NETIF_F_NETNS_LOCAL;
659 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
661 printk(KERN_ERR "wireless: failed to add phy80211 "
662 "symlink to netdev!\n");
665 wdev->sme_state = CFG80211_SME_IDLE;
666 mutex_unlock(&rdev->devlist_mtx);
667 #ifdef CONFIG_WIRELESS_EXT
668 if (!dev->wireless_handlers)
669 dev->wireless_handlers = &cfg80211_wext_handler;
670 wdev->wext.default_key = -1;
671 wdev->wext.default_mgmt_key = -1;
672 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
673 wdev->wext.ps = CONFIG_CFG80211_DEFAULT_PS_VALUE;
674 wdev->wext.ps_timeout = 100;
675 if (rdev->ops->set_power_mgmt)
676 if (rdev->ops->set_power_mgmt(wdev->wiphy, dev,
678 wdev->wext.ps_timeout)) {
679 /* assume this means it's off */
680 wdev->wext.ps = false;
684 case NETDEV_GOING_DOWN:
685 switch (wdev->iftype) {
686 case NL80211_IFTYPE_ADHOC:
687 cfg80211_leave_ibss(rdev, dev, true);
689 case NL80211_IFTYPE_STATION:
691 #ifdef CONFIG_WIRELESS_EXT
692 kfree(wdev->wext.ie);
693 wdev->wext.ie = NULL;
694 wdev->wext.ie_len = 0;
695 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
697 __cfg80211_disconnect(rdev, dev,
698 WLAN_REASON_DEAUTH_LEAVING, true);
699 cfg80211_mlme_down(rdev, dev);
707 #ifdef CONFIG_WIRELESS_EXT
708 cfg80211_lock_rdev(rdev);
710 switch (wdev->iftype) {
711 case NL80211_IFTYPE_ADHOC:
712 cfg80211_ibss_wext_join(rdev, wdev);
714 case NL80211_IFTYPE_STATION:
715 cfg80211_mgd_wext_connect(rdev, wdev);
721 cfg80211_unlock_rdev(rdev);
724 case NETDEV_UNREGISTER:
725 mutex_lock(&rdev->devlist_mtx);
727 * It is possible to get NETDEV_UNREGISTER
728 * multiple times. To detect that, check
729 * that the interface is still on the list
730 * of registered interfaces, and only then
731 * remove and clean it up.
733 if (!list_empty(&wdev->list)) {
734 sysfs_remove_link(&dev->dev.kobj, "phy80211");
735 list_del_init(&wdev->list);
736 mutex_destroy(&wdev->mtx);
737 #ifdef CONFIG_WIRELESS_EXT
738 kfree(wdev->wext.keys);
741 mutex_unlock(&rdev->devlist_mtx);
744 if (!(wdev->wiphy->interface_modes & BIT(wdev->iftype)))
745 return notifier_from_errno(-EOPNOTSUPP);
746 if (rfkill_blocked(rdev->rfkill))
747 return notifier_from_errno(-ERFKILL);
754 static struct notifier_block cfg80211_netdev_notifier = {
755 .notifier_call = cfg80211_netdev_notifier_call,
758 static void __net_exit cfg80211_pernet_exit(struct net *net)
760 struct cfg80211_registered_device *rdev;
763 mutex_lock(&cfg80211_mutex);
764 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
765 if (net_eq(wiphy_net(&rdev->wiphy), net))
766 WARN_ON(cfg80211_switch_netns(rdev, &init_net));
768 mutex_unlock(&cfg80211_mutex);
772 static struct pernet_operations cfg80211_pernet_ops = {
773 .exit = cfg80211_pernet_exit,
776 static int __init cfg80211_init(void)
780 err = register_pernet_device(&cfg80211_pernet_ops);
782 goto out_fail_pernet;
784 err = wiphy_sysfs_init();
788 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
790 goto out_fail_notifier;
792 err = nl80211_init();
794 goto out_fail_nl80211;
796 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
798 err = regulatory_init();
805 debugfs_remove(ieee80211_debugfs_dir);
807 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
811 unregister_pernet_device(&cfg80211_pernet_ops);
815 subsys_initcall(cfg80211_init);
817 static void cfg80211_exit(void)
819 debugfs_remove(ieee80211_debugfs_dir);
821 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
824 unregister_pernet_device(&cfg80211_pernet_ops);
826 module_exit(cfg80211_exit);