d391b50d2829ee521a855698735d86b4861602dc
[linux-3.10.git] / net / wireless / reg.h
1 #ifndef __NET_WIRELESS_REG_H
2 #define __NET_WIRELESS_REG_H
3 /*
4  * Copyright 2008-2011  Luis R. Rodriguez <mcgrof@qca.qualcomm.com>
5  *
6  * Permission to use, copy, modify, and/or distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18
19 extern const struct ieee80211_regdomain *cfg80211_regdomain;
20
21 bool is_world_regdom(const char *alpha2);
22 bool reg_supported_dfs_region(u8 dfs_region);
23
24 int regulatory_hint_user(const char *alpha2,
25                          enum nl80211_user_reg_hint_type user_reg_hint_type);
26
27 int reg_device_uevent(struct device *dev, struct kobj_uevent_env *env);
28 void wiphy_regulatory_register(struct wiphy *wiphy);
29 void wiphy_regulatory_deregister(struct wiphy *wiphy);
30
31 int __init regulatory_init(void);
32 void regulatory_exit(void);
33
34 int set_regdom(const struct ieee80211_regdomain *rd);
35
36 bool reg_last_request_cell_base(void);
37
38 /**
39  * regulatory_hint_found_beacon - hints a beacon was found on a channel
40  * @wiphy: the wireless device where the beacon was found on
41  * @beacon_chan: the channel on which the beacon was found on
42  * @gfp: context flags
43  *
44  * This informs the wireless core that a beacon from an AP was found on
45  * the channel provided. This allows the wireless core to make educated
46  * guesses on regulatory to help with world roaming. This is only used for
47  * world roaming -- when we do not know our current location. This is
48  * only useful on channels 12, 13 and 14 on the 2 GHz band as channels
49  * 1-11 are already enabled by the world regulatory domain; and on
50  * non-radar 5 GHz channels.
51  *
52  * Drivers do not need to call this, cfg80211 will do it for after a scan
53  * on a newly found BSS. If you cannot make use of this feature you can
54  * set the wiphy->disable_beacon_hints to true.
55  */
56 int regulatory_hint_found_beacon(struct wiphy *wiphy,
57                                  struct ieee80211_channel *beacon_chan,
58                                  gfp_t gfp);
59
60 /**
61  * regulatory_hint_11d - hints a country IE as a regulatory domain
62  * @wiphy: the wireless device giving the hint (used only for reporting
63  *      conflicts)
64  * @band: the band on which the country IE was received on. This determines
65  *      the band we'll process the country IE channel triplets for.
66  * @country_ie: pointer to the country IE
67  * @country_ie_len: length of the country IE
68  *
69  * We will intersect the rd with the what CRDA tells us should apply
70  * for the alpha2 this country IE belongs to, this prevents APs from
71  * sending us incorrect or outdated information against a country.
72  *
73  * The AP is expected to provide Country IE channel triplets for the
74  * band it is on. It is technically possible for APs to send channel
75  * country IE triplets even for channels outside of the band they are
76  * in but for that they would have to use the regulatory extension
77  * in combination with a triplet but this behaviour is currently
78  * not observed. For this reason if a triplet is seen with channel
79  * information for a band the BSS is not present in it will be ignored.
80  */
81 void regulatory_hint_11d(struct wiphy *wiphy,
82                          enum ieee80211_band band,
83                          const u8 *country_ie,
84                          u8 country_ie_len);
85
86 /**
87  * regulatory_hint_disconnect - informs all devices have been disconneted
88  *
89  * Regulotory rules can be enhanced further upon scanning and upon
90  * connection to an AP. These rules become stale if we disconnect
91  * and go to another country, whether or not we suspend and resume.
92  * If we suspend, go to another country and resume we'll automatically
93  * get disconnected shortly after resuming and things will be reset as well.
94  * This routine is a helper to restore regulatory settings to how they were
95  * prior to our first connect attempt. This includes ignoring country IE and
96  * beacon regulatory hints. The ieee80211_regdom module parameter will always
97  * be respected but if a user had set the regulatory domain that will take
98  * precedence.
99  *
100  * Must be called from process context.
101  */
102 void regulatory_hint_disconnect(void);
103
104 #endif  /* __NET_WIRELESS_REG_H */