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 <net/genetlink.h> 12 #include <net/wireless.h> 13 #include <net/cfg80211.h> 14 15 struct cfg80211_registered_device { 16 struct cfg80211_ops *ops; 17 struct list_head list; 18 /* we hold this mutex during any call so that 19 * we cannot do multiple calls at once, and also 20 * to avoid the deregister call to proceed while 21 * any call is in progress */ 22 struct mutex mtx; 23 24 /* wiphy index, internal only */ 25 int idx; 26 27 /* associate netdev list */ 28 struct mutex devlist_mtx; 29 struct list_head netdev_list; 30 31 /* must be last because of the way we do wiphy_priv(), 32 * and it should at least be aligned to NETDEV_ALIGN */ 33 struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN))); 34 }; 35 36 static inline 37 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy) 38 { 39 BUG_ON(!wiphy); 40 return container_of(wiphy, struct cfg80211_registered_device, wiphy); 41 } 42 43 extern struct mutex cfg80211_drv_mutex; 44 extern struct list_head cfg80211_drv_list; 45 46 /* 47 * This function returns a pointer to the driver 48 * that the genl_info item that is passed refers to. 49 * If successful, it returns non-NULL and also locks 50 * the driver's mutex! 51 * 52 * This means that you need to call cfg80211_put_dev() 53 * before being allowed to acquire &cfg80211_drv_mutex! 54 * 55 * This is necessary because we need to lock the global 56 * mutex to get an item off the list safely, and then 57 * we lock the drv mutex so it doesn't go away under us. 58 * 59 * We don't want to keep cfg80211_drv_mutex locked 60 * for all the time in order to allow requests on 61 * other interfaces to go through at the same time. 62 * 63 * The result of this can be a PTR_ERR and hence must 64 * be checked with IS_ERR() for errors. 65 */ 66 extern struct cfg80211_registered_device * 67 cfg80211_get_dev_from_info(struct genl_info *info); 68 69 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */ 70 extern struct cfg80211_registered_device * 71 cfg80211_get_dev_from_ifindex(int ifindex); 72 73 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv); 74 75 /* free object */ 76 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv); 77 78 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv, 79 char *newname); 80 81 #endif /* __NET_WIRELESS_CORE_H */ 82