blob: abf48ab686c698cd646c2d423e022711239737de [file] [log] [blame]
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -07001/*
2 * hostapd / IEEE 802.11 Management
3 * Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>
4 *
Dmitry Shmidtc5ec7f52012-03-06 16:33:24 -08005 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -07007 */
8
9#ifndef IEEE802_11_H
10#define IEEE802_11_H
11
12struct hostapd_iface;
13struct hostapd_data;
14struct sta_info;
15struct hostapd_frame_info;
16struct ieee80211_ht_capabilities;
Dmitry Shmidt9d9e6022015-04-23 10:34:55 -070017struct ieee80211_vht_capabilities;
Dmitry Shmidt7832adb2014-04-29 10:53:02 -070018struct ieee80211_mgmt;
Hai Shalomfdcde762020-04-02 11:19:20 -070019struct radius_sta;
Hai Shalom81f62d82019-07-22 12:10:00 -070020enum ieee80211_op_mode;
Sunil Ravi036cec52023-03-29 11:35:17 -070021enum oper_chan_width;
Sunil Ravi2a14cf12023-11-21 00:54:38 +000022struct ieee802_11_elems;
23struct sae_pk;
24struct sae_pt;
25struct sae_password_entry;
Sunil Ravib0ac25f2024-07-12 01:42:03 +000026struct mld_info;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070027
Dmitry Shmidtfb79edc2014-01-10 10:45:54 -080028int ieee802_11_mgmt(struct hostapd_data *hapd, const u8 *buf, size_t len,
29 struct hostapd_frame_info *fi);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070030void ieee802_11_mgmt_cb(struct hostapd_data *hapd, const u8 *buf, size_t len,
31 u16 stype, int ok);
Dmitry Shmidt7832adb2014-04-29 10:53:02 -070032void hostapd_2040_coex_action(struct hostapd_data *hapd,
33 const struct ieee80211_mgmt *mgmt, size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070034#ifdef NEED_AP_MLME
35int ieee802_11_get_mib(struct hostapd_data *hapd, char *buf, size_t buflen);
36int ieee802_11_get_mib_sta(struct hostapd_data *hapd, struct sta_info *sta,
37 char *buf, size_t buflen);
38#else /* NEED_AP_MLME */
39static inline int ieee802_11_get_mib(struct hostapd_data *hapd, char *buf,
40 size_t buflen)
41{
42 return 0;
43}
44
45static inline int ieee802_11_get_mib_sta(struct hostapd_data *hapd,
46 struct sta_info *sta,
47 char *buf, size_t buflen)
48{
49 return 0;
50}
51#endif /* NEED_AP_MLME */
Dmitry Shmidt9d9e6022015-04-23 10:34:55 -070052u16 hostapd_own_capab_info(struct hostapd_data *hapd);
Dmitry Shmidt7832adb2014-04-29 10:53:02 -070053void ap_ht2040_timeout(void *eloop_data, void *user_data);
Sunil Ravi77d572f2023-01-17 23:58:31 +000054u8 * hostapd_eid_ext_capab(struct hostapd_data *hapd, u8 *eid,
55 bool mbssid_complete);
Dmitry Shmidt051af732013-10-22 13:52:46 -070056u8 * hostapd_eid_qos_map_set(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070057u8 * hostapd_eid_supp_rates(struct hostapd_data *hapd, u8 *eid);
58u8 * hostapd_eid_ext_supp_rates(struct hostapd_data *hapd, u8 *eid);
Hai Shalomfdcde762020-04-02 11:19:20 -070059u8 * hostapd_eid_rm_enabled_capab(struct hostapd_data *hapd, u8 *eid,
60 size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070061u8 * hostapd_eid_ht_capabilities(struct hostapd_data *hapd, u8 *eid);
62u8 * hostapd_eid_ht_operation(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidt7d175302016-09-06 13:11:34 -070063u8 * hostapd_eid_vht_capabilities(struct hostapd_data *hapd, u8 *eid, u32 nsts);
Dmitry Shmidt04949592012-07-19 12:16:46 -070064u8 * hostapd_eid_vht_operation(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidt2f74e362015-01-21 13:19:05 -080065u8 * hostapd_eid_vendor_vht(struct hostapd_data *hapd, u8 *eid);
Sunil Ravic0f5d412024-09-11 22:12:49 +000066u8 * hostapd_eid_chsw_wrapper(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidtd7ff03d2015-12-04 14:49:35 -080067u8 * hostapd_eid_txpower_envelope(struct hostapd_data *hapd, u8 *eid);
Hai Shalom81f62d82019-07-22 12:10:00 -070068u8 * hostapd_eid_he_capab(struct hostapd_data *hapd, u8 *eid,
69 enum ieee80211_op_mode opmode);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -070070u8 * hostapd_eid_he_operation(struct hostapd_data *hapd, u8 *eid);
Hai Shalom74f70d42019-02-11 14:42:39 -080071u8 * hostapd_eid_he_mu_edca_parameter_set(struct hostapd_data *hapd, u8 *eid);
Hai Shalom81f62d82019-07-22 12:10:00 -070072u8 * hostapd_eid_spatial_reuse(struct hostapd_data *hapd, u8 *eid);
Hai Shalom4fbc08f2020-05-18 12:37:00 -070073u8 * hostapd_eid_he_6ghz_band_cap(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidtd80a4012015-11-05 16:35:40 -080074
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070075int hostapd_ht_operation_update(struct hostapd_iface *iface);
76void ieee802_11_send_sa_query_req(struct hostapd_data *hapd,
77 const u8 *addr, const u8 *trans_id);
78void hostapd_get_ht_capab(struct hostapd_data *hapd,
79 struct ieee80211_ht_capabilities *ht_cap,
80 struct ieee80211_ht_capabilities *neg_ht_cap);
Dmitry Shmidta54fa5f2013-01-15 13:53:35 -080081void hostapd_get_vht_capab(struct hostapd_data *hapd,
82 struct ieee80211_vht_capabilities *vht_cap,
83 struct ieee80211_vht_capabilities *neg_vht_cap);
Hai Shalom81f62d82019-07-22 12:10:00 -070084void hostapd_get_he_capab(struct hostapd_data *hapd,
85 const struct ieee80211_he_capabilities *he_cap,
86 struct ieee80211_he_capabilities *neg_he_cap,
87 size_t he_capab_len);
Sunil Ravia04bd252022-05-02 22:54:18 -070088void hostapd_get_eht_capab(struct hostapd_data *hapd,
89 const struct ieee80211_eht_capabilities *src,
90 struct ieee80211_eht_capabilities *dest,
91 size_t len);
Sunil Ravib0ac25f2024-07-12 01:42:03 +000092u8 * hostapd_eid_eht_ml_beacon(struct hostapd_data *hapd,
93 struct mld_info *mld_info,
94 u8 *eid, bool include_mld_id);
95u8 * hostapd_eid_eht_ml_assoc(struct hostapd_data *hapd, struct sta_info *info,
96 u8 *eid);
97size_t hostapd_eid_eht_ml_beacon_len(struct hostapd_data *hapd,
98 struct mld_info *info,
99 bool include_mld_id);
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000100struct wpabuf * hostapd_ml_auth_resp(struct hostapd_data *hapd);
101const u8 * hostapd_process_ml_auth(struct hostapd_data *hapd,
102 const struct ieee80211_mgmt *mgmt,
103 size_t len);
104u16 hostapd_process_ml_assoc_req(struct hostapd_data *hapd,
105 struct ieee802_11_elems *elems,
106 struct sta_info *sta);
Sunil Ravib0ac25f2024-07-12 01:42:03 +0000107int hostapd_process_ml_assoc_req_addr(struct hostapd_data *hapd,
108 const u8 *basic_mle, size_t basic_mle_len,
109 u8 *mld_addr);
Dmitry Shmidtd80a4012015-11-05 16:35:40 -0800110int hostapd_get_aid(struct hostapd_data *hapd, struct sta_info *sta);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700111u16 copy_sta_ht_capab(struct hostapd_data *hapd, struct sta_info *sta,
Dmitry Shmidt9d9e6022015-04-23 10:34:55 -0700112 const u8 *ht_capab);
Dmitry Shmidt2f74e362015-01-21 13:19:05 -0800113u16 copy_sta_vendor_vht(struct hostapd_data *hapd, struct sta_info *sta,
114 const u8 *ie, size_t len);
115
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000116int update_ht_state(struct hostapd_data *hapd, struct sta_info *sta);
Dmitry Shmidt7832adb2014-04-29 10:53:02 -0700117void ht40_intolerant_add(struct hostapd_iface *iface, struct sta_info *sta);
118void ht40_intolerant_remove(struct hostapd_iface *iface, struct sta_info *sta);
Dmitry Shmidt61d9df32012-08-29 16:22:06 -0700119u16 copy_sta_vht_capab(struct hostapd_data *hapd, struct sta_info *sta,
Dmitry Shmidt9d9e6022015-04-23 10:34:55 -0700120 const u8 *vht_capab);
Hai Shalom74f70d42019-02-11 14:42:39 -0800121u16 copy_sta_vht_oper(struct hostapd_data *hapd, struct sta_info *sta,
122 const u8 *vht_oper);
Dmitry Shmidtbd14a572014-02-18 10:33:49 -0800123u16 set_sta_vht_opmode(struct hostapd_data *hapd, struct sta_info *sta,
124 const u8 *vht_opmode);
Hai Shalom81f62d82019-07-22 12:10:00 -0700125u16 copy_sta_he_capab(struct hostapd_data *hapd, struct sta_info *sta,
126 enum ieee80211_op_mode opmode, const u8 *he_capab,
127 size_t he_capab_len);
Hai Shalom4fbc08f2020-05-18 12:37:00 -0700128u16 copy_sta_he_6ghz_capab(struct hostapd_data *hapd, struct sta_info *sta,
129 const u8 *he_6ghz_capab);
Hai Shalomfdcde762020-04-02 11:19:20 -0700130int hostapd_get_he_twt_responder(struct hostapd_data *hapd,
131 enum ieee80211_op_mode mode);
Sunil Ravi7f769292024-07-23 22:21:32 +0000132bool hostapd_get_ht_vht_twt_responder(struct hostapd_data *hapd);
Sunil Ravia04bd252022-05-02 22:54:18 -0700133u8 * hostapd_eid_cca(struct hostapd_data *hapd, u8 *eid);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700134void hostapd_tx_status(struct hostapd_data *hapd, const u8 *addr,
135 const u8 *buf, size_t len, int ack);
136void ieee802_11_rx_from_unknown(struct hostapd_data *hapd, const u8 *src,
137 int wds);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800138u8 * hostapd_eid_assoc_comeback_time(struct hostapd_data *hapd,
139 struct sta_info *sta, u8 *eid);
140void ieee802_11_sa_query_action(struct hostapd_data *hapd,
Hai Shalom74f70d42019-02-11 14:42:39 -0800141 const struct ieee80211_mgmt *mgmt,
142 size_t len);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800143u8 * hostapd_eid_interworking(struct hostapd_data *hapd, u8 *eid);
144u8 * hostapd_eid_adv_proto(struct hostapd_data *hapd, u8 *eid);
145u8 * hostapd_eid_roaming_consortium(struct hostapd_data *hapd, u8 *eid);
146u8 * hostapd_eid_time_adv(struct hostapd_data *hapd, u8 *eid);
147u8 * hostapd_eid_time_zone(struct hostapd_data *hapd, u8 *eid);
148int hostapd_update_time_adv(struct hostapd_data *hapd);
149void hostapd_client_poll_ok(struct hostapd_data *hapd, const u8 *addr);
Sunil Ravi7f769292024-07-23 22:21:32 +0000150u8 * hostapd_eid_bss_max_idle_period(struct hostapd_data *hapd, u8 *eid,
151 u16 value);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700152
Dmitry Shmidtff787d52015-01-12 13:01:47 -0800153int auth_sae_init_committed(struct hostapd_data *hapd, struct sta_info *sta);
154#ifdef CONFIG_SAE
155void sae_clear_retransmit_timer(struct hostapd_data *hapd,
156 struct sta_info *sta);
Dmitry Shmidte4663042016-04-04 10:07:49 -0700157void sae_accept_sta(struct hostapd_data *hapd, struct sta_info *sta);
Dmitry Shmidtff787d52015-01-12 13:01:47 -0800158#else /* CONFIG_SAE */
159static inline void sae_clear_retransmit_timer(struct hostapd_data *hapd,
160 struct sta_info *sta)
161{
162}
163#endif /* CONFIG_SAE */
164
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800165#ifdef CONFIG_MBO
166
167u8 * hostapd_eid_mbo(struct hostapd_data *hapd, u8 *eid, size_t len);
168
169u8 hostapd_mbo_ie_len(struct hostapd_data *hapd);
170
Hai Shalom74f70d42019-02-11 14:42:39 -0800171u8 * hostapd_eid_mbo_rssi_assoc_rej(struct hostapd_data *hapd, u8 *eid,
172 size_t len, int delta);
173
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800174#else /* CONFIG_MBO */
175
176static inline u8 * hostapd_eid_mbo(struct hostapd_data *hapd, u8 *eid,
177 size_t len)
178{
179 return eid;
180}
181
182static inline u8 hostapd_mbo_ie_len(struct hostapd_data *hapd)
183{
184 return 0;
185}
186
187#endif /* CONFIG_MBO */
188
Dmitry Shmidt9c175262016-03-03 10:20:07 -0800189void ap_copy_sta_supp_op_classes(struct sta_info *sta,
190 const u8 *supp_op_classes,
191 size_t supp_op_classes_len);
192
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800193u8 * hostapd_eid_fils_indic(struct hostapd_data *hapd, u8 *eid, int hessid);
194void ieee802_11_finish_fils_auth(struct hostapd_data *hapd,
195 struct sta_info *sta, int success,
196 struct wpabuf *erp_resp,
197 const u8 *msk, size_t msk_len);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700198u8 * owe_assoc_req_process(struct hostapd_data *hapd, struct sta_info *sta,
199 const u8 *owe_dh, u8 owe_dh_len,
Hai Shalomfdcde762020-04-02 11:19:20 -0700200 u8 *owe_buf, size_t owe_buf_len, u16 *status);
Hai Shalom81f62d82019-07-22 12:10:00 -0700201u16 owe_process_rsn_ie(struct hostapd_data *hapd, struct sta_info *sta,
202 const u8 *rsn_ie, size_t rsn_ie_len,
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000203 const u8 *owe_dh, size_t owe_dh_len,
204 const u8 *link_addr);
Hai Shalom81f62d82019-07-22 12:10:00 -0700205u16 owe_validate_request(struct hostapd_data *hapd, const u8 *peer,
206 const u8 *rsn_ie, size_t rsn_ie_len,
207 const u8 *owe_dh, size_t owe_dh_len);
Dmitry Shmidtebd93af2017-02-21 13:40:44 -0800208void fils_hlp_timeout(void *eloop_ctx, void *eloop_data);
209void fils_hlp_finish_assoc(struct hostapd_data *hapd, struct sta_info *sta);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700210void handle_auth_fils(struct hostapd_data *hapd, struct sta_info *sta,
211 const u8 *pos, size_t len, u16 auth_alg,
212 u16 auth_transaction, u16 status_code,
213 void (*cb)(struct hostapd_data *hapd,
214 struct sta_info *sta,
215 u16 resp, struct wpabuf *data, int pub));
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800216
Roshan Pius3a1667e2018-07-03 15:17:14 -0700217size_t hostapd_eid_owe_trans_len(struct hostapd_data *hapd);
218u8 * hostapd_eid_owe_trans(struct hostapd_data *hapd, u8 *eid, size_t len);
Hai Shalomfdcde762020-04-02 11:19:20 -0700219
220size_t hostapd_eid_dpp_cc_len(struct hostapd_data *hapd);
221u8 * hostapd_eid_dpp_cc(struct hostapd_data *hapd, u8 *eid, size_t len);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700222
Hai Shalom74f70d42019-02-11 14:42:39 -0800223int get_tx_parameters(struct sta_info *sta, int ap_max_chanwidth,
224 int ap_seg1_idx, int *bandwidth, int *seg1_idx);
225
Hai Shalom021b0b52019-04-10 11:17:58 -0700226void auth_sae_process_commit(void *eloop_ctx, void *user_ctx);
Hai Shalomc3565922019-10-28 11:58:20 -0700227u8 * hostapd_eid_rsnxe(struct hostapd_data *hapd, u8 *eid, size_t len);
Sunil Ravia04bd252022-05-02 22:54:18 -0700228u16 check_ext_capab(struct hostapd_data *hapd, struct sta_info *sta,
229 const u8 *ext_capab_ie, size_t ext_capab_ie_len);
Sunil Ravi7f769292024-07-23 22:21:32 +0000230size_t hostapd_eid_rnr_len(struct hostapd_data *hapd, u32 type,
231 bool include_mld_params);
232u8 * hostapd_eid_rnr(struct hostapd_data *hapd, u8 *eid, u32 type,
233 bool include_mld_params);
Sunil Ravia04bd252022-05-02 22:54:18 -0700234int ieee802_11_set_radius_info(struct hostapd_data *hapd, struct sta_info *sta,
235 int res, struct radius_sta *info);
236size_t hostapd_eid_eht_capab_len(struct hostapd_data *hapd,
237 enum ieee80211_op_mode opmode);
238u8 * hostapd_eid_eht_capab(struct hostapd_data *hapd, u8 *eid,
239 enum ieee80211_op_mode opmode);
240u8 * hostapd_eid_eht_operation(struct hostapd_data *hapd, u8 *eid);
241u16 copy_sta_eht_capab(struct hostapd_data *hapd, struct sta_info *sta,
242 enum ieee80211_op_mode opmode,
243 const u8 *he_capab, size_t he_capab_len,
244 const u8 *eht_capab, size_t eht_capab_len);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000245size_t hostapd_eid_mbssid_len(struct hostapd_data *hapd, u32 frame_type,
246 u8 *elem_count, const u8 *known_bss,
Sunil Ravi640215c2023-06-28 23:08:09 +0000247 size_t known_bss_len, size_t *rnr_len);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000248u8 * hostapd_eid_mbssid(struct hostapd_data *hapd, u8 *eid, u8 *end,
249 unsigned int frame_stype, u8 elem_count,
250 u8 **elem_offset,
Sunil Ravi640215c2023-06-28 23:08:09 +0000251 const u8 *known_bss, size_t known_bss_len, u8 *rnr_eid,
252 u8 *rnr_count, u8 **rnr_offset, size_t rnr_len);
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000253bool hostapd_is_mld_ap(struct hostapd_data *hapd);
254const char * sae_get_password(struct hostapd_data *hapd,
255 struct sta_info *sta, const char *rx_id,
256 struct sae_password_entry **pw_entry,
257 struct sae_pt **s_pt, const struct sae_pk **s_pk);
Sunil Ravib0ac25f2024-07-12 01:42:03 +0000258struct sta_info * hostapd_ml_get_assoc_sta(struct hostapd_data *hapd,
259 struct sta_info *sta,
260 struct hostapd_data **assoc_hapd);
261int hostapd_process_assoc_ml_info(struct hostapd_data *hapd,
262 struct sta_info *sta,
263 const u8 *ies, size_t ies_len,
264 bool reassoc, int tx_link_status,
265 bool offload);
Hai Shalom021b0b52019-04-10 11:17:58 -0700266
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700267#endif /* IEEE802_11_H */