2 * Wireless configuration interface internals.
4 * Copyright 2006-2009 Johannes Berg <johannes@sipsolutions.net>
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 <linux/kref.h>
12 #include <linux/rbtree.h>
13 #include <linux/debugfs.h>
14 #include <linux/rfkill.h>
15 #include <linux/workqueue.h>
16 #include <net/genetlink.h>
17 #include <net/cfg80211.h>
20 struct cfg80211_registered_device {
21 const struct cfg80211_ops *ops;
22 struct list_head list;
23 /* we hold this mutex during any call so that
24 * we cannot do multiple calls at once, and also
25 * to avoid the deregister call to proceed while
26 * any call is in progress */
30 struct rfkill_ops rfkill_ops;
31 struct rfkill *rfkill;
32 struct work_struct rfkill_sync;
34 /* ISO / IEC 3166 alpha2 for which this device is receiving
35 * country IEs on, this can help disregard country IEs from APs
36 * on the same alpha2 quickly. The alpha2 may differ from
37 * cfg80211_regdomain's alpha2 when an intersection has occurred.
38 * If the AP is reconfigured this can also be used to tell us if
39 * the country on the country IE changed. */
40 char country_ie_alpha2[2];
42 /* If a Country IE has been received this tells us the environment
43 * which its telling us its in. This defaults to ENVIRON_ANY */
44 enum environment_cap env;
46 /* wiphy index, internal only */
49 /* associate netdev list */
50 struct mutex devlist_mtx;
51 struct list_head netdev_list;
55 struct list_head bss_list;
56 struct rb_root bss_tree;
58 struct cfg80211_scan_request *scan_req; /* protected by RTNL */
59 unsigned long suspend_at;
61 #ifdef CONFIG_NL80211_TESTMODE
62 struct genl_info *testmode_info;
65 #ifdef CONFIG_CFG80211_DEBUGFS
67 struct wiphy_debugfsdentries {
68 struct dentry *rts_threshold;
69 struct dentry *fragmentation_threshold;
70 struct dentry *short_retry_limit;
71 struct dentry *long_retry_limit;
72 struct dentry *ht40allow_map;
76 /* must be last because of the way we do wiphy_priv(),
77 * and it should at least be aligned to NETDEV_ALIGN */
78 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
82 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
85 return container_of(wiphy, struct cfg80211_registered_device, wiphy);
88 /* Note 0 is valid, hence phy0 */
90 bool wiphy_idx_valid(int wiphy_idx)
92 return (wiphy_idx >= 0);
95 extern struct mutex cfg80211_mutex;
96 extern struct list_head cfg80211_drv_list;
98 #define assert_cfg80211_lock() WARN_ON(!mutex_is_locked(&cfg80211_mutex))
101 * You can use this to mark a wiphy_idx as not having an associated wiphy.
102 * It guarantees cfg80211_drv_by_wiphy_idx(wiphy_idx) will return NULL
104 #define WIPHY_IDX_STALE -1
106 struct cfg80211_internal_bss {
107 struct list_head list;
111 bool hold, ies_allocated;
113 /* must be last because of priv member */
114 struct cfg80211_bss pub;
117 struct cfg80211_registered_device *cfg80211_drv_by_wiphy_idx(int wiphy_idx);
118 int get_wiphy_idx(struct wiphy *wiphy);
120 struct cfg80211_registered_device *
121 __cfg80211_drv_from_info(struct genl_info *info);
124 * This function returns a pointer to the driver
125 * that the genl_info item that is passed refers to.
126 * If successful, it returns non-NULL and also locks
127 * the driver's mutex!
129 * This means that you need to call cfg80211_put_dev()
130 * before being allowed to acquire &cfg80211_mutex!
132 * This is necessary because we need to lock the global
133 * mutex to get an item off the list safely, and then
134 * we lock the drv mutex so it doesn't go away under us.
136 * We don't want to keep cfg80211_mutex locked
137 * for all the time in order to allow requests on
138 * other interfaces to go through at the same time.
140 * The result of this can be a PTR_ERR and hence must
141 * be checked with IS_ERR() for errors.
143 extern struct cfg80211_registered_device *
144 cfg80211_get_dev_from_info(struct genl_info *info);
146 /* requires cfg80211_drv_mutex to be held! */
147 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
149 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
150 extern struct cfg80211_registered_device *
151 cfg80211_get_dev_from_ifindex(int ifindex);
153 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv);
156 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv);
158 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv,
161 void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
162 void wiphy_update_regulatory(struct wiphy *wiphy,
163 enum nl80211_reg_initiator setby);
165 void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
166 void cfg80211_bss_age(struct cfg80211_registered_device *dev,
167 unsigned long age_secs);
170 int cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
171 struct net_device *dev,
172 struct cfg80211_ibss_params *params);
173 void cfg80211_clear_ibss(struct net_device *dev, bool nowext);
174 int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
175 struct net_device *dev, bool nowext);
177 /* internal helpers */
178 int cfg80211_validate_key_settings(struct key_params *params, int key_idx,
181 #endif /* __NET_WIRELESS_CORE_H */