Commit | Line | Data |
---|---|---|
b2e1b302 LR |
1 | #ifndef __NET_WIRELESS_REG_H |
2 | #define __NET_WIRELESS_REG_H | |
3b77d5ec LR |
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 | */ | |
b2e1b302 | 18 | |
458f4f9e | 19 | extern const struct ieee80211_regdomain __rcu *cfg80211_regdomain; |
f130347c | 20 | |
a3d2eaf0 | 21 | bool is_world_regdom(const char *alpha2); |
8b60b078 | 22 | bool reg_supported_dfs_region(u8 dfs_region); |
b2e1b302 | 23 | |
57b5ce07 LR |
24 | int regulatory_hint_user(const char *alpha2, |
25 | enum nl80211_user_reg_hint_type user_reg_hint_type); | |
fe33eb39 | 26 | |
4d9d88d1 | 27 | int reg_device_uevent(struct device *dev, struct kobj_uevent_env *env); |
57b5ce07 | 28 | void wiphy_regulatory_register(struct wiphy *wiphy); |
bfead080 | 29 | void wiphy_regulatory_deregister(struct wiphy *wiphy); |
3f2355cb | 30 | |
2fcc9f73 | 31 | int __init regulatory_init(void); |
b2e1b302 LR |
32 | void regulatory_exit(void); |
33 | ||
a3d2eaf0 | 34 | int set_regdom(const struct ieee80211_regdomain *rd); |
eac03e38 | 35 | |
57b5ce07 | 36 | bool reg_last_request_cell_base(void); |
b2e1b302 | 37 | |
e38f8a7a LR |
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 | |
37184244 LR |
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. | |
e38f8a7a LR |
55 | */ |
56 | int regulatory_hint_found_beacon(struct wiphy *wiphy, | |
1a919318 JB |
57 | struct ieee80211_channel *beacon_chan, |
58 | gfp_t gfp); | |
e38f8a7a | 59 | |
8b19e6ca | 60 | /** |
789fd033 | 61 | * regulatory_hint_country_ie - hints a country IE as a regulatory domain |
8b19e6ca LR |
62 | * @wiphy: the wireless device giving the hint (used only for reporting |
63 | * conflicts) | |
84920e3e LR |
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. | |
8b19e6ca LR |
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. | |
84920e3e LR |
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. | |
8b19e6ca | 80 | */ |
789fd033 | 81 | void regulatory_hint_country_ie(struct wiphy *wiphy, |
84920e3e | 82 | enum ieee80211_band band, |
9caf0364 | 83 | const u8 *country_ie, |
8b19e6ca LR |
84 | u8 country_ie_len); |
85 | ||
09d989d1 LR |
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 | ||
b2e1b302 | 104 | #endif /* __NET_WIRELESS_REG_H */ |