Merge git://git.kernel.org/pub/scm/linux/kernel/git/sam/kbuild-linus
[linux-2.6] / net / wireless / core.h
1 /*
2  * Wireless configuration interface internals.
3  *
4  * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
5  */
6 #ifndef __NET_WIRELESS_CORE_H
7 #define __NET_WIRELESS_CORE_H
8 #include <linux/mutex.h>
9 #include <linux/list.h>
10 #include <linux/netdevice.h>
11 #include <net/genetlink.h>
12 #include <net/wireless.h>
13 #include <net/cfg80211.h>
14
15 struct cfg80211_registered_device {
16         struct cfg80211_ops *ops;
17         struct list_head list;
18         /* we hold this mutex during any call so that
19          * we cannot do multiple calls at once, and also
20          * to avoid the deregister call to proceed while
21          * any call is in progress */
22         struct mutex mtx;
23
24         /* wiphy index, internal only */
25         int idx;
26
27         /* associate netdev list */
28         struct mutex devlist_mtx;
29         struct list_head netdev_list;
30
31         /* must be last because of the way we do wiphy_priv(),
32          * and it should at least be aligned to NETDEV_ALIGN */
33         struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
34 };
35
36 static inline
37 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
38 {
39         BUG_ON(!wiphy);
40         return container_of(wiphy, struct cfg80211_registered_device, wiphy);
41 }
42
43 extern struct mutex cfg80211_drv_mutex;
44 extern struct list_head cfg80211_drv_list;
45
46 /*
47  * This function returns a pointer to the driver
48  * that the genl_info item that is passed refers to.
49  * If successful, it returns non-NULL and also locks
50  * the driver's mutex!
51  *
52  * This means that you need to call cfg80211_put_dev()
53  * before being allowed to acquire &cfg80211_drv_mutex!
54  *
55  * This is necessary because we need to lock the global
56  * mutex to get an item off the list safely, and then
57  * we lock the drv mutex so it doesn't go away under us.
58  *
59  * We don't want to keep cfg80211_drv_mutex locked
60  * for all the time in order to allow requests on
61  * other interfaces to go through at the same time.
62  *
63  * The result of this can be a PTR_ERR and hence must
64  * be checked with IS_ERR() for errors.
65  */
66 extern struct cfg80211_registered_device *
67 cfg80211_get_dev_from_info(struct genl_info *info);
68
69 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
70 extern struct cfg80211_registered_device *
71 cfg80211_get_dev_from_ifindex(int ifindex);
72
73 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv);
74
75 /* free object */
76 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv);
77
78 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv,
79                                char *newname);
80
81 void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
82 void wiphy_update_regulatory(struct wiphy *wiphy);
83
84 #endif /* __NET_WIRELESS_CORE_H */