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,
321 __cfg80211_roamed(wdev, ev->rm.bssid,
322 ev->rm.req_ie, ev->rm.req_ie_len,
323 ev->rm.resp_ie, ev->rm.resp_ie_len);
325 case EVENT_DISCONNECTED:
326 __cfg80211_disconnected(wdev->netdev,
327 ev->dc.ie, ev->dc.ie_len,
328 ev->dc.reason, true);
330 case EVENT_IBSS_JOINED:
331 __cfg80211_ibss_joined(wdev->netdev, ev->ij.bssid);
338 spin_lock_irqsave(&wdev->event_lock, flags);
340 spin_unlock_irqrestore(&wdev->event_lock, flags);
343 static void cfg80211_event_work(struct work_struct *work)
345 struct cfg80211_registered_device *rdev;
346 struct wireless_dev *wdev;
348 rdev = container_of(work, struct cfg80211_registered_device,
352 cfg80211_lock_rdev(rdev);
353 mutex_lock(&rdev->devlist_mtx);
355 list_for_each_entry(wdev, &rdev->netdev_list, list)
356 cfg80211_process_events(wdev);
358 mutex_unlock(&rdev->devlist_mtx);
359 cfg80211_unlock_rdev(rdev);
363 /* exported functions */
365 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
367 static int wiphy_counter;
369 struct cfg80211_registered_device *rdev;
372 WARN_ON(ops->add_key && (!ops->del_key || !ops->set_default_key));
373 WARN_ON(ops->auth && (!ops->assoc || !ops->deauth || !ops->disassoc));
374 WARN_ON(ops->connect && !ops->disconnect);
375 WARN_ON(ops->join_ibss && !ops->leave_ibss);
376 WARN_ON(ops->add_virtual_intf && !ops->del_virtual_intf);
377 WARN_ON(ops->add_station && !ops->del_station);
378 WARN_ON(ops->add_mpath && !ops->del_mpath);
380 alloc_size = sizeof(*rdev) + sizeof_priv;
382 rdev = kzalloc(alloc_size, GFP_KERNEL);
388 mutex_lock(&cfg80211_mutex);
390 rdev->wiphy_idx = wiphy_counter++;
392 if (unlikely(!wiphy_idx_valid(rdev->wiphy_idx))) {
394 mutex_unlock(&cfg80211_mutex);
400 mutex_unlock(&cfg80211_mutex);
402 /* give it a proper name */
403 dev_set_name(&rdev->wiphy.dev, PHY_NAME "%d", rdev->wiphy_idx);
405 mutex_init(&rdev->mtx);
406 mutex_init(&rdev->devlist_mtx);
407 INIT_LIST_HEAD(&rdev->netdev_list);
408 spin_lock_init(&rdev->bss_lock);
409 INIT_LIST_HEAD(&rdev->bss_list);
410 INIT_WORK(&rdev->scan_done_wk, __cfg80211_scan_done);
412 device_initialize(&rdev->wiphy.dev);
413 rdev->wiphy.dev.class = &ieee80211_class;
414 rdev->wiphy.dev.platform_data = rdev;
416 wiphy_net_set(&rdev->wiphy, &init_net);
418 rdev->rfkill_ops.set_block = cfg80211_rfkill_set_block;
419 rdev->rfkill = rfkill_alloc(dev_name(&rdev->wiphy.dev),
420 &rdev->wiphy.dev, RFKILL_TYPE_WLAN,
421 &rdev->rfkill_ops, rdev);
428 INIT_WORK(&rdev->rfkill_sync, cfg80211_rfkill_sync_work);
429 INIT_WORK(&rdev->conn_work, cfg80211_conn_work);
430 INIT_WORK(&rdev->event_work, cfg80211_event_work);
433 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
434 * Fragmentation and RTS threshold are disabled by default with the
437 rdev->wiphy.retry_short = 7;
438 rdev->wiphy.retry_long = 4;
439 rdev->wiphy.frag_threshold = (u32) -1;
440 rdev->wiphy.rts_threshold = (u32) -1;
444 EXPORT_SYMBOL(wiphy_new);
446 int wiphy_register(struct wiphy *wiphy)
448 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
450 enum ieee80211_band band;
451 struct ieee80211_supported_band *sband;
452 bool have_band = false;
454 u16 ifmodes = wiphy->interface_modes;
456 /* sanity check ifmodes */
458 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
459 if (WARN_ON(ifmodes != wiphy->interface_modes))
460 wiphy->interface_modes = ifmodes;
462 /* sanity check supported bands/channels */
463 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
464 sband = wiphy->bands[band];
470 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
474 * Since we use a u32 for rate bitmaps in
475 * ieee80211_get_response_rate, we cannot
476 * have more than 32 legacy rates.
478 if (WARN_ON(sband->n_bitrates > 32))
481 for (i = 0; i < sband->n_channels; i++) {
482 sband->channels[i].orig_flags =
483 sband->channels[i].flags;
484 sband->channels[i].orig_mag =
485 sband->channels[i].max_antenna_gain;
486 sband->channels[i].orig_mpwr =
487 sband->channels[i].max_power;
488 sband->channels[i].band = band;
499 /* check and set up bitrates */
500 ieee80211_set_bitrate_flags(wiphy);
502 res = device_add(&rdev->wiphy.dev);
506 res = rfkill_register(rdev->rfkill);
510 mutex_lock(&cfg80211_mutex);
512 /* set up regulatory info */
513 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
515 list_add(&rdev->list, &cfg80211_rdev_list);
517 mutex_unlock(&cfg80211_mutex);
520 rdev->wiphy.debugfsdir =
521 debugfs_create_dir(wiphy_name(&rdev->wiphy),
522 ieee80211_debugfs_dir);
523 if (IS_ERR(rdev->wiphy.debugfsdir))
524 rdev->wiphy.debugfsdir = NULL;
526 if (wiphy->custom_regulatory) {
527 struct regulatory_request request;
529 request.wiphy_idx = get_wiphy_idx(wiphy);
530 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
531 request.alpha2[0] = '9';
532 request.alpha2[1] = '9';
534 nl80211_send_reg_change_event(&request);
537 cfg80211_debugfs_rdev_add(rdev);
542 device_del(&rdev->wiphy.dev);
545 EXPORT_SYMBOL(wiphy_register);
547 void wiphy_rfkill_start_polling(struct wiphy *wiphy)
549 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
551 if (!rdev->ops->rfkill_poll)
553 rdev->rfkill_ops.poll = cfg80211_rfkill_poll;
554 rfkill_resume_polling(rdev->rfkill);
556 EXPORT_SYMBOL(wiphy_rfkill_start_polling);
558 void wiphy_rfkill_stop_polling(struct wiphy *wiphy)
560 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
562 rfkill_pause_polling(rdev->rfkill);
564 EXPORT_SYMBOL(wiphy_rfkill_stop_polling);
566 void wiphy_unregister(struct wiphy *wiphy)
568 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
570 rfkill_unregister(rdev->rfkill);
572 /* protect the device list */
573 mutex_lock(&cfg80211_mutex);
575 BUG_ON(!list_empty(&rdev->netdev_list));
578 * Try to grab rdev->mtx. If a command is still in progress,
579 * hopefully the driver will refuse it since it's tearing
580 * down the device already. We wait for this command to complete
581 * before unlinking the item from the list.
582 * Note: as codified by the BUG_ON above we cannot get here if
583 * a virtual interface is still associated. Hence, we can only
584 * get to lock contention here if userspace issues a command
585 * that identified the hardware by wiphy index.
587 mutex_lock(&rdev->mtx);
588 /* unlock again before freeing */
589 mutex_unlock(&rdev->mtx);
591 cfg80211_debugfs_rdev_del(rdev);
593 /* If this device got a regulatory hint tell core its
594 * free to listen now to a new shiny device regulatory hint */
595 reg_device_remove(wiphy);
597 list_del(&rdev->list);
598 device_del(&rdev->wiphy.dev);
599 debugfs_remove(rdev->wiphy.debugfsdir);
601 mutex_unlock(&cfg80211_mutex);
603 cancel_work_sync(&rdev->conn_work);
604 cancel_work_sync(&rdev->scan_done_wk);
605 kfree(rdev->scan_req);
606 flush_work(&rdev->event_work);
608 EXPORT_SYMBOL(wiphy_unregister);
610 void cfg80211_dev_free(struct cfg80211_registered_device *rdev)
612 struct cfg80211_internal_bss *scan, *tmp;
613 rfkill_destroy(rdev->rfkill);
614 mutex_destroy(&rdev->mtx);
615 mutex_destroy(&rdev->devlist_mtx);
616 list_for_each_entry_safe(scan, tmp, &rdev->bss_list, list)
617 cfg80211_put_bss(&scan->pub);
621 void wiphy_free(struct wiphy *wiphy)
623 put_device(&wiphy->dev);
625 EXPORT_SYMBOL(wiphy_free);
627 void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked)
629 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
631 if (rfkill_set_hw_state(rdev->rfkill, blocked))
632 schedule_work(&rdev->rfkill_sync);
634 EXPORT_SYMBOL(wiphy_rfkill_set_hw_state);
636 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
640 struct net_device *dev = ndev;
641 struct wireless_dev *wdev = dev->ieee80211_ptr;
642 struct cfg80211_registered_device *rdev;
647 rdev = wiphy_to_dev(wdev->wiphy);
649 WARN_ON(wdev->iftype == NL80211_IFTYPE_UNSPECIFIED);
652 case NETDEV_REGISTER:
653 mutex_init(&wdev->mtx);
654 INIT_LIST_HEAD(&wdev->event_list);
655 spin_lock_init(&wdev->event_lock);
656 mutex_lock(&rdev->devlist_mtx);
657 list_add(&wdev->list, &rdev->netdev_list);
658 /* can only change netns with wiphy */
659 dev->features |= NETIF_F_NETNS_LOCAL;
661 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
663 printk(KERN_ERR "wireless: failed to add phy80211 "
664 "symlink to netdev!\n");
667 wdev->sme_state = CFG80211_SME_IDLE;
668 mutex_unlock(&rdev->devlist_mtx);
669 #ifdef CONFIG_WIRELESS_EXT
670 if (!dev->wireless_handlers)
671 dev->wireless_handlers = &cfg80211_wext_handler;
672 wdev->wext.default_key = -1;
673 wdev->wext.default_mgmt_key = -1;
674 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
675 wdev->wext.ps = CONFIG_CFG80211_DEFAULT_PS_VALUE;
676 wdev->wext.ps_timeout = 500;
677 if (rdev->ops->set_power_mgmt)
678 if (rdev->ops->set_power_mgmt(wdev->wiphy, dev,
680 wdev->wext.ps_timeout)) {
681 /* assume this means it's off */
682 wdev->wext.ps = false;
686 case NETDEV_GOING_DOWN:
687 switch (wdev->iftype) {
688 case NL80211_IFTYPE_ADHOC:
689 cfg80211_leave_ibss(rdev, dev, true);
691 case NL80211_IFTYPE_STATION:
693 #ifdef CONFIG_WIRELESS_EXT
694 kfree(wdev->wext.ie);
695 wdev->wext.ie = NULL;
696 wdev->wext.ie_len = 0;
697 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
699 __cfg80211_disconnect(rdev, dev,
700 WLAN_REASON_DEAUTH_LEAVING, true);
701 cfg80211_mlme_down(rdev, dev);
709 #ifdef CONFIG_WIRELESS_EXT
710 cfg80211_lock_rdev(rdev);
712 switch (wdev->iftype) {
713 case NL80211_IFTYPE_ADHOC:
714 cfg80211_ibss_wext_join(rdev, wdev);
716 case NL80211_IFTYPE_STATION:
717 cfg80211_mgd_wext_connect(rdev, wdev);
723 cfg80211_unlock_rdev(rdev);
726 case NETDEV_UNREGISTER:
727 mutex_lock(&rdev->devlist_mtx);
728 if (!list_empty(&wdev->list)) {
729 sysfs_remove_link(&dev->dev.kobj, "phy80211");
730 list_del_init(&wdev->list);
732 mutex_unlock(&rdev->devlist_mtx);
733 mutex_destroy(&wdev->mtx);
734 #ifdef CONFIG_WIRELESS_EXT
735 kfree(wdev->wext.keys);
739 if (!(wdev->wiphy->interface_modes & BIT(wdev->iftype)))
740 return notifier_from_errno(-EOPNOTSUPP);
741 if (rfkill_blocked(rdev->rfkill))
742 return notifier_from_errno(-ERFKILL);
749 static struct notifier_block cfg80211_netdev_notifier = {
750 .notifier_call = cfg80211_netdev_notifier_call,
753 static void __net_exit cfg80211_pernet_exit(struct net *net)
755 struct cfg80211_registered_device *rdev;
758 mutex_lock(&cfg80211_mutex);
759 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
760 if (net_eq(wiphy_net(&rdev->wiphy), net))
761 WARN_ON(cfg80211_switch_netns(rdev, &init_net));
763 mutex_unlock(&cfg80211_mutex);
767 static struct pernet_operations cfg80211_pernet_ops = {
768 .exit = cfg80211_pernet_exit,
771 static int __init cfg80211_init(void)
775 err = register_pernet_device(&cfg80211_pernet_ops);
777 goto out_fail_pernet;
779 err = wiphy_sysfs_init();
783 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
785 goto out_fail_notifier;
787 err = nl80211_init();
789 goto out_fail_nl80211;
791 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
793 err = regulatory_init();
800 debugfs_remove(ieee80211_debugfs_dir);
802 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
806 unregister_pernet_device(&cfg80211_pernet_ops);
810 subsys_initcall(cfg80211_init);
812 static void cfg80211_exit(void)
814 debugfs_remove(ieee80211_debugfs_dir);
816 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
819 unregister_pernet_device(&cfg80211_pernet_ops);
821 module_exit(cfg80211_exit);