cfg80211: age scan results on resume
[linux-2.6.git] / net / wireless / core.h
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 <net/genetlink.h>
14 #include <net/wireless.h>
15 #include <net/cfg80211.h>
16 #include "reg.h"
17
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 */
25         struct mutex mtx;
26
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];
34
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;
38
39         /* wiphy index, internal only */
40         int idx;
41
42         /* associate netdev list */
43         struct mutex devlist_mtx;
44         struct list_head netdev_list;
45
46         /* BSSes/scanning */
47         spinlock_t bss_lock;
48         struct list_head bss_list;
49         struct rb_root bss_tree;
50         u32 bss_generation;
51         struct cfg80211_scan_request *scan_req; /* protected by RTNL */
52         unsigned long suspend_at;
53
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)));
57 };
58
59 static inline
60 struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
61 {
62         BUG_ON(!wiphy);
63         return container_of(wiphy, struct cfg80211_registered_device, wiphy);
64 }
65
66 extern struct mutex cfg80211_drv_mutex;
67 extern struct list_head cfg80211_drv_list;
68
69 struct cfg80211_internal_bss {
70         struct list_head list;
71         struct rb_node rbn;
72         unsigned long ts;
73         struct kref ref;
74         /* must be last because of priv member */
75         struct cfg80211_bss pub;
76 };
77
78 /*
79  * This function returns a pointer to the driver
80  * that the genl_info item that is passed refers to.
81  * If successful, it returns non-NULL and also locks
82  * the driver's mutex!
83  *
84  * This means that you need to call cfg80211_put_dev()
85  * before being allowed to acquire &cfg80211_drv_mutex!
86  *
87  * This is necessary because we need to lock the global
88  * mutex to get an item off the list safely, and then
89  * we lock the drv mutex so it doesn't go away under us.
90  *
91  * We don't want to keep cfg80211_drv_mutex locked
92  * for all the time in order to allow requests on
93  * other interfaces to go through at the same time.
94  *
95  * The result of this can be a PTR_ERR and hence must
96  * be checked with IS_ERR() for errors.
97  */
98 extern struct cfg80211_registered_device *
99 cfg80211_get_dev_from_info(struct genl_info *info);
100
101 /* identical to cfg80211_get_dev_from_info but only operate on ifindex */
102 extern struct cfg80211_registered_device *
103 cfg80211_get_dev_from_ifindex(int ifindex);
104
105 extern void cfg80211_put_dev(struct cfg80211_registered_device *drv);
106
107 /* free object */
108 extern void cfg80211_dev_free(struct cfg80211_registered_device *drv);
109
110 extern int cfg80211_dev_rename(struct cfg80211_registered_device *drv,
111                                char *newname);
112
113 void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
114 void wiphy_update_regulatory(struct wiphy *wiphy, enum reg_set_by setby);
115
116 void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
117 void cfg80211_bss_age(struct cfg80211_registered_device *dev,
118                       unsigned long age_secs);
119
120 #endif /* __NET_WIRELESS_CORE_H */