blob: ca64d8fb2641c0b7af9c17f9a74cbc2f53d160b7 [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,
142};
143
144enum wpa_rsn_override {
145 RSN_OVERRIDE_NOT_USED,
146 RSN_OVERRIDE_RSNE,
147 RSN_OVERRIDE_RSNE_OVERRIDE,
148 RSN_OVERRIDE_RSNE_OVERRIDE_2,
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700149};
150
151struct rsn_supp_config {
152 void *network_ctx;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700153 int allowed_pairwise_cipher; /* bitfield of WPA_CIPHER_* */
154 int proactive_key_caching;
155 int eap_workaround;
156 void *eap_conf_ctx;
157 const u8 *ssid;
158 size_t ssid_len;
159 int wpa_ptk_rekey;
Hai Shalomfdcde762020-04-02 11:19:20 -0700160 int wpa_deny_ptk0_rekey;
Dmitry Shmidtcf32e602014-01-28 10:57:39 -0800161 int p2p;
Dmitry Shmidtd80a4012015-11-05 16:35:40 -0800162 int wpa_rsc_relaxation;
Hai Shalomfdcde762020-04-02 11:19:20 -0700163 int owe_ptk_workaround;
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700164 const u8 *fils_cache_id;
Hai Shalomfdcde762020-04-02 11:19:20 -0700165 int beacon_prot;
Hai Shalom60840252021-02-19 19:02:11 -0800166 bool force_kdk_derivation;
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700167};
168
Sunil Ravi77d572f2023-01-17 23:58:31 +0000169struct wpa_sm_link {
170 u8 addr[ETH_ALEN];
171 u8 bssid[ETH_ALEN];
Sunil Ravic0f5d412024-09-11 22:12:49 +0000172 u8 *ap_rsne, *ap_rsnxe, *ap_rsnoe, *ap_rsno2e, *ap_rsnxoe;
173 size_t ap_rsne_len, ap_rsnxe_len, ap_rsnoe_len, ap_rsno2e_len,
174 ap_rsnxoe_len;;
Sunil Ravi77d572f2023-01-17 23:58:31 +0000175 struct wpa_gtk gtk;
176 struct wpa_gtk gtk_wnm_sleep;
177 struct wpa_igtk igtk;
178 struct wpa_igtk igtk_wnm_sleep;
179 struct wpa_bigtk bigtk;
180 struct wpa_bigtk bigtk_wnm_sleep;
181};
182
183struct wpa_sm_mlo {
184 u8 ap_mld_addr[ETH_ALEN];
185 u8 assoc_link_id;
186 u16 valid_links; /* bitmap of accepted links */
187 u16 req_links; /* bitmap of requested links */
188 struct wpa_sm_link links[MAX_NUM_MLD_LINKS];
189};
190
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700191#ifndef CONFIG_NO_WPA
192
193struct wpa_sm * wpa_sm_init(struct wpa_sm_ctx *ctx);
194void wpa_sm_deinit(struct wpa_sm *sm);
195void wpa_sm_notify_assoc(struct wpa_sm *sm, const u8 *bssid);
196void wpa_sm_notify_disassoc(struct wpa_sm *sm);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800197void wpa_sm_set_pmk(struct wpa_sm *sm, const u8 *pmk, size_t pmk_len,
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800198 const u8 *pmkid, const u8 *bssid);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700199void wpa_sm_set_pmk_from_pmksa(struct wpa_sm *sm);
200void wpa_sm_set_fast_reauth(struct wpa_sm *sm, int fast_reauth);
201void wpa_sm_set_scard_ctx(struct wpa_sm *sm, void *scard_ctx);
202void wpa_sm_set_config(struct wpa_sm *sm, struct rsn_supp_config *config);
Sunil Ravi7f769292024-07-23 22:21:32 +0000203void wpa_sm_set_ssid(struct wpa_sm *sm, const u8 *ssid, size_t ssid_len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700204void wpa_sm_set_own_addr(struct wpa_sm *sm, const u8 *addr);
205void wpa_sm_set_ifname(struct wpa_sm *sm, const char *ifname,
206 const char *bridge_ifname);
207void wpa_sm_set_eapol(struct wpa_sm *sm, struct eapol_sm *eapol);
208int wpa_sm_set_assoc_wpa_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
209int wpa_sm_set_assoc_wpa_ie_default(struct wpa_sm *sm, u8 *wpa_ie,
210 size_t *wpa_ie_len);
Hai Shalomc3565922019-10-28 11:58:20 -0700211int wpa_sm_set_assoc_rsnxe_default(struct wpa_sm *sm, u8 *rsnxe,
212 size_t *rsnxe_len);
213int wpa_sm_set_assoc_rsnxe(struct wpa_sm *sm, const u8 *ie, size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700214int wpa_sm_set_ap_wpa_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
215int wpa_sm_set_ap_rsn_ie(struct wpa_sm *sm, const u8 *ie, size_t len);
Hai Shalomc3565922019-10-28 11:58:20 -0700216int wpa_sm_set_ap_rsnxe(struct wpa_sm *sm, const u8 *ie, size_t len);
Sunil Ravic0f5d412024-09-11 22:12:49 +0000217int wpa_sm_set_ap_rsne_override(struct wpa_sm *sm, const u8 *ie, size_t len);
218int wpa_sm_set_ap_rsne_override_2(struct wpa_sm *sm, const u8 *ie, size_t len);
219int wpa_sm_set_ap_rsnxe_override(struct wpa_sm *sm, const u8 *ie, size_t len);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700220int wpa_sm_get_mib(struct wpa_sm *sm, char *buf, size_t buflen);
221
222int wpa_sm_set_param(struct wpa_sm *sm, enum wpa_sm_conf_params param,
223 unsigned int value);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700224
225int wpa_sm_get_status(struct wpa_sm *sm, char *buf, size_t buflen,
226 int verbose);
Dmitry Shmidtf7e0a992013-05-23 11:03:10 -0700227int wpa_sm_pmf_enabled(struct wpa_sm *sm);
Hai Shalomfdcde762020-04-02 11:19:20 -0700228int wpa_sm_ext_key_id(struct wpa_sm *sm);
229int wpa_sm_ext_key_id_active(struct wpa_sm *sm);
Hai Shalom74f70d42019-02-11 14:42:39 -0800230int wpa_sm_ocv_enabled(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700231
232void wpa_sm_key_request(struct wpa_sm *sm, int error, int pairwise);
233
234int wpa_parse_wpa_ie(const u8 *wpa_ie, size_t wpa_ie_len,
235 struct wpa_ie_data *data);
236
237void wpa_sm_aborted_cached(struct wpa_sm *sm);
Hai Shalomc1a21442022-02-04 13:43:00 -0800238void wpa_sm_aborted_external_cached(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700239int wpa_sm_rx_eapol(struct wpa_sm *sm, const u8 *src_addr,
Sunil8cd6f4d2022-06-28 18:40:46 +0000240 const u8 *buf, size_t len, enum frame_encryption encrypted);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700241int wpa_sm_parse_own_wpa_ie(struct wpa_sm *sm, struct wpa_ie_data *data);
242int wpa_sm_pmksa_cache_list(struct wpa_sm *sm, char *buf, size_t len);
Dmitry Shmidt29333592017-01-09 12:27:11 -0800243struct rsn_pmksa_cache_entry * wpa_sm_pmksa_cache_head(struct wpa_sm *sm);
244struct rsn_pmksa_cache_entry *
245wpa_sm_pmksa_cache_add_entry(struct wpa_sm *sm,
246 struct rsn_pmksa_cache_entry * entry);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700247void wpa_sm_pmksa_cache_add(struct wpa_sm *sm, const u8 *pmk, size_t pmk_len,
248 const u8 *pmkid, const u8 *bssid,
249 const u8 *fils_cache_id);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000250int wpa_sm_pmksa_exists(struct wpa_sm *sm, const u8 *bssid, const u8 *own_addr,
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700251 const void *network_ctx);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700252void wpa_sm_drop_sa(struct wpa_sm *sm);
Hai Shalom60840252021-02-19 19:02:11 -0800253struct rsn_pmksa_cache_entry * wpa_sm_pmksa_cache_get(struct wpa_sm *sm,
254 const u8 *aa,
255 const u8 *pmkid,
256 const void *network_ctx,
257 int akmp);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000258void wpa_sm_pmksa_cache_remove(struct wpa_sm *sm,
259 struct rsn_pmksa_cache_entry *entry);
260bool wpa_sm_has_ft_keys(struct wpa_sm *sm, const u8 *md);
Hai Shalomfdcde762020-04-02 11:19:20 -0700261int wpa_sm_has_ptk_installed(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700262
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800263void wpa_sm_update_replay_ctr(struct wpa_sm *sm, const u8 *replay_ctr);
264
265void wpa_sm_pmksa_cache_flush(struct wpa_sm *sm, void *network_ctx);
Hai Shalomc1a21442022-02-04 13:43:00 -0800266void wpa_sm_external_pmksa_cache_flush(struct wpa_sm *sm, void *network_ctx);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800267
Dmitry Shmidtcf32e602014-01-28 10:57:39 -0800268int wpa_sm_get_p2p_ip_addr(struct wpa_sm *sm, u8 *buf);
269
Andy Kuoaba17c12022-04-14 16:05:31 +0800270#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Ali677e7482020-11-12 19:49:02 +0530271void wpa_sm_install_pmk(struct wpa_sm *sm);
Mir Alieaaf04e2021-06-07 12:17:29 +0530272void wpa_sm_notify_brcm_ft_reassoc(struct wpa_sm *sm, const u8 *bssid);
Andy Kuoaba17c12022-04-14 16:05:31 +0800273#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
Mir Ali677e7482020-11-12 19:49:02 +0530274
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800275void wpa_sm_set_rx_replay_ctr(struct wpa_sm *sm, const u8 *rx_replay_counter);
Dmitry Shmidt40b07202015-01-27 13:40:23 -0800276void wpa_sm_set_ptk_kck_kek(struct wpa_sm *sm,
277 const u8 *ptk_kck, size_t ptk_kck_len,
278 const u8 *ptk_kek, size_t ptk_kek_len);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700279int wpa_fils_is_completed(struct wpa_sm *sm);
Hai Shalomc1a21442022-02-04 13:43:00 -0800280void wpa_sm_pmksa_cache_reconfig(struct wpa_sm *sm);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000281int wpa_sm_set_mlo_params(struct wpa_sm *sm, const struct wpa_sm_mlo *mlo);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800282
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700283#else /* CONFIG_NO_WPA */
284
285static inline struct wpa_sm * wpa_sm_init(struct wpa_sm_ctx *ctx)
286{
287 return (struct wpa_sm *) 1;
288}
289
290static inline void wpa_sm_deinit(struct wpa_sm *sm)
291{
292}
293
294static inline void wpa_sm_notify_assoc(struct wpa_sm *sm, const u8 *bssid)
295{
296}
297
298static inline void wpa_sm_notify_disassoc(struct wpa_sm *sm)
299{
300}
301
302static inline void wpa_sm_set_pmk(struct wpa_sm *sm, const u8 *pmk,
Dmitry Shmidt57c2d392016-02-23 13:40:19 -0800303 size_t pmk_len, const u8 *pmkid,
304 const u8 *bssid)
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700305{
306}
307
308static inline void wpa_sm_set_pmk_from_pmksa(struct wpa_sm *sm)
309{
310}
311
312static inline void wpa_sm_set_fast_reauth(struct wpa_sm *sm, int fast_reauth)
313{
314}
315
316static inline void wpa_sm_set_scard_ctx(struct wpa_sm *sm, void *scard_ctx)
317{
318}
319
320static inline void wpa_sm_set_config(struct wpa_sm *sm,
321 struct rsn_supp_config *config)
322{
323}
324
325static inline void wpa_sm_set_own_addr(struct wpa_sm *sm, const u8 *addr)
326{
327}
328
329static inline void wpa_sm_set_ifname(struct wpa_sm *sm, const char *ifname,
330 const char *bridge_ifname)
331{
332}
333
334static inline void wpa_sm_set_eapol(struct wpa_sm *sm, struct eapol_sm *eapol)
335{
336}
337
338static inline int wpa_sm_set_assoc_wpa_ie(struct wpa_sm *sm, const u8 *ie,
339 size_t len)
340{
341 return -1;
342}
343
344static inline int wpa_sm_set_assoc_wpa_ie_default(struct wpa_sm *sm,
345 u8 *wpa_ie,
346 size_t *wpa_ie_len)
347{
348 return -1;
349}
350
351static inline int wpa_sm_set_ap_wpa_ie(struct wpa_sm *sm, const u8 *ie,
352 size_t len)
353{
354 return -1;
355}
356
357static inline int wpa_sm_set_ap_rsn_ie(struct wpa_sm *sm, const u8 *ie,
358 size_t len)
359{
360 return -1;
361}
362
Hai Shalomc3565922019-10-28 11:58:20 -0700363static inline int wpa_sm_set_ap_rsnxe(struct wpa_sm *sm, const u8 *ie,
364 size_t len)
365{
366 return -1;
367}
368
Sunil Ravic0f5d412024-09-11 22:12:49 +0000369static inline int wpa_sm_set_ap_rsne_override(struct wpa_sm *sm, const u8 *ie,
370 size_t len)
371{
372 return -1;
373}
374
375static inline int wpa_sm_set_ap_rsne_override_2(struct wpa_sm *sm, const u8 *ie,
376 size_t len)
377{
378 return -1;
379}
380
381static inline int wpa_sm_set_ap_rsnxe_override(struct wpa_sm *sm, const u8 *ie,
382 size_t len)
383{
384 return -1;
385}
386
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700387static inline int wpa_sm_get_mib(struct wpa_sm *sm, char *buf, size_t buflen)
388{
389 return 0;
390}
391
392static inline int wpa_sm_set_param(struct wpa_sm *sm,
393 enum wpa_sm_conf_params param,
394 unsigned int value)
395{
396 return -1;
397}
398
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700399static inline int wpa_sm_get_status(struct wpa_sm *sm, char *buf,
400 size_t buflen, int verbose)
401{
402 return 0;
403}
404
Dmitry Shmidt34af3062013-07-11 10:46:32 -0700405static inline int wpa_sm_pmf_enabled(struct wpa_sm *sm)
406{
407 return 0;
408}
409
Hai Shalomfdcde762020-04-02 11:19:20 -0700410static inline int wpa_sm_ext_key_id(struct wpa_sm *sm)
411{
412 return 0;
413}
414
415static inline int wpa_sm_ext_key_id_active(struct wpa_sm *sm)
416{
417 return 0;
418}
419
Hai Shalom74f70d42019-02-11 14:42:39 -0800420static inline int wpa_sm_ocv_enabled(struct wpa_sm *sm)
421{
422 return 0;
423}
424
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700425static inline void wpa_sm_key_request(struct wpa_sm *sm, int error,
426 int pairwise)
427{
428}
429
430static inline int wpa_parse_wpa_ie(const u8 *wpa_ie, size_t wpa_ie_len,
431 struct wpa_ie_data *data)
432{
433 return -1;
434}
435
436static inline void wpa_sm_aborted_cached(struct wpa_sm *sm)
437{
438}
439
Hai Shalomc1a21442022-02-04 13:43:00 -0800440static inline void wpa_sm_aborted_external_cached(struct wpa_sm *sm)
441{
442}
443
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700444static inline int wpa_sm_rx_eapol(struct wpa_sm *sm, const u8 *src_addr,
Sunil8cd6f4d2022-06-28 18:40:46 +0000445 const u8 *buf, size_t len,
446 enum frame_encryption encrypted)
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700447{
448 return -1;
449}
450
451static inline int wpa_sm_parse_own_wpa_ie(struct wpa_sm *sm,
452 struct wpa_ie_data *data)
453{
454 return -1;
455}
456
457static inline int wpa_sm_pmksa_cache_list(struct wpa_sm *sm, char *buf,
458 size_t len)
459{
460 return -1;
461}
462
463static inline void wpa_sm_drop_sa(struct wpa_sm *sm)
464{
465}
466
Hai Shalom60840252021-02-19 19:02:11 -0800467static inline struct rsn_pmksa_cache_entry *
468wpa_sm_pmksa_cache_get(struct wpa_sm *sm, const u8 *aa, const u8 *pmkid,
469 const void *network_ctx, int akmp)
470{
471 return NULL;
472}
473
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700474static inline int wpa_sm_has_ptk(struct wpa_sm *sm)
475{
476 return 0;
477}
478
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800479static inline void wpa_sm_update_replay_ctr(struct wpa_sm *sm,
480 const u8 *replay_ctr)
481{
482}
483
Hai Shalomc1a21442022-02-04 13:43:00 -0800484static inline void wpa_sm_external_pmksa_cache_flush(struct wpa_sm *sm,
485 void *network_ctx)
486{
487}
488
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800489static inline void wpa_sm_pmksa_cache_flush(struct wpa_sm *sm,
490 void *network_ctx)
491{
492}
493
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800494static inline void wpa_sm_set_rx_replay_ctr(struct wpa_sm *sm,
495 const u8 *rx_replay_counter)
496{
497}
498
499static inline void wpa_sm_set_ptk_kck_kek(struct wpa_sm *sm, const u8 *ptk_kck,
Dmitry Shmidtd7ff03d2015-12-04 14:49:35 -0800500 size_t ptk_kck_len,
501 const u8 *ptk_kek, size_t ptk_kek_len)
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800502{
503}
504
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700505static inline int wpa_fils_is_completed(struct wpa_sm *sm)
Dmitry Shmidtfb79edc2014-01-10 10:45:54 -0800506{
507 return 0;
508}
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700509
Hai Shalomc1a21442022-02-04 13:43:00 -0800510static inline void wpa_sm_pmksa_cache_reconfig(struct wpa_sm *sm)
511{
512}
513
Sunil Ravi77d572f2023-01-17 23:58:31 +0000514static inline int wpa_sm_set_mlo_params(struct wpa_sm *sm,
515 const struct wpa_sm_mlo *mlo)
516{
517 return 0;
518}
519
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700520#endif /* CONFIG_NO_WPA */
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700521
522#ifdef CONFIG_IEEE80211R
523
524int wpa_sm_set_ft_params(struct wpa_sm *sm, const u8 *ies, size_t ies_len);
525int wpa_ft_prepare_auth_request(struct wpa_sm *sm, const u8 *mdie);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700526int wpa_ft_add_mdie(struct wpa_sm *sm, u8 *ies, size_t ies_len,
527 const u8 *mdie);
528const u8 * wpa_sm_get_ft_md(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700529int wpa_ft_process_response(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
530 int ft_action, const u8 *target_ap,
531 const u8 *ric_ies, size_t ric_ies_len);
532int wpa_ft_is_completed(struct wpa_sm *sm);
Dmitry Shmidt4b060592013-04-29 16:42:49 -0700533void wpa_reset_ft_completed(struct wpa_sm *sm);
Mir Ali677e7482020-11-12 19:49:02 +0530534void wpa_set_ft_completed(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700535int wpa_ft_validate_reassoc_resp(struct wpa_sm *sm, const u8 *ies,
536 size_t ies_len, const u8 *src_addr);
537int wpa_ft_start_over_ds(struct wpa_sm *sm, const u8 *target_ap,
Sunil Ravi77d572f2023-01-17 23:58:31 +0000538 const u8 *mdie, bool force);
Andy Kuoaba17c12022-04-14 16:05:31 +0800539#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Alieaaf04e2021-06-07 12:17:29 +0530540int wpa_ft_is_ft_protocol(struct wpa_sm *sm);
Andy Kuoaba17c12022-04-14 16:05:31 +0800541#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
542
Hai Shalom60840252021-02-19 19:02:11 -0800543#ifdef CONFIG_PASN
544
545int wpa_pasn_ft_derive_pmk_r1(struct wpa_sm *sm, int akmp, const u8 *r1kh_id,
546 u8 *pmk_r1, size_t *pmk_r1_len, u8 *pmk_r1_name);
547
548#endif /* CONFIG_PASN */
549
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700550#else /* CONFIG_IEEE80211R */
551
552static inline int
553wpa_sm_set_ft_params(struct wpa_sm *sm, const u8 *ies, size_t ies_len)
554{
555 return 0;
556}
557
558static inline int wpa_ft_prepare_auth_request(struct wpa_sm *sm,
559 const u8 *mdie)
560{
561 return 0;
562}
563
Roshan Pius3a1667e2018-07-03 15:17:14 -0700564static inline int wpa_ft_add_mdie(struct wpa_sm *sm, u8 *ies, size_t ies_len,
565 const u8 *mdie)
566{
567 return 0;
568}
569
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700570static inline int
571wpa_ft_process_response(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
572 int ft_action, const u8 *target_ap)
573{
574 return 0;
575}
576
577static inline int wpa_ft_is_completed(struct wpa_sm *sm)
578{
579 return 0;
580}
581
Andy Kuoaba17c12022-04-14 16:05:31 +0800582#if defined(CONFIG_DRIVER_NL80211_BRCM) || defined(CONFIG_DRIVER_NL80211_SYNA)
Mir Alieaaf04e2021-06-07 12:17:29 +0530583static inline int wpa_ft_is_ft_protocol(struct wpa_sm *sm)
584{
585 return 0;
586}
Andy Kuoaba17c12022-04-14 16:05:31 +0800587#endif /* CONFIG_DRIVER_NL80211_BRCM || CONFIG_DRIVER_NL80211_SYNA */
Mir Alieaaf04e2021-06-07 12:17:29 +0530588
Dmitry Shmidt4b060592013-04-29 16:42:49 -0700589static inline void wpa_reset_ft_completed(struct wpa_sm *sm)
590{
591}
592
Mir Ali677e7482020-11-12 19:49:02 +0530593static inline void wpa_set_ft_completed(struct wpa_sm *sm)
594{
595}
596
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700597static inline int
598wpa_ft_validate_reassoc_resp(struct wpa_sm *sm, const u8 *ies, size_t ies_len,
599 const u8 *src_addr)
600{
601 return -1;
602}
603
Hai Shalom60840252021-02-19 19:02:11 -0800604#ifdef CONFIG_PASN
605
Sunil Ravi77d572f2023-01-17 23:58:31 +0000606static inline int
607wpa_pasn_ft_derive_pmk_r1(struct wpa_sm *sm, int akmp, const u8 *r1kh_id,
608 u8 *pmk_r1, size_t *pmk_r1_len, u8 *pmk_r1_name)
Hai Shalom60840252021-02-19 19:02:11 -0800609{
610 return -1;
611}
612
613#endif /* CONFIG_PASN */
614
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700615#endif /* CONFIG_IEEE80211R */
616
617
618/* tdls.c */
619void wpa_tdls_ap_ies(struct wpa_sm *sm, const u8 *ies, size_t len);
620void wpa_tdls_assoc_resp_ies(struct wpa_sm *sm, const u8 *ies, size_t len);
621int wpa_tdls_start(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt4b9d52f2013-02-05 17:44:43 -0800622void wpa_tdls_remove(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800623int wpa_tdls_teardown_link(struct wpa_sm *sm, const u8 *addr, u16 reason_code);
624int wpa_tdls_send_discovery_request(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700625int wpa_tdls_init(struct wpa_sm *sm);
Dmitry Shmidtf8623282013-02-20 14:34:59 -0800626void wpa_tdls_teardown_peers(struct wpa_sm *sm);
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700627void wpa_tdls_deinit(struct wpa_sm *sm);
628void wpa_tdls_enable(struct wpa_sm *sm, int enabled);
Dmitry Shmidt43cb5782014-06-16 16:23:22 -0700629void wpa_tdls_disable_unreachable_link(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidte0e48dc2013-11-18 12:00:06 -0800630const char * wpa_tdls_get_link_status(struct wpa_sm *sm, const u8 *addr);
Dmitry Shmidt1f69aa52012-01-24 16:10:04 -0800631int wpa_tdls_is_external_setup(struct wpa_sm *sm);
Dmitry Shmidtfb45fd52015-01-05 13:08:17 -0800632int wpa_tdls_enable_chan_switch(struct wpa_sm *sm, const u8 *addr,
633 u8 oper_class,
634 struct hostapd_freq_params *freq_params);
635int wpa_tdls_disable_chan_switch(struct wpa_sm *sm, const u8 *addr);
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000636int wpa_tdls_process_discovery_response(struct wpa_sm *sm, const u8 *addr,
637 const u8 *buf, size_t len);
Dmitry Shmidt4ae50e62016-06-27 13:48:39 -0700638#ifdef CONFIG_TDLS_TESTING
639extern unsigned int tdls_testing;
640#endif /* CONFIG_TDLS_TESTING */
641
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700642
Dmitry Shmidt61d9df32012-08-29 16:22:06 -0700643int wpa_wnmsleep_install_key(struct wpa_sm *sm, u8 subelem_id, u8 *buf);
Dmitry Shmidt55840ad2015-12-14 12:45:46 -0800644void wpa_sm_set_test_assoc_ie(struct wpa_sm *sm, struct wpabuf *buf);
Sunil Ravib0ac25f2024-07-12 01:42:03 +0000645void wpa_sm_set_test_eapol_m2_elems(struct wpa_sm *sm, struct wpabuf *buf);
646void wpa_sm_set_test_eapol_m4_elems(struct wpa_sm *sm, struct wpabuf *buf);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700647const u8 * wpa_sm_get_anonce(struct wpa_sm *sm);
Roshan Pius3a1667e2018-07-03 15:17:14 -0700648unsigned int wpa_sm_get_key_mgmt(struct wpa_sm *sm);
Dmitry Shmidt61d9df32012-08-29 16:22:06 -0700649
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700650struct wpabuf * fils_build_auth(struct wpa_sm *sm, int dh_group, const u8 *md);
651int fils_process_auth(struct wpa_sm *sm, const u8 *bssid, const u8 *data,
652 size_t len);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800653struct wpabuf * fils_build_assoc_req(struct wpa_sm *sm, const u8 **kek,
654 size_t *kek_len, const u8 **snonce,
Paul Stewart092955c2017-02-06 09:13:09 -0800655 const u8 **anonce,
656 const struct wpabuf **hlp,
657 unsigned int num_hlp);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800658int fils_process_assoc_resp(struct wpa_sm *sm, const u8 *resp, size_t len);
Dmitry Shmidtd2986c22017-10-23 14:22:09 -0700659
660struct wpabuf * owe_build_assoc_req(struct wpa_sm *sm, u16 group);
661int owe_process_assoc_resp(struct wpa_sm *sm, const u8 *bssid,
662 const u8 *resp_ies, size_t resp_ies_len);
663
664void wpa_sm_set_reset_fils_completed(struct wpa_sm *sm, int set);
665void wpa_sm_set_fils_cache_id(struct wpa_sm *sm, const u8 *fils_cache_id);
Hai Shalom021b0b52019-04-10 11:17:58 -0700666void wpa_sm_set_dpp_z(struct wpa_sm *sm, const struct wpabuf *z);
Sunil Ravi89eba102022-09-13 21:04:37 -0700667void wpa_pasn_sm_set_caps(struct wpa_sm *sm, unsigned int flags2);
Sunil Ravi77d572f2023-01-17 23:58:31 +0000668struct rsn_pmksa_cache * wpa_sm_get_pmksa_cache(struct wpa_sm *sm);
669
670void wpa_sm_set_cur_pmksa(struct wpa_sm *sm,
671 struct rsn_pmksa_cache_entry *entry);
672const u8 * wpa_sm_get_auth_addr(struct wpa_sm *sm);
Sunil Ravi2a14cf12023-11-21 00:54:38 +0000673void wpa_sm_set_driver_bss_selection(struct wpa_sm *sm,
674 bool driver_bss_selection);
Dmitry Shmidt9839ecd2016-11-07 11:05:47 -0800675
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -0700676#endif /* WPA_H */