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 <net/genetlink.h>
16 #include <net/cfg80211.h>
22 /* name for sysfs, %d is appended */
23 #define PHY_NAME "phy"
25 MODULE_AUTHOR("Johannes Berg");
26 MODULE_LICENSE("GPL");
27 MODULE_DESCRIPTION("wireless configuration support");
29 /* RCU might be appropriate here since we usually
30 * only read the list, and that can happen quite
31 * often because we need to do it for each command */
32 LIST_HEAD(cfg80211_drv_list);
35 * This is used to protect the cfg80211_drv_list, cfg80211_regdomain,
36 * country_ie_regdomain, the reg_beacon_list and the the last regulatory
37 * request receipt (last_request).
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_drv_by_wiphy_idx(int wiphy_idx)
47 struct cfg80211_registered_device *result = NULL, *drv;
49 if (!wiphy_idx_valid(wiphy_idx))
52 assert_cfg80211_lock();
54 list_for_each_entry(drv, &cfg80211_drv_list, list) {
55 if (drv->wiphy_idx == wiphy_idx) {
64 int get_wiphy_idx(struct wiphy *wiphy)
66 struct cfg80211_registered_device *drv;
68 return WIPHY_IDX_STALE;
69 drv = wiphy_to_dev(wiphy);
70 return drv->wiphy_idx;
73 /* requires cfg80211_drv_mutex to be held! */
74 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx)
76 struct cfg80211_registered_device *drv;
78 if (!wiphy_idx_valid(wiphy_idx))
81 assert_cfg80211_lock();
83 drv = cfg80211_drv_by_wiphy_idx(wiphy_idx);
89 /* requires cfg80211_mutex to be held! */
90 struct cfg80211_registered_device *
91 __cfg80211_drv_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_drv_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(&init_net, 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 *drv;
138 mutex_lock(&cfg80211_mutex);
139 drv = __cfg80211_drv_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(&drv->mtx);
147 mutex_unlock(&cfg80211_mutex);
152 struct cfg80211_registered_device *
153 cfg80211_get_dev_from_ifindex(int ifindex)
155 struct cfg80211_registered_device *drv = ERR_PTR(-ENODEV);
156 struct net_device *dev;
158 mutex_lock(&cfg80211_mutex);
159 dev = dev_get_by_index(&init_net, ifindex);
162 if (dev->ieee80211_ptr) {
163 drv = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
164 mutex_lock(&drv->mtx);
166 drv = ERR_PTR(-ENODEV);
169 mutex_unlock(&cfg80211_mutex);
173 void cfg80211_put_dev(struct cfg80211_registered_device *drv)
176 mutex_unlock(&drv->mtx);
179 /* requires cfg80211_mutex to be held */
180 int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
183 struct cfg80211_registered_device *drv;
184 int wiphy_idx, taken = -1, result, digits;
186 assert_cfg80211_lock();
188 /* prohibit calling the thing phy%d when %d is not its number */
189 sscanf(newname, PHY_NAME "%d%n", &wiphy_idx, &taken);
190 if (taken == strlen(newname) && wiphy_idx != rdev->wiphy_idx) {
191 /* count number of places needed to print wiphy_idx */
193 while (wiphy_idx /= 10)
196 * deny the name if it is phy<idx> where <idx> is printed
197 * without leading zeroes. taken == strlen(newname) here
199 if (taken == strlen(PHY_NAME) + digits)
204 /* Ignore nop renames */
205 if (strcmp(newname, dev_name(&rdev->wiphy.dev)) == 0)
208 /* Ensure another device does not already have this name. */
209 list_for_each_entry(drv, &cfg80211_drv_list, list)
210 if (strcmp(newname, dev_name(&drv->wiphy.dev)) == 0)
213 result = device_rename(&rdev->wiphy.dev, newname);
217 if (rdev->wiphy.debugfsdir &&
218 !debugfs_rename(rdev->wiphy.debugfsdir->d_parent,
219 rdev->wiphy.debugfsdir,
220 rdev->wiphy.debugfsdir->d_parent,
222 printk(KERN_ERR "cfg80211: failed to rename debugfs dir to %s!\n",
225 nl80211_notify_dev_rename(rdev);
230 /* exported functions */
232 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
234 static int wiphy_counter;
236 struct cfg80211_registered_device *drv;
239 WARN_ON(!ops->add_key && ops->del_key);
240 WARN_ON(ops->add_key && !ops->del_key);
242 alloc_size = sizeof(*drv) + sizeof_priv;
244 drv = kzalloc(alloc_size, GFP_KERNEL);
250 mutex_lock(&cfg80211_mutex);
252 drv->wiphy_idx = wiphy_counter++;
254 if (unlikely(!wiphy_idx_valid(drv->wiphy_idx))) {
256 mutex_unlock(&cfg80211_mutex);
262 mutex_unlock(&cfg80211_mutex);
264 /* give it a proper name */
265 dev_set_name(&drv->wiphy.dev, PHY_NAME "%d", drv->wiphy_idx);
267 mutex_init(&drv->mtx);
268 mutex_init(&drv->devlist_mtx);
269 INIT_LIST_HEAD(&drv->netdev_list);
270 spin_lock_init(&drv->bss_lock);
271 INIT_LIST_HEAD(&drv->bss_list);
273 device_initialize(&drv->wiphy.dev);
274 drv->wiphy.dev.class = &ieee80211_class;
275 drv->wiphy.dev.platform_data = drv;
278 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
279 * Fragmentation and RTS threshold are disabled by default with the
282 drv->wiphy.retry_short = 7;
283 drv->wiphy.retry_long = 4;
284 drv->wiphy.frag_threshold = (u32) -1;
285 drv->wiphy.rts_threshold = (u32) -1;
289 EXPORT_SYMBOL(wiphy_new);
291 int wiphy_register(struct wiphy *wiphy)
293 struct cfg80211_registered_device *drv = wiphy_to_dev(wiphy);
295 enum ieee80211_band band;
296 struct ieee80211_supported_band *sband;
297 bool have_band = false;
299 u16 ifmodes = wiphy->interface_modes;
301 if (WARN_ON(wiphy->max_scan_ssids < 1))
304 /* sanity check ifmodes */
306 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
307 if (WARN_ON(ifmodes != wiphy->interface_modes))
308 wiphy->interface_modes = ifmodes;
310 /* sanity check supported bands/channels */
311 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
312 sband = wiphy->bands[band];
318 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
322 * Since we use a u32 for rate bitmaps in
323 * ieee80211_get_response_rate, we cannot
324 * have more than 32 legacy rates.
326 if (WARN_ON(sband->n_bitrates > 32))
329 for (i = 0; i < sband->n_channels; i++) {
330 sband->channels[i].orig_flags =
331 sband->channels[i].flags;
332 sband->channels[i].orig_mag =
333 sband->channels[i].max_antenna_gain;
334 sband->channels[i].orig_mpwr =
335 sband->channels[i].max_power;
336 sband->channels[i].band = band;
347 /* check and set up bitrates */
348 ieee80211_set_bitrate_flags(wiphy);
350 mutex_lock(&cfg80211_mutex);
352 /* set up regulatory info */
353 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
355 res = device_add(&drv->wiphy.dev);
359 list_add(&drv->list, &cfg80211_drv_list);
362 drv->wiphy.debugfsdir =
363 debugfs_create_dir(wiphy_name(&drv->wiphy),
364 ieee80211_debugfs_dir);
365 if (IS_ERR(drv->wiphy.debugfsdir))
366 drv->wiphy.debugfsdir = NULL;
368 if (wiphy->custom_regulatory) {
369 struct regulatory_request request;
371 request.wiphy_idx = get_wiphy_idx(wiphy);
372 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
373 request.alpha2[0] = '9';
374 request.alpha2[1] = '9';
376 nl80211_send_reg_change_event(&request);
379 cfg80211_debugfs_drv_add(drv);
383 mutex_unlock(&cfg80211_mutex);
386 EXPORT_SYMBOL(wiphy_register);
388 void wiphy_unregister(struct wiphy *wiphy)
390 struct cfg80211_registered_device *drv = wiphy_to_dev(wiphy);
392 /* protect the device list */
393 mutex_lock(&cfg80211_mutex);
395 BUG_ON(!list_empty(&drv->netdev_list));
398 * Try to grab drv->mtx. If a command is still in progress,
399 * hopefully the driver will refuse it since it's tearing
400 * down the device already. We wait for this command to complete
401 * before unlinking the item from the list.
402 * Note: as codified by the BUG_ON above we cannot get here if
403 * a virtual interface is still associated. Hence, we can only
404 * get to lock contention here if userspace issues a command
405 * that identified the hardware by wiphy index.
407 mutex_lock(&drv->mtx);
408 /* unlock again before freeing */
409 mutex_unlock(&drv->mtx);
411 cfg80211_debugfs_drv_del(drv);
413 /* If this device got a regulatory hint tell core its
414 * free to listen now to a new shiny device regulatory hint */
415 reg_device_remove(wiphy);
417 list_del(&drv->list);
418 device_del(&drv->wiphy.dev);
419 debugfs_remove(drv->wiphy.debugfsdir);
421 mutex_unlock(&cfg80211_mutex);
423 EXPORT_SYMBOL(wiphy_unregister);
425 void cfg80211_dev_free(struct cfg80211_registered_device *drv)
427 struct cfg80211_internal_bss *scan, *tmp;
428 mutex_destroy(&drv->mtx);
429 mutex_destroy(&drv->devlist_mtx);
430 list_for_each_entry_safe(scan, tmp, &drv->bss_list, list)
431 cfg80211_put_bss(&scan->pub);
435 void wiphy_free(struct wiphy *wiphy)
437 put_device(&wiphy->dev);
439 EXPORT_SYMBOL(wiphy_free);
441 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
445 struct net_device *dev = ndev;
446 struct cfg80211_registered_device *rdev;
448 if (!dev->ieee80211_ptr)
451 rdev = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
453 WARN_ON(dev->ieee80211_ptr->iftype == NL80211_IFTYPE_UNSPECIFIED);
456 case NETDEV_REGISTER:
457 mutex_lock(&rdev->devlist_mtx);
458 list_add(&dev->ieee80211_ptr->list, &rdev->netdev_list);
459 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
461 printk(KERN_ERR "wireless: failed to add phy80211 "
462 "symlink to netdev!\n");
464 dev->ieee80211_ptr->netdev = dev;
465 #ifdef CONFIG_WIRELESS_EXT
466 dev->ieee80211_ptr->wext.default_key = -1;
467 dev->ieee80211_ptr->wext.default_mgmt_key = -1;
469 mutex_unlock(&rdev->devlist_mtx);
471 case NETDEV_GOING_DOWN:
472 if (dev->ieee80211_ptr->iftype != NL80211_IFTYPE_ADHOC)
474 if (!dev->ieee80211_ptr->ssid_len)
476 cfg80211_leave_ibss(rdev, dev, true);
479 #ifdef CONFIG_WIRELESS_EXT
480 if (dev->ieee80211_ptr->iftype != NL80211_IFTYPE_ADHOC)
482 if (!dev->ieee80211_ptr->wext.ibss.ssid_len)
484 cfg80211_join_ibss(rdev, dev, &dev->ieee80211_ptr->wext.ibss);
487 case NETDEV_UNREGISTER:
488 mutex_lock(&rdev->devlist_mtx);
489 if (!list_empty(&dev->ieee80211_ptr->list)) {
490 sysfs_remove_link(&dev->dev.kobj, "phy80211");
491 list_del_init(&dev->ieee80211_ptr->list);
493 mutex_unlock(&rdev->devlist_mtx);
500 static struct notifier_block cfg80211_netdev_notifier = {
501 .notifier_call = cfg80211_netdev_notifier_call,
504 static int cfg80211_init(void)
508 err = wiphy_sysfs_init();
512 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
514 goto out_fail_notifier;
516 err = nl80211_init();
518 goto out_fail_nl80211;
520 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
522 err = regulatory_init();
529 debugfs_remove(ieee80211_debugfs_dir);
531 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
538 subsys_initcall(cfg80211_init);
540 static void cfg80211_exit(void)
542 debugfs_remove(ieee80211_debugfs_dir);
544 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
548 module_exit(cfg80211_exit);