1 /*
2  * IEEE 802.11 Common routines
3  * Copyright (c) 2002-2019, Jouni Malinen <j@w1.fi>
4  *
5  * This software may be distributed under the terms of the BSD license.
6  * See README for more details.
7  */
8 
9 #ifndef IEEE802_11_COMMON_H
10 #define IEEE802_11_COMMON_H
11 
12 #include "defs.h"
13 #include "ieee802_11_defs.h"
14 
15 struct element {
16 	u8 id;
17 	u8 datalen;
18 	u8 data[];
19 } STRUCT_PACKED;
20 
21 struct hostapd_hw_modes;
22 
23 #define MAX_NOF_MB_IES_SUPPORTED 5
24 #define MAX_NUM_FRAG_IES_SUPPORTED 3
25 
26 struct mb_ies_info {
27 	struct {
28 		const u8 *ie;
29 		u8 ie_len;
30 	} ies[MAX_NOF_MB_IES_SUPPORTED];
31 	u8 nof_ies;
32 };
33 
34 struct frag_ies_info {
35 	struct {
36 		u8 eid;
37 		u8 eid_ext;
38 		const u8 *ie;
39 		u8 ie_len;
40 	} frags[MAX_NUM_FRAG_IES_SUPPORTED];
41 
42 	u8 n_frags;
43 
44 	/* the last parsed element ID and element extension ID */
45 	u8 last_eid;
46 	u8 last_eid_ext;
47 };
48 
49 /* Parsed Information Elements */
50 struct ieee802_11_elems {
51 	const u8 *ssid;
52 	const u8 *supp_rates;
53 	const u8 *ds_params;
54 	const u8 *challenge;
55 	const u8 *erp_info;
56 	const u8 *ext_supp_rates;
57 	const u8 *wpa_ie;
58 	const u8 *rsn_ie;
59 	const u8 *rsnxe;
60 	const u8 *wmm; /* WMM Information or Parameter Element */
61 	const u8 *wmm_tspec;
62 	const u8 *wps_ie;
63 	const u8 *supp_channels;
64 	const u8 *mdie;
65 	const u8 *ftie;
66 	const u8 *timeout_int;
67 	const u8 *ht_capabilities;
68 	const u8 *ht_operation;
69 	const u8 *mesh_config;
70 	const u8 *mesh_id;
71 	const u8 *peer_mgmt;
72 	const u8 *vht_capabilities;
73 	const u8 *vht_operation;
74 	const u8 *vht_opmode_notif;
75 	const u8 *vendor_ht_cap;
76 	const u8 *vendor_vht;
77 	const u8 *p2p;
78 	const u8 *wfd;
79 	const u8 *link_id;
80 	const u8 *interworking;
81 	const u8 *qos_map_set;
82 	const u8 *hs20;
83 	const u8 *ext_capab;
84 	const u8 *bss_max_idle_period;
85 	const u8 *ssid_list;
86 	const u8 *osen;
87 	const u8 *mbo;
88 	const u8 *ampe;
89 	const u8 *mic;
90 	const u8 *pref_freq_list;
91 	const u8 *supp_op_classes;
92 	const u8 *rrm_enabled;
93 	const u8 *cag_number;
94 	const u8 *ap_csn;
95 	const u8 *fils_indic;
96 	const u8 *dils;
97 	const u8 *assoc_delay_info;
98 	const u8 *fils_req_params;
99 	const u8 *fils_key_confirm;
100 	const u8 *fils_session;
101 	const u8 *fils_hlp;
102 	const u8 *fils_ip_addr_assign;
103 	const u8 *key_delivery;
104 	const u8 *wrapped_data;
105 	const u8 *fils_pk;
106 	const u8 *fils_nonce;
107 	const u8 *owe_dh;
108 	const u8 *power_capab;
109 	const u8 *roaming_cons_sel;
110 	const u8 *password_id;
111 	const u8 *oci;
112 	const u8 *multi_ap;
113 	const u8 *he_capabilities;
114 	const u8 *he_operation;
115 	const u8 *short_ssid_list;
116 	const u8 *he_6ghz_band_cap;
117 	const u8 *sae_pk;
118 	const u8 *s1g_capab;
119 	const u8 *pasn_params;
120 
121 	u8 ssid_len;
122 	u8 supp_rates_len;
123 	u8 challenge_len;
124 	u8 ext_supp_rates_len;
125 	u8 wpa_ie_len;
126 	u8 rsn_ie_len;
127 	u8 rsnxe_len;
128 	u8 wmm_len; /* 7 = WMM Information; 24 = WMM Parameter */
129 	u8 wmm_tspec_len;
130 	u8 wps_ie_len;
131 	u8 supp_channels_len;
132 	u8 mdie_len;
133 	u8 ftie_len;
134 	u8 mesh_config_len;
135 	u8 mesh_id_len;
136 	u8 peer_mgmt_len;
137 	u8 vendor_ht_cap_len;
138 	u8 vendor_vht_len;
139 	u8 p2p_len;
140 	u8 wfd_len;
141 	u8 interworking_len;
142 	u8 qos_map_set_len;
143 	u8 hs20_len;
144 	u8 ext_capab_len;
145 	u8 ssid_list_len;
146 	u8 osen_len;
147 	u8 mbo_len;
148 	u8 ampe_len;
149 	u8 mic_len;
150 	u8 pref_freq_list_len;
151 	u8 supp_op_classes_len;
152 	u8 rrm_enabled_len;
153 	u8 cag_number_len;
154 	u8 fils_indic_len;
155 	u8 dils_len;
156 	u8 fils_req_params_len;
157 	u8 fils_key_confirm_len;
158 	u8 fils_hlp_len;
159 	u8 fils_ip_addr_assign_len;
160 	u8 key_delivery_len;
161 	u8 wrapped_data_len;
162 	u8 fils_pk_len;
163 	u8 owe_dh_len;
164 	u8 power_capab_len;
165 	u8 roaming_cons_sel_len;
166 	u8 password_id_len;
167 	u8 oci_len;
168 	u8 multi_ap_len;
169 	u8 he_capabilities_len;
170 	u8 he_operation_len;
171 	u8 short_ssid_list_len;
172 	u8 sae_pk_len;
173 	u8 pasn_params_len;
174 
175 	struct mb_ies_info mb_ies;
176 	struct frag_ies_info frag_ies;
177 };
178 
179 typedef enum { ParseOK = 0, ParseUnknown = 1, ParseFailed = -1 } ParseRes;
180 
181 ParseRes ieee802_11_parse_elems(const u8 *start, size_t len,
182 				struct ieee802_11_elems *elems,
183 				int show_errors);
184 int ieee802_11_ie_count(const u8 *ies, size_t ies_len);
185 struct wpabuf * ieee802_11_vendor_ie_concat(const u8 *ies, size_t ies_len,
186 					    u32 oui_type);
187 struct ieee80211_hdr;
188 const u8 * get_hdr_bssid(const struct ieee80211_hdr *hdr, size_t len);
189 
190 struct hostapd_wmm_ac_params {
191 	int cwmin;
192 	int cwmax;
193 	int aifs;
194 	int txop_limit; /* in units of 32us */
195 	int admission_control_mandatory;
196 };
197 
198 int hostapd_config_wmm_ac(struct hostapd_wmm_ac_params wmm_ac_params[],
199 			  const char *name, const char *val);
200 
201 struct hostapd_tx_queue_params {
202 	int aifs;
203 	int cwmin;
204 	int cwmax;
205 	int burst; /* maximum burst time in 0.1 ms, i.e., 10 = 1 ms */
206 };
207 
208 #define NUM_TX_QUEUES 4
209 
210 int hostapd_config_tx_queue(struct hostapd_tx_queue_params queue[],
211 			    const char *name, const char *val);
212 enum hostapd_hw_mode ieee80211_freq_to_chan(int freq, u8 *channel);
213 int ieee80211_chan_to_freq(const char *country, u8 op_class, u8 chan);
214 enum hostapd_hw_mode ieee80211_freq_to_channel_ext(unsigned int freq,
215 						   int sec_channel, int vht,
216 						   u8 *op_class, u8 *channel);
217 int ieee80211_chaninfo_to_channel(unsigned int freq, enum chan_width chanwidth,
218 				  int sec_channel, u8 *op_class, u8 *channel);
219 int ieee80211_is_dfs(int freq, const struct hostapd_hw_modes *modes,
220 		     u16 num_modes);
221 int is_dfs_global_op_class(u8 op_class);
222 enum phy_type ieee80211_get_phy_type(int freq, int ht, int vht);
223 
224 int supp_rates_11b_only(struct ieee802_11_elems *elems);
225 int mb_ies_info_by_ies(struct mb_ies_info *info, const u8 *ies_buf,
226 		       size_t ies_len);
227 struct wpabuf * mb_ies_by_info(struct mb_ies_info *info);
228 
229 const char * fc2str(u16 fc);
230 const char * reason2str(u16 reason);
231 const char * status2str(u16 status);
232 
233 struct oper_class_map {
234 	enum hostapd_hw_mode mode;
235 	u8 op_class;
236 	u8 min_chan;
237 	u8 max_chan;
238 	u8 inc;
239 	enum { BW20, BW40PLUS, BW40MINUS, BW40, BW80, BW2160, BW160, BW80P80,
240 	       BW4320, BW6480, BW8640} bw;
241 	enum { P2P_SUPP, NO_P2P_SUPP } p2p;
242 };
243 
244 extern const struct oper_class_map global_op_class[];
245 extern size_t global_op_class_size;
246 
247 const u8 * get_ie(const u8 *ies, size_t len, u8 eid);
248 const u8 * get_ie_ext(const u8 *ies, size_t len, u8 ext);
249 const u8 * get_vendor_ie(const u8 *ies, size_t len, u32 vendor_type);
250 
251 size_t mbo_add_ie(u8 *buf, size_t len, const u8 *attr, size_t attr_len);
252 
253 size_t add_multi_ap_ie(u8 *buf, size_t len, u8 value);
254 
255 struct country_op_class {
256 	u8 country_op_class;
257 	u8 global_op_class;
258 };
259 
260 u8 country_to_global_op_class(const char *country, u8 op_class);
261 
262 const struct oper_class_map * get_oper_class(const char *country, u8 op_class);
263 int oper_class_bw_to_int(const struct oper_class_map *map);
264 int center_idx_to_bw_6ghz(u8 idx);
265 bool is_6ghz_freq(int freq);
266 bool is_6ghz_op_class(u8 op_class);
267 bool is_6ghz_psc_frequency(int freq);
268 int get_6ghz_sec_channel(int channel);
269 
270 int ieee802_11_parse_candidate_list(const char *pos, u8 *nei_rep,
271 				    size_t nei_rep_len);
272 
273 int ieee802_11_ext_capab(const u8 *ie, unsigned int capab);
274 bool ieee802_11_rsnx_capab_len(const u8 *rsnxe, size_t rsnxe_len,
275 			       unsigned int capab);
276 bool ieee802_11_rsnx_capab(const u8 *rsnxe, unsigned int capab);
277 int op_class_to_bandwidth(u8 op_class);
278 int op_class_to_ch_width(u8 op_class);
279 
280 /* element iteration helpers */
281 #define for_each_element(_elem, _data, _datalen)			\
282 	for (_elem = (const struct element *) (_data);			\
283 	     (const u8 *) (_data) + (_datalen) - (const u8 *) _elem >=	\
284 		(int) sizeof(*_elem) &&					\
285 	     (const u8 *) (_data) + (_datalen) - (const u8 *) _elem >=	\
286 		(int) sizeof(*_elem) + _elem->datalen;			\
287 	     _elem = (const struct element *) (_elem->data + _elem->datalen))
288 
289 #define for_each_element_id(element, _id, data, datalen)		\
290 	for_each_element(element, data, datalen)			\
291 		if (element->id == (_id))
292 
293 #define for_each_element_extid(element, extid, _data, _datalen)		\
294 	for_each_element(element, _data, _datalen)			\
295 		if (element->id == WLAN_EID_EXTENSION &&		\
296 		    element->datalen > 0 &&				\
297 		    element->data[0] == (extid))
298 
299 #define for_each_subelement(sub, element)				\
300 	for_each_element(sub, (element)->data, (element)->datalen)
301 
302 #define for_each_subelement_id(sub, id, element)			\
303 	for_each_element_id(sub, id, (element)->data, (element)->datalen)
304 
305 #define for_each_subelement_extid(sub, extid, element)			\
306 	for_each_element_extid(sub, extid, (element)->data, (element)->datalen)
307 
308 /**
309  * for_each_element_completed - Determine if element parsing consumed all data
310  * @element: Element pointer after for_each_element() or friends
311  * @data: Same data pointer as passed to for_each_element() or friends
312  * @datalen: Same data length as passed to for_each_element() or friends
313  *
314  * This function returns 1 if all the data was parsed or considered
315  * while walking the elements. Only use this if your for_each_element()
316  * loop cannot be broken out of, otherwise it always returns 0.
317  *
318  * If some data was malformed, this returns %false since the last parsed
319  * element will not fill the whole remaining data.
320  */
for_each_element_completed(const struct element * element,const void * data,size_t datalen)321 static inline int for_each_element_completed(const struct element *element,
322 					     const void *data, size_t datalen)
323 {
324 	return (const u8 *) element == (const u8 *) data + datalen;
325 }
326 
327 struct ieee80211_edmg_config;
328 
329 void hostapd_encode_edmg_chan(int edmg_enable, u8 edmg_channel,
330 			      int primary_channel,
331 			      struct ieee80211_edmg_config *edmg);
332 
333 int ieee802_edmg_is_allowed(struct ieee80211_edmg_config allowed,
334 			    struct ieee80211_edmg_config requested);
335 
336 struct wpabuf * ieee802_11_defrag_data(struct ieee802_11_elems *elems,
337 				       u8 eid, u8 eid_ext,
338 				       const u8 *data, u8 len);
339 struct wpabuf * ieee802_11_defrag(struct ieee802_11_elems *elems,
340 				  u8 eid, u8 eid_ext);
341 
342 #endif /* IEEE802_11_COMMON_H */
343