blob: 55a22e570ed87c799b6e660fa4c9c8265a6288be [file] [log] [blame]
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -07001/*
2 * wpa_supplicant - WPA definitions
Dmitry Shmidt40b07202015-01-27 13:40:23 -08003 * Copyright (c) 2003-2015, Jouni Malinen <j@w1.fi>
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -07004 *
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 WPA_H
10#define WPA_H
11
12#include "common/defs.h"
13#include "common/eapol_common.h"
14#include "common/wpa_common.h"
Dmitry Shmidtf8623282013-02-20 14:34:59 -080015#include "common/ieee802_11_defs.h"
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070016
17struct wpa_sm;
18struct eapol_sm;
19struct wpa_config_blob;
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -080020struct hostapd_freq_params;
Hai Shalom74f70d42019-02-11 14:42:39 -080021struct wpa_channel_info;
Sunil Ravi77d572f2023-01-17 23:58:31 +000022struct rsn_pmksa_cache_entry;
Sunil8cd6f4d2022-06-28 18:40:46 +000023enum frame_encryption;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070024
25struct wpa_sm_ctx {
26 void *ctx; /* pointer to arbitrary upper level context */
27 void *msg_ctx; /* upper level context for wpa_msg() calls */
28
29 void (*set_state)(void *ctx, enum wpa_states state);
30 enum wpa_states (*get_state)(void *ctx);
Hai Shalom81f62d82019-07-22 12:10:00 -070031 void (*deauthenticate)(void * ctx, u16 reason_code);
Hai Shalomfdcde762020-04-02 11:19:20 -070032 void (*reconnect)(void *ctx);
Sunil Ravi77d572f2023-01-17 23:58:31 +000033 int (*set_key)(void *ctx, int link_id, enum wpa_alg alg,
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070034 const u8 *addr, int key_idx, int set_tx,
35 const u8 *seq, size_t seq_len,
Hai Shalomfdcde762020-04-02 11:19:20 -070036 const u8 *key, size_t key_len, enum key_flag key_flag);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070037 void * (*get_network_ctx)(void *ctx);
38 int (*get_bssid)(void *ctx, u8 *bssid);
39 int (*ether_send)(void *ctx, const u8 *dest, u16 proto, const u8 *buf,
40 size_t len);
41 int (*get_beacon_ie)(void *ctx);
42 void (*cancel_auth_timeout)(void *ctx);
43 u8 * (*alloc_eapol)(void *ctx, u8 type, const void *data, u16 data_len,
44 size_t *msg_len, void **data_pos);
Dmitry Shmidt29333592017-01-09 12:27:11 -080045 int (*add_pmkid)(void *ctx, void *network_ctx, const u8 *bssid,
Dmitry Shmidtd2986c22017-10-23 14:22:09 -070046 const u8 *pmkid, const u8 *fils_cache_id,
Hai Shalomfdcde762020-04-02 11:19:20 -070047 const u8 *pmk, size_t pmk_len, u32 pmk_lifetime,
Hai Shalom899fcc72020-10-19 14:38:18 -070048 u8 pmk_reauth_threshold, int akmp);
Dmitry Shmidt29333592017-01-09 12:27:11 -080049 int (*remove_pmkid)(void *ctx, void *network_ctx, const u8 *bssid,
Dmitry Shmidtd2986c22017-10-23 14:22:09 -070050 const u8 *pmkid, const u8 *fils_cache_id);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070051 void (*set_config_blob)(void *ctx, struct wpa_config_blob *blob);
52 const struct wpa_config_blob * (*get_config_blob)(void *ctx,
53 const char *name);
54 int (*mlme_setprotection)(void *ctx, const u8 *addr,
55 int protection_type, int key_type);
56 int (*update_ft_ies)(void *ctx, const u8 *md, const u8 *ies,
57 size_t ies_len);
58 int (*send_ft_action)(void *ctx, u8 action, const u8 *target_ap,
59 const u8 *ies, size_t ies_len);
60 int (*mark_authenticated)(void *ctx, const u8 *target_ap);
61#ifdef CONFIG_TDLS
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -080062 int (*tdls_get_capa)(void *ctx, int *tdls_supported,
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -080063 int *tdls_ext_setup, int *tdls_chan_switch);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070064 int (*send_tdls_mgmt)(void *ctx, const u8 *dst,
65 u8 action_code, u8 dialog_token,
Dmitry Shmidtdf5a7e42014-04-02 12:59:59 -070066 u16 status_code, u32 peer_capab,
Sunil Ravi2a14cf12023-11-21 00:54:38 +000067 int initiator, const u8 *buf, size_t len,
68 int link_id);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070069 int (*tdls_oper)(void *ctx, int oper, const u8 *peer);
Dmitry Shmidt51b6ea82013-05-08 10:42:09 -070070 int (*tdls_peer_addset)(void *ctx, const u8 *addr, int add, u16 aid,
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -080071 u16 capability, const u8 *supp_rates,
Dmitry Shmidtf8623282013-02-20 14:34:59 -080072 size_t supp_rates_len,
73 const struct ieee80211_ht_capabilities *ht_capab,
Dmitry Shmidt33e38bf2013-02-27 12:56:00 -080074 const struct ieee80211_vht_capabilities *vht_capab,
Hai Shalomc1a21442022-02-04 13:43:00 -080075 const struct ieee80211_he_capabilities *he_capab,
76 size_t he_capab_len,
77 const struct ieee80211_he_6ghz_band_cap *he_6ghz_capab,
Dmitry Shmidt9ead16e2014-10-07 13:15:23 -070078 u8 qosinfo, int wmm, const u8 *ext_capab,
Dmitry Shmidt344abd32014-01-14 13:17:00 -080079 size_t ext_capab_len, const u8 *supp_channels,
80 size_t supp_channels_len,
81 const u8 *supp_oper_classes,
Sunil Ravi2a14cf12023-11-21 00:54:38 +000082 size_t supp_oper_classes_len,
83 const struct ieee80211_eht_capabilities *eht_capab,
84 size_t eht_capab_len, int mld_link_id);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -080085 int (*tdls_enable_channel_switch)(
86 void *ctx, const u8 *addr, u8 oper_class,
87 const struct hostapd_freq_params *params);
88 int (*tdls_disable_channel_switch)(void *ctx, const u8 *addr);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -070089#endif /* CONFIG_TDLS */
Dmitry Shmidt40b07202015-01-27 13:40:23 -080090 void (*set_rekey_offload)(void *ctx, const u8 *kek, size_t kek_len,
91 const u8 *kck, size_t kck_len,
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -080092 const u8 *replay_ctr);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -080093 int (*key_mgmt_set_pmk)(void *ctx, const u8 *pmk, size_t pmk_len);
Dmitry Shmidtebd93af2017-02-21 13:40:44 -080094 void (*fils_hlp_rx)(void *ctx, const u8 *dst, const u8 *src,
95 const u8 *pkt, size_t pkt_len);
Hai Shalom74f70d42019-02-11 14:42:39 -080096 int (*channel_info)(void *ctx, struct wpa_channel_info *ci);
Hai Shalomfdcde762020-04-02 11:19:20 -070097 void (*transition_disable)(void *ctx, u8 bitmap);
Sunil Ravi036cec52023-03-29 11:35:17 -070098 void (*store_ptk)(void *ctx, const u8 *addr, int cipher,
Hai Shalom60840252021-02-19 19:02:11 -080099 u32 life_time, const struct wpa_ptk *ptk);
Sunil Ravi89eba102022-09-13 21:04:37 -0700100#ifdef CONFIG_PASN
101 int (*set_ltf_keyseed)(void *ctx, const u8 *own_addr,
102 const u8 *peer_addr, size_t ltf_keyseed_len,
103 const u8 *ltf_keyseed);
104#endif /* CONFIG_PASN */
Sunil Ravi77d572f2023-01-17 23:58:31 +0000105 void (*notify_pmksa_cache_entry)(void *ctx,
106 struct rsn_pmksa_cache_entry *entry);
Sunil Ravi7f769292024-07-23 22:21:32 +0000107 void (*ssid_verified)(void *ctx);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700108};
109
110
111enum wpa_sm_conf_params {
112 RSNA_PMK_LIFETIME /* dot11RSNAConfigPMKLifetime */,
113 RSNA_PMK_REAUTH_THRESHOLD /* dot11RSNAConfigPMKReauthThreshold */,
114 RSNA_SA_TIMEOUT /* dot11RSNAConfigSATimeout */,
115 WPA_PARAM_PROTO,
116 WPA_PARAM_PAIRWISE,
117 WPA_PARAM_GROUP,
118 WPA_PARAM_KEY_MGMT,
119 WPA_PARAM_MGMT_GROUP,
120 WPA_PARAM_RSN_ENABLED,
Hai Shalom74f70d42019-02-11 14:42:39 -0800121 WPA_PARAM_MFP,
Hai Shalomc3565922019-10-28 11:58:20 -0700122 WPA_PARAM_OCV,
123 WPA_PARAM_SAE_PWE,
Hai Shalom899fcc72020-10-19 14:38:18 -0700124 WPA_PARAM_SAE_PK,
Hai Shalomfdcde762020-04-02 11:19:20 -0700125 WPA_PARAM_DENY_PTK0_REKEY,
126 WPA_PARAM_EXT_KEY_ID,
127 WPA_PARAM_USE_EXT_KEY_ID,
Hai Shalomb755a2a2020-04-23 21:49:02 -0700128 WPA_PARAM_FT_RSNXE_USED,
Hai Shalom4fbc08f2020-05-18 12:37:00 -0700129 WPA_PARAM_DPP_PFS,
Sunil Ravi640215c2023-06-28 23:08:09 +0000130 WPA_PARAM_WMM_ENABLED,
Hai Shalom899fcc72020-10-19 14:38:18 -0700131 WPA_PARAM_OCI_FREQ_EAPOL,
132 WPA_PARAM_OCI_FREQ_EAPOL_G2,
133 WPA_PARAM_OCI_FREQ_FT_ASSOC,
134 WPA_PARAM_OCI_FREQ_FILS_ASSOC,
Sunil Ravia04bd252022-05-02 22:54:18 -0700135 WPA_PARAM_DISABLE_EAPOL_G2_TX,
Sunil Ravib0ac25f2024-07-12 01:42:03 +0000136 WPA_PARAM_ENCRYPT_EAPOL_M2,
137 WPA_PARAM_ENCRYPT_EAPOL_M4,
138 WPA_PARAM_FT_PREPEND_PMKID,
Sunil Ravi7f769292024-07-23 22:21:32 +0000139 WPA_PARAM_SSID_PROTECTION,
Sunil Ravic0f5d412024-09-11 22:12:49 +0000140 WPA_PARAM_RSN_OVERRIDE,
141 WPA_PARAM_RSN_OVERRIDE_SUPPORT,
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000142 WPA_PARAM_EAPOL_2_KEY_INFO_SET_MASK,
Sunil Ravi876a49b2025-02-03 19:18:32 +0000143 WPA_PARAM_SPP_AMSDU,
Sunil Ravic0f5d412024-09-11 22:12:49 +0000144};
145
146enum wpa_rsn_override {
147 RSN_OVERRIDE_NOT_USED,
148 RSN_OVERRIDE_RSNE,
149 RSN_OVERRIDE_RSNE_OVERRIDE,
150 RSN_OVERRIDE_RSNE_OVERRIDE_2,
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700151};
152
153struct rsn_supp_config {
154 void *network_ctx;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700155 int allowed_pairwise_cipher; /* bitfield of WPA_CIPHER_* */
156 int proactive_key_caching;
157 int eap_workaround;
158 void *eap_conf_ctx;
159 const u8 *ssid;
160 size_t ssid_len;
161 int wpa_ptk_rekey;
Hai Shalomfdcde762020-04-02 11:19:20 -0700162 int wpa_deny_ptk0_rekey;
Dmitry Shmidtcf32e602014-01-28 10:57:39 -0800163 int p2p;
Dmitry Shmidtd80a4012015-11-05 16:35:40 -0800164 int wpa_rsc_relaxation;
Hai Shalomfdcde762020-04-02 11:19:20 -0700165 int owe_ptk_workaround;
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700166 const u8 *fils_cache_id;
Hai Shalomfdcde762020-04-02 11:19:20 -0700167 int beacon_prot;
Hai Shalom60840252021-02-19 19:02:11 -0800168 bool force_kdk_derivation;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700169};
170
Sunil Ravi77d572f2023-01-17 23:58:31 +0000171struct wpa_sm_link {
172 u8 addr[ETH_ALEN];
173 u8 bssid[ETH_ALEN];
Sunil Ravic0f5d412024-09-11 22:12:49 +0000174 u8 *ap_rsne, *ap_rsnxe, *ap_rsnoe, *ap_rsno2e, *ap_rsnxoe;
175 size_t ap_rsne_len, ap_rsnxe_len, ap_rsnoe_len, ap_rsno2e_len,
176 ap_rsnxoe_len;;
Sunil Ravi77d572f2023-01-17 23:58:31 +0000177 struct wpa_gtk gtk;
178 struct wpa_gtk gtk_wnm_sleep;
179 struct wpa_igtk igtk;
180 struct wpa_igtk igtk_wnm_sleep;
181 struct wpa_bigtk bigtk;
182 struct wpa_bigtk bigtk_wnm_sleep;
183};
184
185struct wpa_sm_mlo {
186 u8 ap_mld_addr[ETH_ALEN];
187 u8 assoc_link_id;
188 u16 valid_links; /* bitmap of accepted links */
189 u16 req_links; /* bitmap of requested links */
190 struct wpa_sm_link links[MAX_NUM_MLD_LINKS];
191};
192
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700193#ifndef CONFIG_NO_WPA
194
195struct wpa_sm * wpa_sm_init(struct wpa_sm_ctx *ctx);
196void wpa_sm_deinit(struct wpa_sm *sm);
197void wpa_sm_notify_assoc(struct wpa_sm *sm, const u8 *bssid);
198void wpa_sm_notify_disassoc(struct wpa_sm *sm);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800199void wpa_sm_set_pmk(struct wpa_sm *sm, const u8 *pmk, size_t pmk_len,
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800200 const u8 *pmkid, const u8 *bssid);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700201void wpa_sm_set_pmk_from_pmksa(struct wpa_sm *sm);
202void wpa_sm_set_fast_reauth(struct wpa_sm *sm, int fast_reauth);
203void wpa_sm_set_scard_ctx(struct wpa_sm *sm, void *scard_ctx);
204void wpa_sm_set_config(struct wpa_sm *sm, struct rsn_supp_config *config);
Sunil Ravi7f769292024-07-23 22:21:32 +0000205void wpa_sm_set_ssid(struct wpa_sm *sm, const u8 *ssid, size_t ssid_len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700206void wpa_sm_set_own_addr(struct wpa_sm *sm, const u8 *addr);
207void wpa_sm_set_ifname(struct wpa_sm *sm, const char *ifname,
208 const char *bridge_ifname);
209void wpa_sm_set_eapol(struct wpa_sm *sm, struct eapol_sm *eapol);
210int wpa_sm_set_assoc_wpa_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
211int wpa_sm_set_assoc_wpa_ie_default(struct wpa_sm *sm, u8 *wpa_ie,
212 size_t *wpa_ie_len);
Hai Shalomc3565922019-10-28 11:58:20 -0700213int wpa_sm_set_assoc_rsnxe_default(struct wpa_sm *sm, u8 *rsnxe,
214 size_t *rsnxe_len);
215int wpa_sm_set_assoc_rsnxe(struct wpa_sm *sm, const u8 *ie, size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700216int wpa_sm_set_ap_wpa_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
217int wpa_sm_set_ap_rsn_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
Hai Shalomc3565922019-10-28 11:58:20 -0700218int wpa_sm_set_ap_rsnxe(struct wpa_sm *sm, const u8 *ie, size_t len);
Sunil Ravic0f5d412024-09-11 22:12:49 +0000219int wpa_sm_set_ap_rsne_override(struct wpa_sm *sm, const u8 *ie, size_t len);
220int wpa_sm_set_ap_rsne_override_2(struct wpa_sm *sm, const u8 *ie, size_t len);
221int wpa_sm_set_ap_rsnxe_override(struct wpa_sm *sm, const u8 *ie, size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700222int wpa_sm_get_mib(struct wpa_sm *sm, char *buf, size_t buflen);
223
224int wpa_sm_set_param(struct wpa_sm *sm, enum wpa_sm_conf_params param,
225 unsigned int value);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700226
227int wpa_sm_get_status(struct wpa_sm *sm, char *buf, size_t buflen,
228 int verbose);
Dmitry Shmidtf7e0a992013-05-23 11:03:10 -0700229int wpa_sm_pmf_enabled(struct wpa_sm *sm);
Hai Shalomfdcde762020-04-02 11:19:20 -0700230int wpa_sm_ext_key_id(struct wpa_sm *sm);
231int wpa_sm_ext_key_id_active(struct wpa_sm *sm);
Hai Shalom74f70d42019-02-11 14:42:39 -0800232int wpa_sm_ocv_enabled(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700233
234void wpa_sm_key_request(struct wpa_sm *sm, int error, int pairwise);
235
236int wpa_parse_wpa_ie(const u8 *wpa_ie, size_t wpa_ie_len,
237 struct wpa_ie_data *data);
238
239void wpa_sm_aborted_cached(struct wpa_sm *sm);
Hai Shalomc1a21442022-02-04 13:43:00 -0800240void wpa_sm_aborted_external_cached(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700241int wpa_sm_rx_eapol(struct wpa_sm *sm, const u8 *src_addr,
Sunil8cd6f4d2022-06-28 18:40:46 +0000242 const u8 *buf, size_t len, enum frame_encryption encrypted);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700243int wpa_sm_parse_own_wpa_ie(struct wpa_sm *sm, struct wpa_ie_data *data);
244int wpa_sm_pmksa_cache_list(struct wpa_sm *sm, char *buf, size_t len);
Dmitry Shmidt29333592017-01-09 12:27:11 -0800245struct rsn_pmksa_cache_entry * wpa_sm_pmksa_cache_head(struct wpa_sm *sm);
246struct rsn_pmksa_cache_entry *
247wpa_sm_pmksa_cache_add_entry(struct wpa_sm *sm,
248 struct rsn_pmksa_cache_entry * entry);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700249void wpa_sm_pmksa_cache_add(struct wpa_sm *sm, const u8 *pmk, size_t pmk_len,
250 const u8 *pmkid, const u8 *bssid,
251 const u8 *fils_cache_id);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000252int wpa_sm_pmksa_exists(struct wpa_sm *sm, const u8 *bssid, const u8 *own_addr,
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700253 const void *network_ctx);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700254void wpa_sm_drop_sa(struct wpa_sm *sm);
Hai Shalom60840252021-02-19 19:02:11 -0800255struct rsn_pmksa_cache_entry * wpa_sm_pmksa_cache_get(struct wpa_sm *sm,
256 const u8 *aa,
257 const u8 *pmkid,
258 const void *network_ctx,
259 int akmp);
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000260int wpa_sm_pmksa_get_pmk(struct wpa_sm *sm, const u8 *aa, const u8 **pmk,
261 size_t *pmk_len, const u8 **pmkid);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000262void wpa_sm_pmksa_cache_remove(struct wpa_sm *sm,
263 struct rsn_pmksa_cache_entry *entry);
264bool wpa_sm_has_ft_keys(struct wpa_sm *sm, const u8 *md);
Hai Shalomfdcde762020-04-02 11:19:20 -0700265int wpa_sm_has_ptk_installed(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700266
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800267void wpa_sm_update_replay_ctr(struct wpa_sm *sm, const u8 *replay_ctr);
268
269void wpa_sm_pmksa_cache_flush(struct wpa_sm *sm, void *network_ctx);
Hai Shalomc1a21442022-02-04 13:43:00 -0800270void wpa_sm_external_pmksa_cache_flush(struct wpa_sm *sm, void *network_ctx);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800271
Dmitry Shmidtcf32e602014-01-28 10:57:39 -0800272int wpa_sm_get_p2p_ip_addr(struct wpa_sm *sm, u8 *buf);
273
Andy Kuoaba17c12022-04-14 16:05:31 +0800274#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Ali677e7482020-11-12 19:49:02 +0530275void wpa_sm_install_pmk(struct wpa_sm *sm);
Mir Alieaaf04e2021-06-07 12:17:29 +0530276void wpa_sm_notify_brcm_ft_reassoc(struct wpa_sm *sm, const u8 *bssid);
Andy Kuoaba17c12022-04-14 16:05:31 +0800277#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
Mir Ali677e7482020-11-12 19:49:02 +0530278
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800279void wpa_sm_set_rx_replay_ctr(struct wpa_sm *sm, const u8 *rx_replay_counter);
Dmitry Shmidt40b07202015-01-27 13:40:23 -0800280void wpa_sm_set_ptk_kck_kek(struct wpa_sm *sm,
281 const u8 *ptk_kck, size_t ptk_kck_len,
282 const u8 *ptk_kek, size_t ptk_kek_len);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700283int wpa_fils_is_completed(struct wpa_sm *sm);
Hai Shalomc1a21442022-02-04 13:43:00 -0800284void wpa_sm_pmksa_cache_reconfig(struct wpa_sm *sm);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000285int wpa_sm_set_mlo_params(struct wpa_sm *sm, const struct wpa_sm_mlo *mlo);
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000286void wpa_sm_set_driver_bss_selection(struct wpa_sm *sm,
287 bool driver_bss_selection);
Sunil Ravi876a49b2025-02-03 19:18:32 +0000288bool wpa_sm_uses_spp_amsdu(struct wpa_sm *sm);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800289
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700290#else /* CONFIG_NO_WPA */
291
292static inline struct wpa_sm * wpa_sm_init(struct wpa_sm_ctx *ctx)
293{
294 return (struct wpa_sm *) 1;
295}
296
297static inline void wpa_sm_deinit(struct wpa_sm *sm)
298{
299}
300
301static inline void wpa_sm_notify_assoc(struct wpa_sm *sm, const u8 *bssid)
302{
303}
304
305static inline void wpa_sm_notify_disassoc(struct wpa_sm *sm)
306{
307}
308
309static inline void wpa_sm_set_pmk(struct wpa_sm *sm, const u8 *pmk,
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800310 size_t pmk_len, const u8 *pmkid,
311 const u8 *bssid)
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700312{
313}
314
315static inline void wpa_sm_set_pmk_from_pmksa(struct wpa_sm *sm)
316{
317}
318
319static inline void wpa_sm_set_fast_reauth(struct wpa_sm *sm, int fast_reauth)
320{
321}
322
323static inline void wpa_sm_set_scard_ctx(struct wpa_sm *sm, void *scard_ctx)
324{
325}
326
327static inline void wpa_sm_set_config(struct wpa_sm *sm,
328 struct rsn_supp_config *config)
329{
330}
331
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000332static inline void wpa_sm_set_ssid(struct wpa_sm *sm, const u8 *ssid,
333 size_t ssid_len)
334{
335}
336
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700337static inline void wpa_sm_set_own_addr(struct wpa_sm *sm, const u8 *addr)
338{
339}
340
341static inline void wpa_sm_set_ifname(struct wpa_sm *sm, const char *ifname,
342 const char *bridge_ifname)
343{
344}
345
346static inline void wpa_sm_set_eapol(struct wpa_sm *sm, struct eapol_sm *eapol)
347{
348}
349
350static inline int wpa_sm_set_assoc_wpa_ie(struct wpa_sm *sm, const u8 *ie,
351 size_t len)
352{
353 return -1;
354}
355
356static inline int wpa_sm_set_assoc_wpa_ie_default(struct wpa_sm *sm,
357 u8 *wpa_ie,
358 size_t *wpa_ie_len)
359{
360 return -1;
361}
362
363static inline int wpa_sm_set_ap_wpa_ie(struct wpa_sm *sm, const u8 *ie,
364 size_t len)
365{
366 return -1;
367}
368
369static inline int wpa_sm_set_ap_rsn_ie(struct wpa_sm *sm, const u8 *ie,
370 size_t len)
371{
372 return -1;
373}
374
Hai Shalomc3565922019-10-28 11:58:20 -0700375static inline int wpa_sm_set_ap_rsnxe(struct wpa_sm *sm, const u8 *ie,
376 size_t len)
377{
378 return -1;
379}
380
Sunil Ravic0f5d412024-09-11 22:12:49 +0000381static inline int wpa_sm_set_ap_rsne_override(struct wpa_sm *sm, const u8 *ie,
382 size_t len)
383{
384 return -1;
385}
386
387static inline int wpa_sm_set_ap_rsne_override_2(struct wpa_sm *sm, const u8 *ie,
388 size_t len)
389{
390 return -1;
391}
392
393static inline int wpa_sm_set_ap_rsnxe_override(struct wpa_sm *sm, const u8 *ie,
394 size_t len)
395{
396 return -1;
397}
398
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700399static inline int wpa_sm_get_mib(struct wpa_sm *sm, char *buf, size_t buflen)
400{
401 return 0;
402}
403
404static inline int wpa_sm_set_param(struct wpa_sm *sm,
405 enum wpa_sm_conf_params param,
406 unsigned int value)
407{
408 return -1;
409}
410
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700411static inline int wpa_sm_get_status(struct wpa_sm *sm, char *buf,
412 size_t buflen, int verbose)
413{
414 return 0;
415}
416
Dmitry Shmidt34af3062013-07-11 10:46:32 -0700417static inline int wpa_sm_pmf_enabled(struct wpa_sm *sm)
418{
419 return 0;
420}
421
Hai Shalomfdcde762020-04-02 11:19:20 -0700422static inline int wpa_sm_ext_key_id(struct wpa_sm *sm)
423{
424 return 0;
425}
426
427static inline int wpa_sm_ext_key_id_active(struct wpa_sm *sm)
428{
429 return 0;
430}
431
Hai Shalom74f70d42019-02-11 14:42:39 -0800432static inline int wpa_sm_ocv_enabled(struct wpa_sm *sm)
433{
434 return 0;
435}
436
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700437static inline void wpa_sm_key_request(struct wpa_sm *sm, int error,
438 int pairwise)
439{
440}
441
442static inline int wpa_parse_wpa_ie(const u8 *wpa_ie, size_t wpa_ie_len,
443 struct wpa_ie_data *data)
444{
445 return -1;
446}
447
448static inline void wpa_sm_aborted_cached(struct wpa_sm *sm)
449{
450}
451
Hai Shalomc1a21442022-02-04 13:43:00 -0800452static inline void wpa_sm_aborted_external_cached(struct wpa_sm *sm)
453{
454}
455
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700456static inline int wpa_sm_rx_eapol(struct wpa_sm *sm, const u8 *src_addr,
Sunil8cd6f4d2022-06-28 18:40:46 +0000457 const u8 *buf, size_t len,
458 enum frame_encryption encrypted)
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700459{
460 return -1;
461}
462
463static inline int wpa_sm_parse_own_wpa_ie(struct wpa_sm *sm,
464 struct wpa_ie_data *data)
465{
466 return -1;
467}
468
469static inline int wpa_sm_pmksa_cache_list(struct wpa_sm *sm, char *buf,
470 size_t len)
471{
472 return -1;
473}
474
475static inline void wpa_sm_drop_sa(struct wpa_sm *sm)
476{
477}
478
Hai Shalom60840252021-02-19 19:02:11 -0800479static inline struct rsn_pmksa_cache_entry *
480wpa_sm_pmksa_cache_get(struct wpa_sm *sm, const u8 *aa, const u8 *pmkid,
481 const void *network_ctx, int akmp)
482{
483 return NULL;
484}
485
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000486static inline int wpa_sm_has_ptk_installed(struct wpa_sm *sm)
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700487{
488 return 0;
489}
490
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800491static inline void wpa_sm_update_replay_ctr(struct wpa_sm *sm,
492 const u8 *replay_ctr)
493{
494}
495
Hai Shalomc1a21442022-02-04 13:43:00 -0800496static inline void wpa_sm_external_pmksa_cache_flush(struct wpa_sm *sm,
497 void *network_ctx)
498{
499}
500
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800501static inline void wpa_sm_pmksa_cache_flush(struct wpa_sm *sm,
502 void *network_ctx)
503{
504}
505
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800506static inline void wpa_sm_set_rx_replay_ctr(struct wpa_sm *sm,
507 const u8 *rx_replay_counter)
508{
509}
510
511static inline void wpa_sm_set_ptk_kck_kek(struct wpa_sm *sm, const u8 *ptk_kck,
Dmitry Shmidtd7ff03d2015-12-04 14:49:35 -0800512 size_t ptk_kck_len,
513 const u8 *ptk_kek, size_t ptk_kek_len)
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800514{
515}
516
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700517static inline int wpa_fils_is_completed(struct wpa_sm *sm)
Dmitry Shmidtfb79edc2014-01-10 10:45:54 -0800518{
519 return 0;
520}
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700521
Hai Shalomc1a21442022-02-04 13:43:00 -0800522static inline void wpa_sm_pmksa_cache_reconfig(struct wpa_sm *sm)
523{
524}
525
Sunil Ravi77d572f2023-01-17 23:58:31 +0000526static inline int wpa_sm_set_mlo_params(struct wpa_sm *sm,
527 const struct wpa_sm_mlo *mlo)
528{
529 return 0;
530}
531
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000532static inline void wpa_sm_set_driver_bss_selection(struct wpa_sm *sm,
533 bool driver_bss_selection)
534{
535}
536
Sunil Ravi876a49b2025-02-03 19:18:32 +0000537static inline bool wpa_sm_uses_spp_amsdu(struct wpa_sm *sm)
538{
539 return false;
540}
541
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700542#endif /* CONFIG_NO_WPA */
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700543
544#ifdef CONFIG_IEEE80211R
545
546int wpa_sm_set_ft_params(struct wpa_sm *sm, const u8 *ies, size_t ies_len);
547int wpa_ft_prepare_auth_request(struct wpa_sm *sm, const u8 *mdie);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700548int wpa_ft_add_mdie(struct wpa_sm *sm, u8 *ies, size_t ies_len,
549 const u8 *mdie);
550const u8 * wpa_sm_get_ft_md(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700551int wpa_ft_process_response(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
552 int ft_action, const u8 *target_ap,
553 const u8 *ric_ies, size_t ric_ies_len);
554int wpa_ft_is_completed(struct wpa_sm *sm);
Dmitry Shmidt4b060592013-04-29 16:42:49 -0700555void wpa_reset_ft_completed(struct wpa_sm *sm);
Mir Ali677e7482020-11-12 19:49:02 +0530556void wpa_set_ft_completed(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700557int wpa_ft_validate_reassoc_resp(struct wpa_sm *sm, const u8 *ies,
558 size_t ies_len, const u8 *src_addr);
559int wpa_ft_start_over_ds(struct wpa_sm *sm, const u8 *target_ap,
Sunil Ravi77d572f2023-01-17 23:58:31 +0000560 const u8 *mdie, bool force);
Andy Kuoaba17c12022-04-14 16:05:31 +0800561#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Alieaaf04e2021-06-07 12:17:29 +0530562int wpa_ft_is_ft_protocol(struct wpa_sm *sm);
Andy Kuoaba17c12022-04-14 16:05:31 +0800563#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
564
Hai Shalom60840252021-02-19 19:02:11 -0800565#ifdef CONFIG_PASN
566
567int wpa_pasn_ft_derive_pmk_r1(struct wpa_sm *sm, int akmp, const u8 *r1kh_id,
568 u8 *pmk_r1, size_t *pmk_r1_len, u8 *pmk_r1_name);
569
570#endif /* CONFIG_PASN */
571
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700572#else /* CONFIG_IEEE80211R */
573
574static inline int
575wpa_sm_set_ft_params(struct wpa_sm *sm, const u8 *ies, size_t ies_len)
576{
577 return 0;
578}
579
580static inline int wpa_ft_prepare_auth_request(struct wpa_sm *sm,
581 const u8 *mdie)
582{
583 return 0;
584}
585
Roshan Pius3a1667e2018-07-03 15:17:14 -0700586static inline int wpa_ft_add_mdie(struct wpa_sm *sm, u8 *ies, size_t ies_len,
587 const u8 *mdie)
588{
589 return 0;
590}
591
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700592static inline int
593wpa_ft_process_response(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
594 int ft_action, const u8 *target_ap)
595{
596 return 0;
597}
598
599static inline int wpa_ft_is_completed(struct wpa_sm *sm)
600{
601 return 0;
602}
603
Andy Kuoaba17c12022-04-14 16:05:31 +0800604#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Alieaaf04e2021-06-07 12:17:29 +0530605static inline int wpa_ft_is_ft_protocol(struct wpa_sm *sm)
606{
607 return 0;
608}
Andy Kuoaba17c12022-04-14 16:05:31 +0800609#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
Mir Alieaaf04e2021-06-07 12:17:29 +0530610
Dmitry Shmidt4b060592013-04-29 16:42:49 -0700611static inline void wpa_reset_ft_completed(struct wpa_sm *sm)
612{
613}
614
Mir Ali677e7482020-11-12 19:49:02 +0530615static inline void wpa_set_ft_completed(struct wpa_sm *sm)
616{
617}
618
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700619static inline int
620wpa_ft_validate_reassoc_resp(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
621 const u8 *src_addr)
622{
623 return -1;
624}
625
Hai Shalom60840252021-02-19 19:02:11 -0800626#ifdef CONFIG_PASN
627
Sunil Ravi77d572f2023-01-17 23:58:31 +0000628static inline int
629wpa_pasn_ft_derive_pmk_r1(struct wpa_sm *sm, int akmp, const u8 *r1kh_id,
630 u8 *pmk_r1, size_t *pmk_r1_len, u8 *pmk_r1_name)
Hai Shalom60840252021-02-19 19:02:11 -0800631{
632 return -1;
633}
634
635#endif /* CONFIG_PASN */
636
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700637#endif /* CONFIG_IEEE80211R */
638
639
640/* tdls.c */
641void wpa_tdls_ap_ies(struct wpa_sm *sm, const u8 *ies, size_t len);
642void wpa_tdls_assoc_resp_ies(struct wpa_sm *sm, const u8 *ies, size_t len);
643int wpa_tdls_start(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt4b9d52f2013-02-05 17:44:43 -0800644void wpa_tdls_remove(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800645int wpa_tdls_teardown_link(struct wpa_sm *sm, const u8 *addr, u16 reason_code);
646int wpa_tdls_send_discovery_request(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700647int wpa_tdls_init(struct wpa_sm *sm);
Dmitry Shmidtf8623282013-02-20 14:34:59 -0800648void wpa_tdls_teardown_peers(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700649void wpa_tdls_deinit(struct wpa_sm *sm);
650void wpa_tdls_enable(struct wpa_sm *sm, int enabled);
Dmitry Shmidt43cb5782014-06-16 16:23:22 -0700651void wpa_tdls_disable_unreachable_link(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidte0e48dc2013-11-18 12:00:06 -0800652const char * wpa_tdls_get_link_status(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800653int wpa_tdls_is_external_setup(struct wpa_sm *sm);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800654int wpa_tdls_enable_chan_switch(struct wpa_sm *sm, const u8 *addr,
655 u8 oper_class,
656 struct hostapd_freq_params *freq_params);
657int wpa_tdls_disable_chan_switch(struct wpa_sm *sm, const u8 *addr);
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000658int wpa_tdls_process_discovery_response(struct wpa_sm *sm, const u8 *addr,
659 const u8 *buf, size_t len);
Dmitry Shmidt4ae50e62016-06-27 13:48:39 -0700660#ifdef CONFIG_TDLS_TESTING
661extern unsigned int tdls_testing;
662#endif /* CONFIG_TDLS_TESTING */
663
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700664
Dmitry Shmidt61d9df32012-08-29 16:22:06 -0700665int wpa_wnmsleep_install_key(struct wpa_sm *sm, u8 subelem_id, u8 *buf);
Dmitry Shmidt55840ad2015-12-14 12:45:46 -0800666void wpa_sm_set_test_assoc_ie(struct wpa_sm *sm, struct wpabuf *buf);
Sunil Ravib0ac25f2024-07-12 01:42:03 +0000667void wpa_sm_set_test_eapol_m2_elems(struct wpa_sm *sm, struct wpabuf *buf);
668void wpa_sm_set_test_eapol_m4_elems(struct wpa_sm *sm, struct wpabuf *buf);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700669const u8 * wpa_sm_get_anonce(struct wpa_sm *sm);
Sunil Ravi79e6c4f2025-01-04 00:47:06 +0000670int wpa_sm_set_test_rsnxe_data(struct wpa_sm *sm, struct wpabuf *data,
671 struct wpabuf *mask);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700672unsigned int wpa_sm_get_key_mgmt(struct wpa_sm *sm);
Dmitry Shmidt61d9df32012-08-29 16:22:06 -0700673
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700674struct wpabuf * fils_build_auth(struct wpa_sm *sm, int dh_group, const u8 *md);
675int fils_process_auth(struct wpa_sm *sm, const u8 *bssid, const u8 *data,
676 size_t len);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800677struct wpabuf * fils_build_assoc_req(struct wpa_sm *sm, const u8 **kek,
678 size_t *kek_len, const u8 **snonce,
Paul Stewart092955c2017-02-06 09:13:09 -0800679 const u8 **anonce,
680 const struct wpabuf **hlp,
681 unsigned int num_hlp);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800682int fils_process_assoc_resp(struct wpa_sm *sm, const u8 *resp, size_t len);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700683
684struct wpabuf * owe_build_assoc_req(struct wpa_sm *sm, u16 group);
685int owe_process_assoc_resp(struct wpa_sm *sm, const u8 *bssid,
686 const u8 *resp_ies, size_t resp_ies_len);
687
688void wpa_sm_set_reset_fils_completed(struct wpa_sm *sm, int set);
689void wpa_sm_set_fils_cache_id(struct wpa_sm *sm, const u8 *fils_cache_id);
Hai Shalom021b0b52019-04-10 11:17:58 -0700690void wpa_sm_set_dpp_z(struct wpa_sm *sm, const struct wpabuf *z);
Sunil Ravi89eba102022-09-13 21:04:37 -0700691void wpa_pasn_sm_set_caps(struct wpa_sm *sm, unsigned int flags2);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000692struct rsn_pmksa_cache * wpa_sm_get_pmksa_cache(struct wpa_sm *sm);
693
694void wpa_sm_set_cur_pmksa(struct wpa_sm *sm,
695 struct rsn_pmksa_cache_entry *entry);
696const u8 * wpa_sm_get_auth_addr(struct wpa_sm *sm);
Sunil Ravi876a49b2025-02-03 19:18:32 +0000697struct wpabuf * wpa_sm_known_sta_identification(struct wpa_sm *sm, const u8 *aa,
698 u64 timestamp);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800699
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700700#endif /* WPA_H */