2 * Wireless configuration interface internals.
4 * Copyright 2006, 2007 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 <net/genetlink.h>
14 #include <net/cfg80211.h>
17 struct cfg80211_registered_device {
18 struct cfg80211_ops *ops;
19 struct list_head list;
20 /* we hold this mutex during any call so that
21 * we cannot do multiple calls at once, and also
22 * to avoid the deregister call to proceed while
23 * any call is in progress */
26 /* ISO / IEC 3166 alpha2 for which this device is receiving
27 * country IEs on, this can help disregard country IEs from APs
28 * on the same alpha2 quickly. The alpha2 may differ from
29 * cfg80211_regdomain's alpha2 when an intersection has occurred.
30 * If the AP is reconfigured this can also be used to tell us if
31 * the country on the country IE changed. */
32 char country_ie_alpha2[2];
34 /* If a Country IE has been received this tells us the environment
35 * which its telling us its in. This defaults to ENVIRON_ANY */
36 enum environment_cap env;
38 /* wiphy index, internal only */
41 /* associate netdev list */
42 struct mutex devlist_mtx;
43 struct list_head netdev_list;
47 struct list_head bss_list;
48 struct rb_root bss_tree;
50 struct cfg80211_scan_request *scan_req; /* protected by RTNL */
51 unsigned long suspend_at;
53 /* must be last because of the way we do wiphy_priv(),
54 * and it should at least be aligned to NETDEV_ALIGN */
55 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
59 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
62 return container_of(wiphy, struct cfg80211_registered_device, wiphy);
65 /* Note 0 is valid, hence phy0 */
67 bool wiphy_idx_valid(int wiphy_idx)
69 return (wiphy_idx >= 0);
72 extern struct mutex cfg80211_mutex;
73 extern struct list_head cfg80211_drv_list;
75 #define assert_cfg80211_lock() WARN_ON(!mutex_is_locked(&cfg80211_mutex))
78 * You can use this to mark a wiphy_idx as not having an associated wiphy.
79 * It guarantees cfg80211_drv_by_wiphy_idx(wiphy_idx) will return NULL
81 #define WIPHY_IDX_STALE -1
83 struct cfg80211_internal_bss {
84 struct list_head list;
88 bool hold, ies_allocated;
90 /* must be last because of priv member */
91 struct cfg80211_bss pub;
94 struct cfg80211_registered_device *cfg80211_drv_by_wiphy_idx(int wiphy_idx);
95 int get_wiphy_idx(struct wiphy *wiphy);
97 struct cfg80211_registered_device *
98 __cfg80211_drv_from_info(struct genl_info *info);
101 * This function returns a pointer to the driver
102 * that the genl_info item that is passed refers to.
103 * If successful, it returns non-NULL and also locks
104 * the driver's mutex!
106 * This means that you need to call cfg80211_put_dev()
107 * before being allowed to acquire &cfg80211_mutex!
109 * This is necessary because we need to lock the global
110 * mutex to get an item off the list safely, and then
111 * we lock the drv mutex so it doesn't go away under us.
113 * We don't want to keep cfg80211_mutex locked
114 * for all the time in order to allow requests on
115 * other interfaces to go through at the same time.
117 * The result of this can be a PTR_ERR and hence must
118 * be checked with IS_ERR() for errors.
120 extern struct cfg80211_registered_device *
121 cfg80211_get_dev_from_info(struct genl_info *info);
123 /* requires cfg80211_drv_mutex to be held! */
124 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
126 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
127 extern struct cfg80211_registered_device *
128 cfg80211_get_dev_from_ifindex(int ifindex);
130 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv);
133 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv);
135 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv,
138 void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
139 void wiphy_update_regulatory(struct wiphy *wiphy,
140 enum nl80211_reg_initiator setby);
142 void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
143 void cfg80211_bss_age(struct cfg80211_registered_device *dev,
144 unsigned long age_secs);
147 int cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
148 struct net_device *dev,
149 struct cfg80211_ibss_params *params);
150 void cfg80211_clear_ibss(struct net_device *dev, bool nowext);
151 int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
152 struct net_device *dev, bool nowext);
154 #endif /* __NET_WIRELESS_CORE_H */