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 |
Johannes Berg | 90a53e4 | 2017-09-13 22:21:08 +0200 | [diff] [blame] | 3 | |
| 4 | #include <net/cfg80211.h> |
| 5 | |
Luis R. Rodriguez | 3b77d5e | 2011-12-20 12:23:38 -0800 | [diff] [blame] | 6 | /* |
| 7 | * Copyright 2008-2011 Luis R. Rodriguez <mcgrof@qca.qualcomm.com> |
Johannes Berg | e646a02 | 2019-02-05 21:08:29 +0100 | [diff] [blame] | 8 | * Copyright (C) 2019 Intel Corporation |
Luis R. Rodriguez | 3b77d5e | 2011-12-20 12:23:38 -0800 | [diff] [blame] | 9 | * |
| 10 | * Permission to use, copy, modify, and/or distribute this software for any |
| 11 | * purpose with or without fee is hereby granted, provided that the above |
| 12 | * copyright notice and this permission notice appear in all copies. |
| 13 | * |
| 14 | * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
| 15 | * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
| 16 | * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
| 17 | * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
| 18 | * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
| 19 | * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
| 20 | * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
| 21 | */ |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 22 | |
Ilan peer | c37722b | 2015-03-30 15:15:49 +0300 | [diff] [blame] | 23 | enum ieee80211_regd_source { |
| 24 | REGD_SOURCE_INTERNAL_DB, |
| 25 | REGD_SOURCE_CRDA, |
Johannes Berg | e646a02 | 2019-02-05 21:08:29 +0100 | [diff] [blame] | 26 | REGD_SOURCE_CACHED, |
Ilan peer | c37722b | 2015-03-30 15:15:49 +0300 | [diff] [blame] | 27 | }; |
| 28 | |
Johannes Berg | 458f4f9 | 2012-12-06 15:47:38 +0100 | [diff] [blame] | 29 | extern const struct ieee80211_regdomain __rcu *cfg80211_regdomain; |
Luis R. Rodriguez | f130347 | 2009-01-30 09:26:42 -0800 | [diff] [blame] | 30 | |
Luis R. Rodriguez | e438768 | 2013-11-05 09:18:01 -0800 | [diff] [blame] | 31 | bool reg_is_valid_request(const char *alpha2); |
Johannes Berg | a3d2eaf | 2008-09-15 11:10:52 +0200 | [diff] [blame] | 32 | bool is_world_regdom(const char *alpha2); |
Luis R. Rodriguez | 4c7d398 | 2013-11-13 18:54:02 +0100 | [diff] [blame] | 33 | bool reg_supported_dfs_region(enum nl80211_dfs_regions dfs_region); |
Luis R. Rodriguez | 6c47479 | 2013-11-25 20:56:09 +0100 | [diff] [blame] | 34 | enum nl80211_dfs_regions reg_get_dfs_region(struct wiphy *wiphy); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 35 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 36 | int regulatory_hint_user(const char *alpha2, |
| 37 | enum nl80211_user_reg_hint_type user_reg_hint_type); |
Ilan peer | 0505075 | 2015-03-04 00:32:06 -0500 | [diff] [blame] | 38 | |
| 39 | /** |
| 40 | * regulatory_hint_indoor - hint operation in indoor env. or not |
| 41 | * @is_indoor: if true indicates that user space thinks that the |
| 42 | * device is operating in an indoor environment. |
| 43 | * @portid: the netlink port ID on which the hint was given. |
| 44 | */ |
| 45 | int regulatory_hint_indoor(bool is_indoor, u32 portid); |
| 46 | |
| 47 | /** |
| 48 | * regulatory_netlink_notify - notify on released netlink socket |
| 49 | * @portid: the netlink socket port ID |
| 50 | */ |
| 51 | void regulatory_netlink_notify(u32 portid); |
Luis R. Rodriguez | fe33eb3 | 2009-02-21 00:04:30 -0500 | [diff] [blame] | 52 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 53 | void wiphy_regulatory_register(struct wiphy *wiphy); |
Luis R. Rodriguez | bfead08 | 2012-07-12 11:49:19 -0700 | [diff] [blame] | 54 | void wiphy_regulatory_deregister(struct wiphy *wiphy); |
Luis R. Rodriguez | 3f2355c | 2008-11-12 14:22:02 -0800 | [diff] [blame] | 55 | |
Uwe Kleine-König | 2fcc9f7 | 2010-06-18 09:38:55 +0200 | [diff] [blame] | 56 | int __init regulatory_init(void); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 57 | void regulatory_exit(void); |
| 58 | |
Ilan peer | c37722b | 2015-03-30 15:15:49 +0300 | [diff] [blame] | 59 | int set_regdom(const struct ieee80211_regdomain *rd, |
| 60 | enum ieee80211_regd_source regd_src); |
| 61 | |
Janusz Dziedzic | 9752482 | 2014-01-30 09:52:20 +0100 | [diff] [blame] | 62 | unsigned int reg_get_max_bandwidth(const struct ieee80211_regdomain *rd, |
| 63 | const struct ieee80211_reg_rule *rule); |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 64 | |
Luis R. Rodriguez | 57b5ce0 | 2012-07-12 11:49:18 -0700 | [diff] [blame] | 65 | bool reg_last_request_cell_base(void); |
Arik Nemtsov | ad30ca2 | 2014-12-15 19:25:59 +0200 | [diff] [blame] | 66 | const struct ieee80211_regdomain *get_wiphy_regdom(struct wiphy *wiphy); |
Sven Neumann | eac03e3 | 2011-08-30 23:38:53 +0200 | [diff] [blame] | 67 | |
Johannes Berg | cf03268 | 2008-10-21 09:42:38 +0200 | [diff] [blame] | 68 | /** |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 69 | * regulatory_hint_found_beacon - hints a beacon was found on a channel |
| 70 | * @wiphy: the wireless device where the beacon was found on |
| 71 | * @beacon_chan: the channel on which the beacon was found on |
| 72 | * @gfp: context flags |
| 73 | * |
| 74 | * This informs the wireless core that a beacon from an AP was found on |
| 75 | * the channel provided. This allows the wireless core to make educated |
| 76 | * guesses on regulatory to help with world roaming. This is only used for |
| 77 | * world roaming -- when we do not know our current location. This is |
| 78 | * only useful on channels 12, 13 and 14 on the 2 GHz band as channels |
| 79 | * 1-11 are already enabled by the world regulatory domain; and on |
| 80 | * non-radar 5 GHz channels. |
| 81 | * |
| 82 | * 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] | 83 | * on a newly found BSS. If you cannot make use of this feature you can |
| 84 | * set the wiphy->disable_beacon_hints to true. |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 85 | */ |
| 86 | int regulatory_hint_found_beacon(struct wiphy *wiphy, |
Johannes Berg | 1a91931 | 2012-12-03 17:21:11 +0100 | [diff] [blame] | 87 | struct ieee80211_channel *beacon_chan, |
| 88 | gfp_t gfp); |
Luis R. Rodriguez | e38f8a7 | 2009-02-21 00:20:39 -0500 | [diff] [blame] | 89 | |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 90 | /** |
Luis R. Rodriguez | 789fd03 | 2013-10-04 18:07:24 -0700 | [diff] [blame] | 91 | * 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] | 92 | * @wiphy: the wireless device giving the hint (used only for reporting |
| 93 | * conflicts) |
Luis R. Rodriguez | 84920e3 | 2010-01-14 20:08:20 -0500 | [diff] [blame] | 94 | * @band: the band on which the country IE was received on. This determines |
| 95 | * the band we'll process the country IE channel triplets for. |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 96 | * @country_ie: pointer to the country IE |
| 97 | * @country_ie_len: length of the country IE |
| 98 | * |
| 99 | * We will intersect the rd with the what CRDA tells us should apply |
| 100 | * for the alpha2 this country IE belongs to, this prevents APs from |
| 101 | * sending us incorrect or outdated information against a country. |
Luis R. Rodriguez | 84920e3 | 2010-01-14 20:08:20 -0500 | [diff] [blame] | 102 | * |
| 103 | * The AP is expected to provide Country IE channel triplets for the |
| 104 | * band it is on. It is technically possible for APs to send channel |
| 105 | * country IE triplets even for channels outside of the band they are |
| 106 | * in but for that they would have to use the regulatory extension |
| 107 | * in combination with a triplet but this behaviour is currently |
| 108 | * not observed. For this reason if a triplet is seen with channel |
| 109 | * 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] | 110 | */ |
Luis R. Rodriguez | 789fd03 | 2013-10-04 18:07:24 -0700 | [diff] [blame] | 111 | void regulatory_hint_country_ie(struct wiphy *wiphy, |
Johannes Berg | 57fbcce | 2016-04-12 15:56:15 +0200 | [diff] [blame] | 112 | enum nl80211_band band, |
Johannes Berg | 9caf036 | 2012-11-29 01:25:20 +0100 | [diff] [blame] | 113 | const u8 *country_ie, |
Luis R. Rodriguez | 8b19e6c | 2009-07-30 17:38:09 -0700 | [diff] [blame] | 114 | u8 country_ie_len); |
| 115 | |
Luis R. Rodriguez | 09d989d | 2010-01-29 19:58:57 -0500 | [diff] [blame] | 116 | /** |
| 117 | * regulatory_hint_disconnect - informs all devices have been disconneted |
| 118 | * |
| 119 | * Regulotory rules can be enhanced further upon scanning and upon |
| 120 | * connection to an AP. These rules become stale if we disconnect |
| 121 | * and go to another country, whether or not we suspend and resume. |
| 122 | * If we suspend, go to another country and resume we'll automatically |
| 123 | * get disconnected shortly after resuming and things will be reset as well. |
| 124 | * This routine is a helper to restore regulatory settings to how they were |
| 125 | * prior to our first connect attempt. This includes ignoring country IE and |
| 126 | * beacon regulatory hints. The ieee80211_regdom module parameter will always |
| 127 | * be respected but if a user had set the regulatory domain that will take |
| 128 | * precedence. |
| 129 | * |
| 130 | * Must be called from process context. |
| 131 | */ |
| 132 | void regulatory_hint_disconnect(void); |
| 133 | |
Ilan Peer | 174e0cd | 2014-02-23 09:13:01 +0200 | [diff] [blame] | 134 | /** |
| 135 | * cfg80211_get_unii - get the U-NII band for the frequency |
| 136 | * @freq: the frequency for which we want to get the UNII band. |
| 137 | |
| 138 | * Get a value specifying the U-NII band frequency belongs to. |
| 139 | * U-NII bands are defined by the FCC in C.F.R 47 part 15. |
| 140 | * |
| 141 | * Returns -EINVAL if freq is invalid, 0 for UNII-1, 1 for UNII-2A, |
| 142 | * 2 for UNII-2B, 3 for UNII-2C and 4 for UNII-3. |
| 143 | */ |
| 144 | int cfg80211_get_unii(int freq); |
| 145 | |
Ilan Peer | c8866e5 | 2014-02-23 09:13:03 +0200 | [diff] [blame] | 146 | /** |
| 147 | * regulatory_indoor_allowed - is indoor operation allowed |
| 148 | */ |
| 149 | bool regulatory_indoor_allowed(void); |
| 150 | |
Vasanthakumar Thiagarajan | b35a51c | 2017-02-27 17:04:33 +0530 | [diff] [blame] | 151 | /* |
| 152 | * Grace period to timeout pre-CAC results on the dfs channels. This timeout |
| 153 | * value is used for Non-ETSI domain. |
| 154 | * TODO: May be make this timeout available through regdb? |
| 155 | */ |
| 156 | #define REG_PRE_CAC_EXPIRY_GRACE_MS 2000 |
| 157 | |
| 158 | /** |
Vasanthakumar Thiagarajan | 89766727 | 2017-02-27 17:04:35 +0530 | [diff] [blame] | 159 | * regulatory_propagate_dfs_state - Propagate DFS channel state to other wiphys |
| 160 | * @wiphy - wiphy on which radar is detected and the event will be propagated |
| 161 | * to other available wiphys having the same DFS domain |
| 162 | * @chandef - Channel definition of radar detected channel |
| 163 | * @dfs_state - DFS channel state to be set |
| 164 | * @event - Type of radar event which triggered this DFS state change |
| 165 | * |
| 166 | * This function should be called with rtnl lock held. |
| 167 | */ |
| 168 | void regulatory_propagate_dfs_state(struct wiphy *wiphy, |
| 169 | struct cfg80211_chan_def *chandef, |
| 170 | enum nl80211_dfs_state dfs_state, |
| 171 | enum nl80211_radar_event event); |
| 172 | |
| 173 | /** |
| 174 | * reg_dfs_domain_same - Checks if both wiphy have same DFS domain configured |
| 175 | * @wiphy1 - wiphy it's dfs_region to be checked against that of wiphy2 |
| 176 | * @wiphy2 - wiphy it's dfs_region to be checked against that of wiphy1 |
| 177 | */ |
| 178 | bool reg_dfs_domain_same(struct wiphy *wiphy1, struct wiphy *wiphy2); |
Johannes Berg | 1ea4ff3e9 | 2017-09-13 16:07:22 +0200 | [diff] [blame] | 179 | |
| 180 | /** |
| 181 | * reg_reload_regdb - reload the regulatory.db firmware file |
| 182 | */ |
| 183 | int reg_reload_regdb(void); |
| 184 | |
Johannes Berg | 90a53e4 | 2017-09-13 22:21:08 +0200 | [diff] [blame] | 185 | extern const u8 shipped_regdb_certs[]; |
| 186 | extern unsigned int shipped_regdb_certs_len; |
| 187 | extern const u8 extra_regdb_certs[]; |
| 188 | extern unsigned int extra_regdb_certs_len; |
| 189 | |
Luis R. Rodriguez | b2e1b30 | 2008-09-09 23:19:48 -0700 | [diff] [blame] | 190 | #endif /* __NET_WIRELESS_REG_H */ |