1 /* 2 * Wireless configuration interface internals. 3 * 4 * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net> 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> 11 #include <linux/kref.h> 12 #include <linux/rbtree.h> 13 #include <linux/mutex.h> 14 #include <net/genetlink.h> 15 #include <net/wireless.h> 16 #include <net/cfg80211.h> 17 #include "reg.h" 18 19 struct cfg80211_registered_device { 20 struct cfg80211_ops *ops; 21 struct list_head list; 22 /* we hold this mutex during any call so that 23 * we cannot do multiple calls at once, and also 24 * to avoid the deregister call to proceed while 25 * any call is in progress */ 26 struct mutex mtx; 27 28 /* ISO / IEC 3166 alpha2 for which this device is receiving 29 * country IEs on, this can help disregard country IEs from APs 30 * on the same alpha2 quickly. The alpha2 may differ from 31 * cfg80211_regdomain's alpha2 when an intersection has occurred. 32 * If the AP is reconfigured this can also be used to tell us if 33 * the country on the country IE changed. */ 34 char country_ie_alpha2[2]; 35 36 /* If a Country IE has been received this tells us the environment 37 * which its telling us its in. This defaults to ENVIRON_ANY */ 38 enum environment_cap env; 39 40 /* wiphy index, internal only */ 41 int wiphy_idx; 42 43 /* associate netdev list */ 44 struct mutex devlist_mtx; 45 struct list_head netdev_list; 46 47 /* BSSes/scanning */ 48 spinlock_t bss_lock; 49 struct list_head bss_list; 50 struct rb_root bss_tree; 51 u32 bss_generation; 52 struct cfg80211_scan_request *scan_req; /* protected by RTNL */ 53 unsigned long suspend_at; 54 55 /* must be last because of the way we do wiphy_priv(), 56 * and it should at least be aligned to NETDEV_ALIGN */ 57 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN))); 58 }; 59 60 static inline 61 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy) 62 { 63 BUG_ON(!wiphy); 64 return container_of(wiphy, struct cfg80211_registered_device, wiphy); 65 } 66 67 /* Note 0 is valid, hence phy0 */ 68 static inline 69 bool wiphy_idx_valid(int wiphy_idx) 70 { 71 return (wiphy_idx >= 0); 72 } 73 74 extern struct mutex cfg80211_mutex; 75 extern struct list_head cfg80211_drv_list; 76 77 static inline void assert_cfg80211_lock(void) 78 { 79 WARN_ON(!mutex_is_locked(&cfg80211_mutex)); 80 } 81 82 /* 83 * You can use this to mark a wiphy_idx as not having an associated wiphy. 84 * It guarantees cfg80211_drv_by_wiphy_idx(wiphy_idx) will return NULL 85 */ 86 #define WIPHY_IDX_STALE -1 87 88 struct cfg80211_internal_bss { 89 struct list_head list; 90 struct rb_node rbn; 91 unsigned long ts; 92 struct kref ref; 93 bool hold, ies_allocated; 94 95 /* must be last because of priv member */ 96 struct cfg80211_bss pub; 97 }; 98 99 struct cfg80211_registered_device *cfg80211_drv_by_wiphy_idx(int wiphy_idx); 100 int get_wiphy_idx(struct wiphy *wiphy); 101 102 struct cfg80211_registered_device * 103 __cfg80211_drv_from_info(struct genl_info *info); 104 105 /* 106 * This function returns a pointer to the driver 107 * that the genl_info item that is passed refers to. 108 * If successful, it returns non-NULL and also locks 109 * the driver's mutex! 110 * 111 * This means that you need to call cfg80211_put_dev() 112 * before being allowed to acquire &cfg80211_mutex! 113 * 114 * This is necessary because we need to lock the global 115 * mutex to get an item off the list safely, and then 116 * we lock the drv mutex so it doesn't go away under us. 117 * 118 * We don't want to keep cfg80211_mutex locked 119 * for all the time in order to allow requests on 120 * other interfaces to go through at the same time. 121 * 122 * The result of this can be a PTR_ERR and hence must 123 * be checked with IS_ERR() for errors. 124 */ 125 extern struct cfg80211_registered_device * 126 cfg80211_get_dev_from_info(struct genl_info *info); 127 128 /* requires cfg80211_drv_mutex to be held! */ 129 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx); 130 131 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */ 132 extern struct cfg80211_registered_device * 133 cfg80211_get_dev_from_ifindex(int ifindex); 134 135 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv); 136 137 /* free object */ 138 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv); 139 140 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv, 141 char *newname); 142 143 void ieee80211_set_bitrate_flags(struct wiphy *wiphy); 144 void wiphy_update_regulatory(struct wiphy *wiphy, 145 enum nl80211_reg_initiator setby); 146 147 void cfg80211_bss_expire(struct cfg80211_registered_device *dev); 148 void cfg80211_bss_age(struct cfg80211_registered_device *dev, 149 unsigned long age_secs); 150 151 #endif /* __NET_WIRELESS_CORE_H */ 152