Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 1 | #ifndef __NET_WIRELESS_REG_H |
| 2 | #define __NET_WIRELESS_REG_H |
Luis R. Rodriguez | 3b77d5e | 2011-12-20 12:23:38 -0800 | [diff] [blame] | 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 | */ |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 18 | |
Johannes Berg | 458f4f9 | 2012-12-06 15:47:38 +0100 | [diff] [blame] | 19 | extern const struct ieee80211_regdomain __rcu *cfg80211_regdomain; |
Luis R. Rodriguez | f130347 | 2009-01-30 09:26:42 -0800 | [diff] [blame] | 20 | |
Luis R. Rodriguez | e438768 | 2013-11-05 09:18:01 -0800 | [diff] [blame] | 21 | bool reg_is_valid_request(const char *alpha2); |
Johannes Berg | a3d2eaf | 2008-09-15 11:10:52 +0200 | [diff] [blame] | 22 | bool is_world_regdom(const char *alpha2); |
Luis R. Rodriguez | 4c7d398 | 2013-11-13 18:54:02 +0100 | [diff] [blame] | 23 | bool reg_supported_dfs_region(enum nl80211_dfs_regions dfs_region); |
Luis R. Rodriguez | 6c47479 | 2013-11-25 20:56:09 +0100 | [diff] [blame] | 24 | enum nl80211_dfs_regions reg_get_dfs_region(struct wiphy *wiphy); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 25 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 26 | int regulatory_hint_user(const char *alpha2, |
| 27 | enum nl80211_user_reg_hint_type user_reg_hint_type); |
Ilan Peer | 52616f2 | 2014-02-25 16:26:00 +0200 | [diff] [blame] | 28 | int regulatory_hint_indoor_user(void); |
Luis R. Rodriguez | fe33eb3 | 2009-02-21 00:04:30 -0500 | [diff] [blame] | 29 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 30 | void wiphy_regulatory_register(struct wiphy *wiphy); |
Luis R. Rodriguez | bfead08 | 2012-07-12 11:49:19 -0700 | [diff] [blame] | 31 | void wiphy_regulatory_deregister(struct wiphy *wiphy); |
Luis R. Rodriguez | 3f2355c | 2008-11-12 14:22:02 -0800 | [diff] [blame] | 32 | |
Uwe Kleine-König | 2fcc9f7 | 2010-06-18 09:38:55 +0200 | [diff] [blame] | 33 | int __init regulatory_init(void); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 34 | void regulatory_exit(void); |
| 35 | |
Johannes Berg | a3d2eaf | 2008-09-15 11:10:52 +0200 | [diff] [blame] | 36 | int set_regdom(const struct ieee80211_regdomain *rd); |
Janusz Dziedzic | 9752482 | 2014-01-30 09:52:20 +0100 | [diff] [blame] | 37 | unsigned int reg_get_max_bandwidth(const struct ieee80211_regdomain *rd, |
| 38 | const struct ieee80211_reg_rule *rule); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 39 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 40 | bool reg_last_request_cell_base(void); |
Sven Neumann | eac03e3 | 2011-08-30 23:38:53 +0200 | [diff] [blame] | 41 | |
Johannes Berg | cf03268 | 2008-10-21 09:42:38 +0200 | [diff] [blame] | 42 | /** |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 43 | * regulatory_hint_found_beacon - hints a beacon was found on a channel |
| 44 | * @wiphy: the wireless device where the beacon was found on |
| 45 | * @beacon_chan: the channel on which the beacon was found on |
| 46 | * @gfp: context flags |
| 47 | * |
| 48 | * This informs the wireless core that a beacon from an AP was found on |
| 49 | * the channel provided. This allows the wireless core to make educated |
| 50 | * guesses on regulatory to help with world roaming. This is only used for |
| 51 | * world roaming -- when we do not know our current location. This is |
| 52 | * only useful on channels 12, 13 and 14 on the 2 GHz band as channels |
| 53 | * 1-11 are already enabled by the world regulatory domain; and on |
| 54 | * non-radar 5 GHz channels. |
| 55 | * |
| 56 | * Drivers do not need to call this, cfg80211 will do it for after a scan |
Luis R. Rodriguez | 3718424 | 2009-07-30 17:43:48 -0700 | [diff] [blame] | 57 | * on a newly found BSS. If you cannot make use of this feature you can |
| 58 | * set the wiphy->disable_beacon_hints to true. |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 59 | */ |
| 60 | int regulatory_hint_found_beacon(struct wiphy *wiphy, |
Johannes Berg | 1a91931 | 2012-12-03 17:21:11 +0100 | [diff] [blame] | 61 | struct ieee80211_channel *beacon_chan, |
| 62 | gfp_t gfp); |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 63 | |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 64 | /** |
Luis R. Rodriguez | 789fd03 | 2013-10-04 18:07:24 -0700 | [diff] [blame] | 65 | * regulatory_hint_country_ie - hints a country IE as a regulatory domain |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 66 | * @wiphy: the wireless device giving the hint (used only for reporting |
| 67 | * conflicts) |
Luis R. Rodriguez | 84920e3 | 2010-01-14 20:08:20 -0500 | [diff] [blame] | 68 | * @band: the band on which the country IE was received on. This determines |
| 69 | * the band we'll process the country IE channel triplets for. |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 70 | * @country_ie: pointer to the country IE |
| 71 | * @country_ie_len: length of the country IE |
| 72 | * |
| 73 | * We will intersect the rd with the what CRDA tells us should apply |
| 74 | * for the alpha2 this country IE belongs to, this prevents APs from |
| 75 | * sending us incorrect or outdated information against a country. |
Luis R. Rodriguez | 84920e3 | 2010-01-14 20:08:20 -0500 | [diff] [blame] | 76 | * |
| 77 | * The AP is expected to provide Country IE channel triplets for the |
| 78 | * band it is on. It is technically possible for APs to send channel |
| 79 | * country IE triplets even for channels outside of the band they are |
| 80 | * in but for that they would have to use the regulatory extension |
| 81 | * in combination with a triplet but this behaviour is currently |
| 82 | * not observed. For this reason if a triplet is seen with channel |
| 83 | * information for a band the BSS is not present in it will be ignored. |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 84 | */ |
Luis R. Rodriguez | 789fd03 | 2013-10-04 18:07:24 -0700 | [diff] [blame] | 85 | void regulatory_hint_country_ie(struct wiphy *wiphy, |
Luis R. Rodriguez | 84920e3 | 2010-01-14 20:08:20 -0500 | [diff] [blame] | 86 | enum ieee80211_band band, |
Johannes Berg | 9caf036 | 2012-11-29 01:25:20 +0100 | [diff] [blame] | 87 | const u8 *country_ie, |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 88 | u8 country_ie_len); |
| 89 | |
Luis R. Rodriguez | 09d989d | 2010-01-29 19:58:57 -0500 | [diff] [blame] | 90 | /** |
| 91 | * regulatory_hint_disconnect - informs all devices have been disconneted |
| 92 | * |
| 93 | * Regulotory rules can be enhanced further upon scanning and upon |
| 94 | * connection to an AP. These rules become stale if we disconnect |
| 95 | * and go to another country, whether or not we suspend and resume. |
| 96 | * If we suspend, go to another country and resume we'll automatically |
| 97 | * get disconnected shortly after resuming and things will be reset as well. |
| 98 | * This routine is a helper to restore regulatory settings to how they were |
| 99 | * prior to our first connect attempt. This includes ignoring country IE and |
| 100 | * beacon regulatory hints. The ieee80211_regdom module parameter will always |
| 101 | * be respected but if a user had set the regulatory domain that will take |
| 102 | * precedence. |
| 103 | * |
| 104 | * Must be called from process context. |
| 105 | */ |
| 106 | void regulatory_hint_disconnect(void); |
| 107 | |
Ilan Peer | 174e0cd | 2014-02-23 09:13:01 +0200 | [diff] [blame] | 108 | /** |
| 109 | * cfg80211_get_unii - get the U-NII band for the frequency |
| 110 | * @freq: the frequency for which we want to get the UNII band. |
| 111 | |
| 112 | * Get a value specifying the U-NII band frequency belongs to. |
| 113 | * U-NII bands are defined by the FCC in C.F.R 47 part 15. |
| 114 | * |
| 115 | * Returns -EINVAL if freq is invalid, 0 for UNII-1, 1 for UNII-2A, |
| 116 | * 2 for UNII-2B, 3 for UNII-2C and 4 for UNII-3. |
| 117 | */ |
| 118 | int cfg80211_get_unii(int freq); |
| 119 | |
Ilan Peer | c8866e5 | 2014-02-23 09:13:03 +0200 | [diff] [blame^] | 120 | /** |
| 121 | * regulatory_indoor_allowed - is indoor operation allowed |
| 122 | */ |
| 123 | bool regulatory_indoor_allowed(void); |
| 124 | |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 125 | #endif /* __NET_WIRELESS_REG_H */ |