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/wireless.h>
15 #include <net/cfg80211.h>
18 struct cfg80211_registered_device {
19 struct cfg80211_ops *ops;
20 struct list_head list;
21 /* we hold this mutex during any call so that
22 * we cannot do multiple calls at once, and also
23 * to avoid the deregister call to proceed while
24 * any call is in progress */
27 /* ISO / IEC 3166 alpha2 for which this device is receiving
28 * country IEs on, this can help disregard country IEs from APs
29 * on the same alpha2 quickly. The alpha2 may differ from
30 * cfg80211_regdomain's alpha2 when an intersection has occurred.
31 * If the AP is reconfigured this can also be used to tell us if
32 * the country on the country IE changed. */
33 char country_ie_alpha2[2];
35 /* If a Country IE has been received this tells us the environment
36 * which its telling us its in. This defaults to ENVIRON_ANY */
37 enum environment_cap env;
39 /* wiphy index, internal only */
42 /* associate netdev list */
43 struct mutex devlist_mtx;
44 struct list_head netdev_list;
48 struct list_head bss_list;
49 struct rb_root bss_tree;
51 struct cfg80211_scan_request *scan_req; /* protected by RTNL */
52 unsigned long suspend_at;
54 /* must be last because of the way we do wiphy_priv(),
55 * and it should at least be aligned to NETDEV_ALIGN */
56 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
60 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
63 return container_of(wiphy, struct cfg80211_registered_device, wiphy);
66 /* Note 0 is valid, hence phy0 */
68 bool wiphy_idx_valid(int wiphy_idx)
70 return (wiphy_idx >= 0);
73 extern struct mutex cfg80211_mutex;
74 extern struct list_head cfg80211_drv_list;
76 #define assert_cfg80211_lock() WARN_ON(!mutex_is_locked(&cfg80211_mutex))
79 * You can use this to mark a wiphy_idx as not having an associated wiphy.
80 * It guarantees cfg80211_drv_by_wiphy_idx(wiphy_idx) will return NULL
82 #define WIPHY_IDX_STALE -1
84 struct cfg80211_internal_bss {
85 struct list_head list;
89 bool hold, ies_allocated;
91 /* must be last because of priv member */
92 struct cfg80211_bss pub;
95 struct cfg80211_registered_device *cfg80211_drv_by_wiphy_idx(int wiphy_idx);
96 int get_wiphy_idx(struct wiphy *wiphy);
98 struct cfg80211_registered_device *
99 __cfg80211_drv_from_info(struct genl_info *info);
102 * This function returns a pointer to the driver
103 * that the genl_info item that is passed refers to.
104 * If successful, it returns non-NULL and also locks
105 * the driver's mutex!
107 * This means that you need to call cfg80211_put_dev()
108 * before being allowed to acquire &cfg80211_mutex!
110 * This is necessary because we need to lock the global
111 * mutex to get an item off the list safely, and then
112 * we lock the drv mutex so it doesn't go away under us.
114 * We don't want to keep cfg80211_mutex locked
115 * for all the time in order to allow requests on
116 * other interfaces to go through at the same time.
118 * The result of this can be a PTR_ERR and hence must
119 * be checked with IS_ERR() for errors.
121 extern struct cfg80211_registered_device *
122 cfg80211_get_dev_from_info(struct genl_info *info);
124 /* requires cfg80211_drv_mutex to be held! */
125 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
127 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
128 extern struct cfg80211_registered_device *
129 cfg80211_get_dev_from_ifindex(int ifindex);
131 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv);
134 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv);
136 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv,
139 void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
140 void wiphy_update_regulatory(struct wiphy *wiphy,
141 enum nl80211_reg_initiator setby);
143 void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
144 void cfg80211_bss_age(struct cfg80211_registered_device *dev,
145 unsigned long age_secs);
148 int cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
149 struct net_device *dev,
150 struct cfg80211_ibss_params *params);
151 void cfg80211_clear_ibss(struct net_device *dev);
152 int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
153 struct net_device *dev);
155 #endif /* __NET_WIRELESS_CORE_H */