18d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/*
28d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IEEE 802.11 Common routines
3a54fa5fb807eaeff45464139b5a7759f060cec68Dmitry Shmidt * Copyright (c) 2002-2012, Jouni Malinen <j@w1.fi>
48d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt *
5c5ec7f57ead87efa365800228aa0b09a12d9e6c4Dmitry Shmidt * This software may be distributed under the terms of the BSD license.
6c5ec7f57ead87efa365800228aa0b09a12d9e6c4Dmitry Shmidt * See README for more details.
78d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */
88d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
98d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef IEEE802_11_COMMON_H
108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE802_11_COMMON_H
118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
1257c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt#include "defs.h"
1357c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
14d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt#define MAX_NOF_MB_IES_SUPPORTED 5
15d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt
16d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidtstruct mb_ies_info {
17d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	struct {
18d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt		const u8 *ie;
19d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt		u8 ie_len;
20d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	} ies[MAX_NOF_MB_IES_SUPPORTED];
21d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	u8 nof_ies;
22d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt};
23d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt
248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Parsed Information Elements */
258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct ieee802_11_elems {
268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ssid;
278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *supp_rates;
288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ds_params;
298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *challenge;
308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *erp_info;
318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ext_supp_rates;
328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *wpa_ie;
338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *rsn_ie;
348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *wmm; /* WMM Information or Parameter Element */
358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *wmm_tspec;
368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *wps_ie;
378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *supp_channels;
388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *mdie;
398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ftie;
408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *timeout_int;
418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ht_capabilities;
428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *ht_operation;
436c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	const u8 *mesh_config;
446c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	const u8 *mesh_id;
456c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	const u8 *peer_mgmt;
4661d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	const u8 *vht_capabilities;
4761d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	const u8 *vht_operation;
48bd14a57187b024f49f5b9ace55ef457d8d04650aDmitry Shmidt	const u8 *vht_opmode_notif;
498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *vendor_ht_cap;
502f74e36e84064ffa32f82f3decf36b653c7e4fadDmitry Shmidt	const u8 *vendor_vht;
518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *p2p;
5261d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	const u8 *wfd;
538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	const u8 *link_id;
541f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt	const u8 *interworking;
55051af73b8f8014eff33330aead0f36944b3403e6Dmitry Shmidt	const u8 *qos_map_set;
5604949598a23f501be6eec21697465fd46a28840aDmitry Shmidt	const u8 *hs20;
5704949598a23f501be6eec21697465fd46a28840aDmitry Shmidt	const u8 *ext_capab;
5804949598a23f501be6eec21697465fd46a28840aDmitry Shmidt	const u8 *bss_max_idle_period;
59a54fa5fb807eaeff45464139b5a7759f060cec68Dmitry Shmidt	const u8 *ssid_list;
60f21452aea786ac056eb01f1cbba4f553bd502747Dmitry Shmidt	const u8 *osen;
6157c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	const u8 *mbo;
626c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	const u8 *ampe;
636c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	const u8 *mic;
64d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	const u8 *pref_freq_list;
659c17526f86859e2b6aebac0ed4f2561601816103Dmitry Shmidt	const u8 *supp_op_classes;
66849734c8d1847920ed7042463f7480b1e0c1dfeaDmitry Shmidt	const u8 *rrm_enabled;
679839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *cag_number;
689839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *ap_csn;
699839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_indic;
709839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *dils;
719839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *assoc_delay_info;
729839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_req_params;
739839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_key_confirm;
749839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_session;
759839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_hlp;
769839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_ip_addr_assign;
779839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *key_delivery;
789839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_wrapped_data;
799839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_pk;
809839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	const u8 *fils_nonce;
818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 ssid_len;
838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 supp_rates_len;
848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 challenge_len;
858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 ext_supp_rates_len;
868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 wpa_ie_len;
878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 rsn_ie_len;
888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 wmm_len; /* 7 = WMM Information; 24 = WMM Parameter */
898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 wmm_tspec_len;
908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 wps_ie_len;
918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 supp_channels_len;
928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 mdie_len;
938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 ftie_len;
946c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	u8 mesh_config_len;
956c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	u8 mesh_id_len;
966c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	u8 peer_mgmt_len;
978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 vendor_ht_cap_len;
982f74e36e84064ffa32f82f3decf36b653c7e4fadDmitry Shmidt	u8 vendor_vht_len;
998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt	u8 p2p_len;
10061d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	u8 wfd_len;
1011f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt	u8 interworking_len;
102051af73b8f8014eff33330aead0f36944b3403e6Dmitry Shmidt	u8 qos_map_set_len;
10304949598a23f501be6eec21697465fd46a28840aDmitry Shmidt	u8 hs20_len;
10404949598a23f501be6eec21697465fd46a28840aDmitry Shmidt	u8 ext_capab_len;
105a54fa5fb807eaeff45464139b5a7759f060cec68Dmitry Shmidt	u8 ssid_list_len;
106f21452aea786ac056eb01f1cbba4f553bd502747Dmitry Shmidt	u8 osen_len;
10757c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	u8 mbo_len;
1086c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	u8 ampe_len;
1096c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidt	u8 mic_len;
110d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	u8 pref_freq_list_len;
1119c17526f86859e2b6aebac0ed4f2561601816103Dmitry Shmidt	u8 supp_op_classes_len;
112849734c8d1847920ed7042463f7480b1e0c1dfeaDmitry Shmidt	u8 rrm_enabled_len;
1139839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 cag_number_len;
1149839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_indic_len;
1159839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 dils_len;
1169839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_req_params_len;
1179839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_key_confirm_len;
1189839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_hlp_len;
1199839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_ip_addr_assign_len;
1209839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 key_delivery_len;
1219839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_wrapped_data_len;
1229839ecd75c832023d4d13fd2917a8c28261ff668Dmitry Shmidt	u8 fils_pk_len;
1239c17526f86859e2b6aebac0ed4f2561601816103Dmitry Shmidt
124d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt	struct mb_ies_info mb_ies;
1258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt};
1268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
1278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidttypedef enum { ParseOK = 0, ParseUnknown = 1, ParseFailed = -1 } ParseRes;
1288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
1298d520ff1dc2da35cdca849e982051b86468016d8Dmitry ShmidtParseRes ieee802_11_parse_elems(const u8 *start, size_t len,
1308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt				struct ieee802_11_elems *elems,
1318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt				int show_errors);
1328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint ieee802_11_ie_count(const u8 *ies, size_t ies_len);
1338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpabuf * ieee802_11_vendor_ie_concat(const u8 *ies, size_t ies_len,
1348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt					    u32 oui_type);
1351f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidtstruct ieee80211_hdr;
1361f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidtconst u8 * get_hdr_bssid(const struct ieee80211_hdr *hdr, size_t len);
1378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt
13861d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidtstruct hostapd_wmm_ac_params {
13961d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	int cwmin;
14061d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	int cwmax;
14161d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	int aifs;
14261d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	int txop_limit; /* in units of 32us */
14361d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt	int admission_control_mandatory;
14461d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt};
14561d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt
14661d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidtint hostapd_config_wmm_ac(struct hostapd_wmm_ac_params wmm_ac_params[],
14761d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt			  const char *name, const char *val);
1484b06059785b935dd1f4f09314e4e12c417d2c6a4Dmitry Shmidtenum hostapd_hw_mode ieee80211_freq_to_chan(int freq, u8 *channel);
1496c0da2bb83f6915d8260912362692d1a742e057bDmitry Shmidtint ieee80211_chan_to_freq(const char *country, u8 op_class, u8 chan);
150d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidtenum hostapd_hw_mode ieee80211_freq_to_channel_ext(unsigned int freq,
151d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt						   int sec_channel, int vht,
152d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt						   u8 *op_class, u8 *channel);
153203eadb9eda41a1dde4a583edb4684319e3f399eDmitry Shmidtint ieee80211_is_dfs(int freq);
15457c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtenum phy_type ieee80211_get_phy_type(int freq, int ht, int vht);
15561d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt
15634af306c42b7ccf956508e7cd23f0ba90606e360Dmitry Shmidtint supp_rates_11b_only(struct ieee802_11_elems *elems);
157d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidtint mb_ies_info_by_ies(struct mb_ies_info *info, const u8 *ies_buf,
158d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidt		       size_t ies_len);
159d80a401aed31d06f261efd19223cf55d1a2a8228Dmitry Shmidtstruct wpabuf * mb_ies_by_info(struct mb_ies_info *info);
16034af306c42b7ccf956508e7cd23f0ba90606e360Dmitry Shmidt
1612271d3fdd5982d0e5e81cf9999a861bba933eacbDmitry Shmidtconst char * fc2str(u16 fc);
16257c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
16357c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtstruct oper_class_map {
16457c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	enum hostapd_hw_mode mode;
16557c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	u8 op_class;
16657c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	u8 min_chan;
16757c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	u8 max_chan;
16857c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	u8 inc;
16957c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	enum { BW20, BW40PLUS, BW40MINUS, BW80, BW2160, BW160, BW80P80 } bw;
17057c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt	enum { P2P_SUPP, NO_P2P_SUPP } p2p;
17157c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt};
17257c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
17357c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtextern const struct oper_class_map global_op_class[];
17457c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtextern size_t global_op_class_size;
17557c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
17657c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtconst u8 * get_ie(const u8 *ies, size_t len, u8 eid);
17757c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
17857c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidtsize_t mbo_add_ie(u8 *buf, size_t len, const u8 *attr, size_t attr_len);
17957c2d39d85825f38c5fdac9b73bb0088406ffc85Dmitry Shmidt
180293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidtstruct country_op_class {
181293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt	u8 country_op_class;
182293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt	u8 global_op_class;
183293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt};
184293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt
185293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidtu8 country_to_global_op_class(const char *country, u8 op_class);
186293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt
187293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidtconst struct oper_class_map * get_oper_class(const char *country, u8 op_class);
188293335998d38c497293b1c41f7ad8342b507d458Dmitry Shmidt
1898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* IEEE802_11_COMMON_H */
190