| 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 __rcu *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 */ |