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 struct work_struct conn_work
;
67 #ifdef CONFIG_CFG80211_DEBUGFS
69 struct wiphy_debugfsdentries
{
70 struct dentry
*rts_threshold
;
71 struct dentry
*fragmentation_threshold
;
72 struct dentry
*short_retry_limit
;
73 struct dentry
*long_retry_limit
;
74 struct dentry
*ht40allow_map
;
78 /* must be last because of the way we do wiphy_priv(),
79 * and it should at least be aligned to NETDEV_ALIGN */
80 struct wiphy wiphy
__attribute__((__aligned__(NETDEV_ALIGN
)));
84 struct cfg80211_registered_device
*wiphy_to_dev(struct wiphy
*wiphy
)
87 return container_of(wiphy
, struct cfg80211_registered_device
, wiphy
);
90 /* Note 0 is valid, hence phy0 */
92 bool wiphy_idx_valid(int wiphy_idx
)
94 return (wiphy_idx
>= 0);
97 extern struct mutex cfg80211_mutex
;
98 extern struct list_head cfg80211_drv_list
;
100 #define assert_cfg80211_lock() WARN_ON(!mutex_is_locked(&cfg80211_mutex))
103 * You can use this to mark a wiphy_idx as not having an associated wiphy.
104 * It guarantees cfg80211_drv_by_wiphy_idx(wiphy_idx) will return NULL
106 #define WIPHY_IDX_STALE -1
108 struct cfg80211_internal_bss
{
109 struct list_head list
;
116 /* must be last because of priv member */
117 struct cfg80211_bss pub
;
120 static inline struct cfg80211_internal_bss
*bss_from_pub(struct cfg80211_bss
*pub
)
122 return container_of(pub
, struct cfg80211_internal_bss
, pub
);
125 static inline void cfg80211_hold_bss(struct cfg80211_internal_bss
*bss
)
127 atomic_inc(&bss
->hold
);
130 static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss
*bss
)
132 int r
= atomic_dec_return(&bss
->hold
);
137 struct cfg80211_registered_device
*cfg80211_drv_by_wiphy_idx(int wiphy_idx
);
138 int get_wiphy_idx(struct wiphy
*wiphy
);
140 struct cfg80211_registered_device
*
141 __cfg80211_drv_from_info(struct genl_info
*info
);
144 * This function returns a pointer to the driver
145 * that the genl_info item that is passed refers to.
146 * If successful, it returns non-NULL and also locks
147 * the driver's mutex!
149 * This means that you need to call cfg80211_put_dev()
150 * before being allowed to acquire &cfg80211_mutex!
152 * This is necessary because we need to lock the global
153 * mutex to get an item off the list safely, and then
154 * we lock the drv mutex so it doesn't go away under us.
156 * We don't want to keep cfg80211_mutex locked
157 * for all the time in order to allow requests on
158 * other interfaces to go through at the same time.
160 * The result of this can be a PTR_ERR and hence must
161 * be checked with IS_ERR() for errors.
163 extern struct cfg80211_registered_device
*
164 cfg80211_get_dev_from_info(struct genl_info
*info
);
166 /* requires cfg80211_drv_mutex to be held! */
167 struct wiphy
*wiphy_idx_to_wiphy(int wiphy_idx
);
169 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
170 extern struct cfg80211_registered_device
*
171 cfg80211_get_dev_from_ifindex(int ifindex
);
173 extern void cfg80211_put_dev(struct cfg80211_registered_device
*drv
);
176 extern void cfg80211_dev_free(struct cfg80211_registered_device
*drv
);
178 extern int cfg80211_dev_rename(struct cfg80211_registered_device
*drv
,
181 void ieee80211_set_bitrate_flags(struct wiphy
*wiphy
);
182 void wiphy_update_regulatory(struct wiphy
*wiphy
,
183 enum nl80211_reg_initiator setby
);
185 void cfg80211_bss_expire(struct cfg80211_registered_device
*dev
);
186 void cfg80211_bss_age(struct cfg80211_registered_device
*dev
,
187 unsigned long age_secs
);
190 int cfg80211_join_ibss(struct cfg80211_registered_device
*rdev
,
191 struct net_device
*dev
,
192 struct cfg80211_ibss_params
*params
);
193 void cfg80211_clear_ibss(struct net_device
*dev
, bool nowext
);
194 int cfg80211_leave_ibss(struct cfg80211_registered_device
*rdev
,
195 struct net_device
*dev
, bool nowext
);
198 int cfg80211_mlme_auth(struct cfg80211_registered_device
*rdev
,
199 struct net_device
*dev
, struct ieee80211_channel
*chan
,
200 enum nl80211_auth_type auth_type
, const u8
*bssid
,
201 const u8
*ssid
, int ssid_len
,
202 const u8
*ie
, int ie_len
);
203 int cfg80211_mlme_assoc(struct cfg80211_registered_device
*rdev
,
204 struct net_device
*dev
, struct ieee80211_channel
*chan
,
205 const u8
*bssid
, const u8
*prev_bssid
,
206 const u8
*ssid
, int ssid_len
,
207 const u8
*ie
, int ie_len
, bool use_mfp
,
208 struct cfg80211_crypto_settings
*crypt
);
209 int cfg80211_mlme_deauth(struct cfg80211_registered_device
*rdev
,
210 struct net_device
*dev
, const u8
*bssid
,
211 const u8
*ie
, int ie_len
, u16 reason
);
212 int cfg80211_mlme_disassoc(struct cfg80211_registered_device
*rdev
,
213 struct net_device
*dev
, const u8
*bssid
,
214 const u8
*ie
, int ie_len
, u16 reason
);
215 void cfg80211_mlme_down(struct cfg80211_registered_device
*rdev
,
216 struct net_device
*dev
);
219 int cfg80211_connect(struct cfg80211_registered_device
*rdev
,
220 struct net_device
*dev
,
221 struct cfg80211_connect_params
*connect
);
222 int cfg80211_disconnect(struct cfg80211_registered_device
*rdev
,
223 struct net_device
*dev
, u16 reason
,
226 void cfg80211_conn_work(struct work_struct
*work
);
228 /* internal helpers */
229 int cfg80211_validate_key_settings(struct key_params
*params
, int key_idx
,
231 void __cfg80211_disconnected(struct net_device
*dev
, gfp_t gfp
, u8
*ie
,
232 size_t ie_len
, u16 reason
, bool from_ap
);
233 void cfg80211_sme_scan_done(struct net_device
*dev
);
234 void cfg80211_sme_rx_auth(struct net_device
*dev
, const u8
*buf
, size_t len
);
235 void cfg80211_sme_disassoc(struct net_device
*dev
, int idx
);
237 #endif /* __NET_WIRELESS_CORE_H */