]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - net/wireless/core.h
mac80211: verify info->control.vif is not NULL
[mirror_ubuntu-artful-kernel.git] / net / wireless / core.h
CommitLineData
704232c2
JB
1/*
2 * Wireless configuration interface internals.
3 *
08645126 4 * Copyright 2006-2009 Johannes Berg <johannes@sipsolutions.net>
704232c2
JB
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>
2a519311
JB
11#include <linux/kref.h>
12#include <linux/rbtree.h>
1ac61302 13#include <linux/debugfs.h>
1f87f7d3
JB
14#include <linux/rfkill.h>
15#include <linux/workqueue.h>
704232c2 16#include <net/genetlink.h>
704232c2 17#include <net/cfg80211.h>
3f2355cb 18#include "reg.h"
704232c2
JB
19
20struct cfg80211_registered_device {
3dcf670b 21 const struct cfg80211_ops *ops;
704232c2
JB
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 */
27 struct mutex mtx;
28
1f87f7d3
JB
29 /* rfkill support */
30 struct rfkill_ops rfkill_ops;
31 struct rfkill *rfkill;
32 struct work_struct rfkill_sync;
33
3f2355cb
LR
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];
41
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;
45
704232c2 46 /* wiphy index, internal only */
b5850a7a 47 int wiphy_idx;
704232c2
JB
48
49 /* associate netdev list */
50 struct mutex devlist_mtx;
51 struct list_head netdev_list;
52
2a519311
JB
53 /* BSSes/scanning */
54 spinlock_t bss_lock;
55 struct list_head bss_list;
56 struct rb_root bss_tree;
57 u32 bss_generation;
58 struct cfg80211_scan_request *scan_req; /* protected by RTNL */
cb3a8eec 59 unsigned long suspend_at;
667503dd 60 struct work_struct scan_done_wk;
2a519311 61
aff89a9b
JB
62#ifdef CONFIG_NL80211_TESTMODE
63 struct genl_info *testmode_info;
64#endif
65
6829c878 66 struct work_struct conn_work;
667503dd 67 struct work_struct event_work;
6829c878 68
e43e820c 69#ifdef CONFIG_CFG80211_DEBUGFS
1ac61302
LR
70 /* Debugfs entries */
71 struct wiphy_debugfsdentries {
72 struct dentry *rts_threshold;
73 struct dentry *fragmentation_threshold;
74 struct dentry *short_retry_limit;
75 struct dentry *long_retry_limit;
80a3511d 76 struct dentry *ht40allow_map;
1ac61302
LR
77 } debugfs;
78#endif
79
704232c2
JB
80 /* must be last because of the way we do wiphy_priv(),
81 * and it should at least be aligned to NETDEV_ALIGN */
82 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
83};
84
85static inline
86struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
87{
88 BUG_ON(!wiphy);
89 return container_of(wiphy, struct cfg80211_registered_device, wiphy);
90}
91
85fd129a
LR
92/* Note 0 is valid, hence phy0 */
93static inline
94bool wiphy_idx_valid(int wiphy_idx)
95{
96 return (wiphy_idx >= 0);
97}
98
a1794390 99extern struct mutex cfg80211_mutex;
79c97e97 100extern struct list_head cfg80211_rdev_list;
704232c2 101
7edfab7a 102#define assert_cfg80211_lock() WARN_ON(!mutex_is_locked(&cfg80211_mutex))
761cf7ec 103
806a9e39
LR
104/*
105 * You can use this to mark a wiphy_idx as not having an associated wiphy.
79c97e97 106 * It guarantees cfg80211_rdev_by_wiphy_idx(wiphy_idx) will return NULL
806a9e39
LR
107 */
108#define WIPHY_IDX_STALE -1
109
2a519311
JB
110struct cfg80211_internal_bss {
111 struct list_head list;
112 struct rb_node rbn;
113 unsigned long ts;
114 struct kref ref;
19957bb3
JB
115 atomic_t hold;
116 bool ies_allocated;
a08c1c1a 117
2a519311
JB
118 /* must be last because of priv member */
119 struct cfg80211_bss pub;
120};
121
19957bb3
JB
122static inline struct cfg80211_internal_bss *bss_from_pub(struct cfg80211_bss *pub)
123{
124 return container_of(pub, struct cfg80211_internal_bss, pub);
125}
126
127static inline void cfg80211_hold_bss(struct cfg80211_internal_bss *bss)
128{
129 atomic_inc(&bss->hold);
130}
131
132static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss *bss)
133{
134 int r = atomic_dec_return(&bss->hold);
135 WARN_ON(r < 0);
136}
137
138
79c97e97 139struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx);
806a9e39
LR
140int get_wiphy_idx(struct wiphy *wiphy);
141
4bbf4d56 142struct cfg80211_registered_device *
79c97e97 143__cfg80211_rdev_from_info(struct genl_info *info);
4bbf4d56 144
55682965
JB
145/*
146 * This function returns a pointer to the driver
147 * that the genl_info item that is passed refers to.
148 * If successful, it returns non-NULL and also locks
149 * the driver's mutex!
150 *
4d0c8aea 151 * This means that you need to call cfg80211_unlock_rdev()
a1794390 152 * before being allowed to acquire &cfg80211_mutex!
55682965
JB
153 *
154 * This is necessary because we need to lock the global
155 * mutex to get an item off the list safely, and then
79c97e97 156 * we lock the rdev mutex so it doesn't go away under us.
55682965 157 *
a1794390 158 * We don't want to keep cfg80211_mutex locked
55682965
JB
159 * for all the time in order to allow requests on
160 * other interfaces to go through at the same time.
161 *
162 * The result of this can be a PTR_ERR and hence must
163 * be checked with IS_ERR() for errors.
164 */
165extern struct cfg80211_registered_device *
166cfg80211_get_dev_from_info(struct genl_info *info);
167
79c97e97 168/* requires cfg80211_rdev_mutex to be held! */
806a9e39
LR
169struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
170
55682965
JB
171/* identical to cfg80211_get_dev_from_info but only operate on ifindex */
172extern struct cfg80211_registered_device *
463d0183
JB
173cfg80211_get_dev_from_ifindex(struct net *net, int ifindex);
174
175int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
176 struct net *net);
55682965 177
79c97e97 178static inline void cfg80211_lock_rdev(struct cfg80211_registered_device *rdev)
667503dd 179{
79c97e97 180 mutex_lock(&rdev->mtx);
667503dd
JB
181}
182
79c97e97 183static inline void cfg80211_unlock_rdev(struct cfg80211_registered_device *rdev)
4d0c8aea 184{
79c97e97
JB
185 BUG_ON(IS_ERR(rdev) || !rdev);
186 mutex_unlock(&rdev->mtx);
4d0c8aea 187}
55682965 188
667503dd
JB
189static inline void wdev_lock(struct wireless_dev *wdev)
190 __acquires(wdev)
191{
192 mutex_lock(&wdev->mtx);
193 __acquire(wdev->mtx);
194}
195
196static inline void wdev_unlock(struct wireless_dev *wdev)
197 __releases(wdev)
198{
199 __release(wdev->mtx);
200 mutex_unlock(&wdev->mtx);
201}
202
203#define ASSERT_RDEV_LOCK(rdev) WARN_ON(!mutex_is_locked(&(rdev)->mtx));
204#define ASSERT_WDEV_LOCK(wdev) WARN_ON(!mutex_is_locked(&(wdev)->mtx));
205
206enum cfg80211_event_type {
207 EVENT_CONNECT_RESULT,
208 EVENT_ROAMED,
209 EVENT_DISCONNECTED,
210 EVENT_IBSS_JOINED,
211};
212
213struct cfg80211_event {
214 struct list_head list;
215 enum cfg80211_event_type type;
216
217 union {
218 struct {
219 u8 bssid[ETH_ALEN];
220 const u8 *req_ie;
221 const u8 *resp_ie;
222 size_t req_ie_len;
223 size_t resp_ie_len;
224 u16 status;
225 } cr;
226 struct {
227 u8 bssid[ETH_ALEN];
228 const u8 *req_ie;
229 const u8 *resp_ie;
230 size_t req_ie_len;
231 size_t resp_ie_len;
232 } rm;
233 struct {
234 const u8 *ie;
235 size_t ie_len;
236 u16 reason;
237 } dc;
238 struct {
239 u8 bssid[ETH_ALEN];
240 } ij;
241 };
242};
243
fffd0934
JB
244struct cfg80211_cached_keys {
245 struct key_params params[6];
246 u8 data[6][WLAN_MAX_KEY_LEN];
247 int def, defmgmt;
248};
249
667503dd 250
704232c2 251/* free object */
79c97e97 252extern void cfg80211_dev_free(struct cfg80211_registered_device *rdev);
704232c2 253
79c97e97 254extern int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
55682965
JB
255 char *newname);
256
8318d78a 257void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
7db90f4a
LR
258void wiphy_update_regulatory(struct wiphy *wiphy,
259 enum nl80211_reg_initiator setby);
8318d78a 260
2a519311 261void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
cb3a8eec
DW
262void cfg80211_bss_age(struct cfg80211_registered_device *dev,
263 unsigned long age_secs);
2a519311 264
04a773ad 265/* IBSS */
667503dd
JB
266int __cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
267 struct net_device *dev,
fffd0934
JB
268 struct cfg80211_ibss_params *params,
269 struct cfg80211_cached_keys *connkeys);
04a773ad
JB
270int cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
271 struct net_device *dev,
fffd0934
JB
272 struct cfg80211_ibss_params *params,
273 struct cfg80211_cached_keys *connkeys);
9d308429 274void cfg80211_clear_ibss(struct net_device *dev, bool nowext);
04a773ad 275int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
9d308429 276 struct net_device *dev, bool nowext);
667503dd 277void __cfg80211_ibss_joined(struct net_device *dev, const u8 *bssid);
fffd0934
JB
278int cfg80211_ibss_wext_join(struct cfg80211_registered_device *rdev,
279 struct wireless_dev *wdev);
04a773ad 280
19957bb3 281/* MLME */
667503dd
JB
282int __cfg80211_mlme_auth(struct cfg80211_registered_device *rdev,
283 struct net_device *dev,
284 struct ieee80211_channel *chan,
285 enum nl80211_auth_type auth_type,
286 const u8 *bssid,
287 const u8 *ssid, int ssid_len,
fffd0934
JB
288 const u8 *ie, int ie_len,
289 const u8 *key, int key_len, int key_idx);
19957bb3
JB
290int cfg80211_mlme_auth(struct cfg80211_registered_device *rdev,
291 struct net_device *dev, struct ieee80211_channel *chan,
292 enum nl80211_auth_type auth_type, const u8 *bssid,
293 const u8 *ssid, int ssid_len,
fffd0934
JB
294 const u8 *ie, int ie_len,
295 const u8 *key, int key_len, int key_idx);
667503dd
JB
296int __cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
297 struct net_device *dev,
298 struct ieee80211_channel *chan,
299 const u8 *bssid, const u8 *prev_bssid,
300 const u8 *ssid, int ssid_len,
301 const u8 *ie, int ie_len, bool use_mfp,
302 struct cfg80211_crypto_settings *crypt);
19957bb3
JB
303int cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
304 struct net_device *dev, struct ieee80211_channel *chan,
3e5d7649
JB
305 const u8 *bssid, const u8 *prev_bssid,
306 const u8 *ssid, int ssid_len,
19957bb3
JB
307 const u8 *ie, int ie_len, bool use_mfp,
308 struct cfg80211_crypto_settings *crypt);
667503dd
JB
309int __cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
310 struct net_device *dev, const u8 *bssid,
311 const u8 *ie, int ie_len, u16 reason);
19957bb3
JB
312int cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
313 struct net_device *dev, const u8 *bssid,
314 const u8 *ie, int ie_len, u16 reason);
315int cfg80211_mlme_disassoc(struct cfg80211_registered_device *rdev,
316 struct net_device *dev, const u8 *bssid,
317 const u8 *ie, int ie_len, u16 reason);
318void cfg80211_mlme_down(struct cfg80211_registered_device *rdev,
319 struct net_device *dev);
667503dd
JB
320void __cfg80211_connect_result(struct net_device *dev, const u8 *bssid,
321 const u8 *req_ie, size_t req_ie_len,
322 const u8 *resp_ie, size_t resp_ie_len,
323 u16 status, bool wextev);
19957bb3 324
b23aa676 325/* SME */
667503dd
JB
326int __cfg80211_connect(struct cfg80211_registered_device *rdev,
327 struct net_device *dev,
fffd0934
JB
328 struct cfg80211_connect_params *connect,
329 struct cfg80211_cached_keys *connkeys);
b23aa676
SO
330int cfg80211_connect(struct cfg80211_registered_device *rdev,
331 struct net_device *dev,
fffd0934
JB
332 struct cfg80211_connect_params *connect,
333 struct cfg80211_cached_keys *connkeys);
667503dd
JB
334int __cfg80211_disconnect(struct cfg80211_registered_device *rdev,
335 struct net_device *dev, u16 reason,
336 bool wextev);
b23aa676 337int cfg80211_disconnect(struct cfg80211_registered_device *rdev,
f2129354
JB
338 struct net_device *dev, u16 reason,
339 bool wextev);
667503dd
JB
340void __cfg80211_roamed(struct wireless_dev *wdev, const u8 *bssid,
341 const u8 *req_ie, size_t req_ie_len,
342 const u8 *resp_ie, size_t resp_ie_len);
fffd0934
JB
343int cfg80211_mgd_wext_connect(struct cfg80211_registered_device *rdev,
344 struct wireless_dev *wdev);
b23aa676 345
6829c878
JB
346void cfg80211_conn_work(struct work_struct *work);
347
08645126 348/* internal helpers */
fffd0934
JB
349int cfg80211_validate_key_settings(struct cfg80211_registered_device *rdev,
350 struct key_params *params, int key_idx,
08645126 351 const u8 *mac_addr);
667503dd 352void __cfg80211_disconnected(struct net_device *dev, const u8 *ie,
6829c878
JB
353 size_t ie_len, u16 reason, bool from_ap);
354void cfg80211_sme_scan_done(struct net_device *dev);
355void cfg80211_sme_rx_auth(struct net_device *dev, const u8 *buf, size_t len);
19957bb3 356void cfg80211_sme_disassoc(struct net_device *dev, int idx);
667503dd 357void __cfg80211_scan_done(struct work_struct *wk);
fffd0934 358void cfg80211_upload_connect_keys(struct wireless_dev *wdev);
08645126 359
704232c2 360#endif /* __NET_WIRELESS_CORE_H */