2 * hostapd / Initialization and configuration
3 * Copyright (c) 2002-2014, Jouni Malinen <j@w1.fi>
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
14 #endif /* CONFIG_SQLITE */
16 #include "common/defs.h"
17 #include "utils/list.h"
18 #include "ap_config.h"
19 #include "drivers/driver.h"
21 #define OCE_STA_CFON_ENABLED(hapd) \
22 ((hapd->conf->oce & OCE_STA_CFON) && \
23 (hapd->iface->drv_flags & WPA_DRIVER_FLAGS_OCE_STA_CFON))
24 #define OCE_AP_ENABLED(hapd) \
25 ((hapd->conf->oce & OCE_AP) && \
26 (hapd->iface->drv_flags & WPA_DRIVER_FLAGS_OCE_AP))
29 struct radius_server_data
;
30 struct upnp_wps_device_sm
;
33 struct ieee80211_ht_capabilities
;
34 struct full_dynamic_vlan
;
39 #endif /* CONFIG_MESH */
43 struct hapd_interfaces
{
44 int (*reload_config
)(struct hostapd_iface
*iface
);
45 struct hostapd_config
* (*config_read_cb
)(const char *config_fname
);
46 int (*ctrl_iface_init
)(struct hostapd_data
*hapd
);
47 void (*ctrl_iface_deinit
)(struct hostapd_data
*hapd
);
48 int (*for_each_interface
)(struct hapd_interfaces
*interfaces
,
49 int (*cb
)(struct hostapd_iface
*iface
,
50 void *ctx
), void *ctx
);
51 int (*driver_init
)(struct hostapd_iface
*iface
);
55 struct dl_list global_ctrl_dst
;
56 char *global_iface_path
;
57 char *global_iface_name
;
58 #ifndef CONFIG_NATIVE_WINDOWS
59 gid_t ctrl_iface_group
;
60 #endif /* CONFIG_NATIVE_WINDOWS */
61 struct hostapd_iface
**iface
;
63 size_t terminate_on_error
;
64 #ifndef CONFIG_NO_VLAN
65 struct dynamic_iface
*vlan_priv
;
66 #endif /* CONFIG_NO_VLAN */
67 #ifdef CONFIG_ETH_P_OUI
68 struct dl_list eth_p_oui
; /* OUI Extended EtherType handlers */
69 #endif /* CONFIG_ETH_P_OUI */
70 int eloop_initialized
;
73 struct dpp_global
*dpp
;
74 #endif /* CONFIG_DPP */
77 enum hostapd_chan_status
{
78 HOSTAPD_CHAN_VALID
= 0, /* channel is ready */
79 HOSTAPD_CHAN_INVALID
= 1, /* no usable channel found */
80 HOSTAPD_CHAN_ACS
= 2, /* ACS work being performed */
83 struct hostapd_probereq_cb
{
84 int (*cb
)(void *ctx
, const u8
*sa
, const u8
*da
, const u8
*bssid
,
85 const u8
*ie
, size_t ie_len
, int ssi_signal
);
89 #define HOSTAPD_RATE_BASIC 0x00000001
91 struct hostapd_rate_data
{
92 int rate
; /* rate in 100 kbps */
93 int flags
; /* HOSTAPD_RATE_ flags */
96 struct hostapd_frame_info
{
100 int ssi_signal
; /* dBm */
104 WPS_STATUS_SUCCESS
= 1,
109 WPS_PBC_STATUS_DISABLE
,
110 WPS_PBC_STATUS_ACTIVE
,
111 WPS_PBC_STATUS_TIMEOUT
,
112 WPS_PBC_STATUS_OVERLAP
116 enum wps_status status
;
117 enum wps_error_indication failure_reason
;
118 enum pbc_status pbc_status
;
119 u8 peer_addr
[ETH_ALEN
];
122 struct hostapd_neighbor_entry
{
125 struct wpa_ssid_value ssid
;
128 struct wpabuf
*civic
;
129 /* LCI update time */
130 struct os_time lci_date
;
134 struct hostapd_sae_commit_queue
{
142 * struct hostapd_data - hostapd per-BSS data structure
144 struct hostapd_data
{
145 struct hostapd_iface
*iface
;
146 struct hostapd_config
*iconf
;
147 struct hostapd_bss_config
*conf
;
148 int interface_added
; /* virtual interface added for this BSS */
149 unsigned int started
:1;
150 unsigned int disabled
:1;
151 unsigned int reenable_beacon
:1;
153 u8 own_addr
[ETH_ALEN
];
155 int num_sta
; /* number of entries in sta_list */
156 struct sta_info
*sta_list
; /* STA info list head */
157 #define STA_HASH_SIZE 256
158 #define STA_HASH(sta) (sta[5])
159 struct sta_info
*sta_hash
[STA_HASH_SIZE
];
162 * Bitfield for indicating which AIDs are allocated. Only AID values
163 * 1-2007 are used and as such, the bit at index 0 corresponds to AID
166 #define AID_WORDS ((2008 + 31) / 32)
167 u32 sta_aid
[AID_WORDS
];
169 const struct wpa_driver_ops
*driver
;
172 void (*new_assoc_sta_cb
)(struct hostapd_data
*hapd
,
173 struct sta_info
*sta
, int reassoc
);
175 void *msg_ctx
; /* ctx for wpa_msg() calls */
176 void *msg_ctx_parent
; /* parent interface ctx for wpa_msg() calls */
178 struct radius_client_data
*radius
;
180 struct radius_das_data
*radius_das
;
182 struct hostapd_cached_radius_acl
*acl_cache
;
183 struct hostapd_acl_query_data
*acl_queries
;
185 struct wpa_authenticator
*wpa_auth
;
186 struct eapol_authenticator
*eapol_auth
;
187 struct eap_config
*eap_cfg
;
189 struct rsn_preauth_interface
*preauth_iface
;
190 struct os_reltime michael_mic_failure
;
191 int michael_mic_failures
;
192 int tkip_countermeasures
;
195 struct dl_list ctrl_dst
;
198 void *eap_sim_db_priv
;
199 struct radius_server_data
*radius_srv
;
200 struct dl_list erp_keys
; /* struct eap_server_erp_key */
202 int parameter_set_count
;
204 /* Time Advertisement */
205 u8 time_update_counter
;
206 struct wpabuf
*time_adv
;
208 #ifdef CONFIG_FULL_DYNAMIC_VLAN
209 struct full_dynamic_vlan
*full_dynamic_vlan
;
210 #endif /* CONFIG_FULL_DYNAMIC_VLAN */
212 struct l2_packet_data
*l2
;
214 #ifdef CONFIG_IEEE80211R_AP
215 struct dl_list l2_queue
;
216 struct dl_list l2_oui_queue
;
217 struct eth_p_oui_ctx
*oui_pull
;
218 struct eth_p_oui_ctx
*oui_resp
;
219 struct eth_p_oui_ctx
*oui_push
;
220 struct eth_p_oui_ctx
*oui_sreq
;
221 struct eth_p_oui_ctx
*oui_sresp
;
222 #endif /* CONFIG_IEEE80211R_AP */
224 struct wps_context
*wps
;
227 struct wpabuf
*wps_beacon_ie
;
228 struct wpabuf
*wps_probe_resp_ie
;
230 unsigned int ap_pin_failures
;
231 unsigned int ap_pin_failures_consecutive
;
232 struct upnp_wps_device_sm
*wps_upnp
;
233 unsigned int ap_pin_lockout_time
;
235 struct wps_stat wps_stats
;
236 #endif /* CONFIG_WPS */
239 struct ieee802_1x_kay
*kay
;
240 #endif /* CONFIG_MACSEC */
242 struct hostapd_probereq_cb
*probereq_cb
;
243 size_t num_probereq_cb
;
245 void (*public_action_cb
)(void *ctx
, const u8
*buf
, size_t len
,
247 void *public_action_cb_ctx
;
248 void (*public_action_cb2
)(void *ctx
, const u8
*buf
, size_t len
,
250 void *public_action_cb2_ctx
;
252 int (*vendor_action_cb
)(void *ctx
, const u8
*buf
, size_t len
,
254 void *vendor_action_cb_ctx
;
256 void (*wps_reg_success_cb
)(void *ctx
, const u8
*mac_addr
,
258 void *wps_reg_success_cb_ctx
;
260 void (*wps_event_cb
)(void *ctx
, enum wps_event event
,
261 union wps_event_data
*data
);
262 void *wps_event_cb_ctx
;
264 void (*sta_authorized_cb
)(void *ctx
, const u8
*mac_addr
,
265 int authorized
, const u8
*p2p_dev_addr
);
266 void *sta_authorized_cb_ctx
;
268 void (*setup_complete_cb
)(void *ctx
);
269 void *setup_complete_cb_ctx
;
271 void (*new_psk_cb
)(void *ctx
, const u8
*mac_addr
,
272 const u8
*p2p_dev_addr
, const u8
*psk
,
274 void *new_psk_cb_ctx
;
276 /* channel switch parameters */
277 struct hostapd_freq_params cs_freq_params
;
280 unsigned int cs_c_off_beacon
;
281 unsigned int cs_c_off_proberesp
;
283 unsigned int cs_c_off_ecsa_beacon
;
284 unsigned int cs_c_off_ecsa_proberesp
;
287 struct p2p_data
*p2p
;
288 struct p2p_group
*p2p_group
;
289 struct wpabuf
*p2p_beacon_ie
;
290 struct wpabuf
*p2p_probe_resp_ie
;
292 /* Number of non-P2P association stations */
295 /* Periodic NoA (used only when no non-P2P clients in the group) */
299 #endif /* CONFIG_P2P */
300 #ifdef CONFIG_PROXYARP
301 struct l2_packet_data
*sock_dhcp
;
302 struct l2_packet_data
*sock_ndisc
;
303 #endif /* CONFIG_PROXYARP */
307 void (*mesh_sta_free_cb
)(struct hostapd_data
*hapd
,
308 struct sta_info
*sta
);
309 struct wpabuf
*mesh_pending_auth
;
310 struct os_reltime mesh_pending_auth_time
;
311 u8 mesh_required_peer
[ETH_ALEN
];
312 #endif /* CONFIG_MESH */
315 struct hostapd_eap_user tmp_eap_user
;
316 #endif /* CONFIG_SQLITE */
319 /** Key used for generating SAE anti-clogging tokens */
321 struct os_reltime last_sae_token_key_update
;
323 u16 sae_pending_token_idx
[256];
324 int dot11RSNASAERetransPeriod
; /* msec */
325 struct dl_list sae_commit_queue
; /* struct hostapd_sae_commit_queue */
326 #endif /* CONFIG_SAE */
328 #ifdef CONFIG_TESTING_OPTIONS
329 unsigned int ext_mgmt_frame_handling
:1;
330 unsigned int ext_eapol_frame_io
:1;
332 struct l2_packet_data
*l2_test
;
334 enum wpa_alg last_gtk_alg
;
335 int last_gtk_key_idx
;
336 u8 last_gtk
[WPA_GTK_MAX_LEN
];
339 enum wpa_alg last_igtk_alg
;
340 int last_igtk_key_idx
;
341 u8 last_igtk
[WPA_IGTK_MAX_LEN
];
342 size_t last_igtk_len
;
343 #endif /* CONFIG_TESTING_OPTIONS */
346 unsigned int mbo_assoc_disallow
;
347 #endif /* CONFIG_MBO */
349 struct dl_list nr_db
;
354 unsigned int lci_req_active
:1;
355 unsigned int range_req_active
:1;
357 int dhcp_sock
; /* UDP socket used with the DHCP server */
361 struct dpp_authentication
*dpp_auth
;
362 u8 dpp_allowed_roles
;
364 int dpp_auth_ok_on_ack
;
365 int dpp_in_response_listen
;
366 struct gas_query_ap
*gas
;
367 struct dpp_pkex
*dpp_pkex
;
368 struct dpp_bootstrap_info
*dpp_pkex_bi
;
370 char *dpp_pkex_identifier
;
371 char *dpp_pkex_auth_cmd
;
372 char *dpp_configurator_params
;
373 struct os_reltime dpp_last_init
;
374 struct os_reltime dpp_init_iter_start
;
375 unsigned int dpp_init_max_tries
;
376 unsigned int dpp_init_retry_time
;
377 unsigned int dpp_resp_wait_time
;
378 unsigned int dpp_resp_max_tries
;
379 unsigned int dpp_resp_retry_time
;
380 #ifdef CONFIG_TESTING_OPTIONS
381 char *dpp_config_obj_override
;
382 char *dpp_discovery_override
;
383 char *dpp_groups_override
;
384 unsigned int dpp_ignore_netaccesskey_mismatch
:1;
385 #endif /* CONFIG_TESTING_OPTIONS */
386 #endif /* CONFIG_DPP */
388 #ifdef CONFIG_AIRTIME_POLICY
389 unsigned int num_backlogged_sta
;
390 unsigned int airtime_weight
;
391 #endif /* CONFIG_AIRTIME_POLICY */
393 u8 last_1x_eapol_key_replay_counter
[8];
396 sqlite3
*rad_attr_db
;
397 #endif /* CONFIG_SQLITE */
401 struct hostapd_sta_info
{
404 struct os_reltime last_seen
;
406 #ifdef CONFIG_TAXONOMY
407 struct wpabuf
*probe_ie_taxonomy
;
408 #endif /* CONFIG_TAXONOMY */
412 * struct hostapd_iface - hostapd per-interface data structure
414 struct hostapd_iface
{
415 struct hapd_interfaces
*interfaces
;
418 struct hostapd_config
*conf
;
419 char phy
[16]; /* Name of the PHY (radio) */
421 enum hostapd_iface_state
{
422 HAPD_IFACE_UNINITIALIZED
,
424 HAPD_IFACE_COUNTRY_UPDATE
,
432 struct mesh_conf
*mconf
;
433 #endif /* CONFIG_MESH */
436 struct hostapd_data
**bss
;
438 unsigned int wait_channel_update
:1;
439 unsigned int cac_started
:1;
441 struct fst_iface
*fst
;
442 const struct wpabuf
*fst_ies
;
443 #endif /* CONFIG_FST */
446 * When set, indicates that the driver will handle the AP
447 * teardown: delete global keys, station keys, and stations.
449 unsigned int driver_ap_teardown
:1;
452 * When set, indicates that this interface is part of list of
453 * interfaces that need to be started together (synchronously).
455 unsigned int need_to_start_in_sync
:1;
457 /* Ready to start but waiting for other interfaces to become ready. */
458 unsigned int ready_to_start_in_sync
:1;
460 int num_ap
; /* number of entries in ap_list */
461 struct ap_info
*ap_list
; /* AP info list head */
462 struct ap_info
*ap_hash
[STA_HASH_SIZE
];
467 * A bitmap of supported protocols for probe response offload. See
468 * struct wpa_driver_capa in driver.h
470 unsigned int probe_resp_offloads
;
472 /* extended capabilities supported by the driver */
473 const u8
*extended_capa
, *extended_capa_mask
;
474 unsigned int extended_capa_len
;
476 unsigned int drv_max_acl_mac_addrs
;
478 struct hostapd_hw_modes
*hw_features
;
480 struct hostapd_hw_modes
*current_mode
;
481 /* Rates that are currently used (i.e., filtered copy of
482 * current_mode->channels */
484 struct hostapd_rate_data
*current_rates
;
490 /* Number of associated Non-ERP stations (i.e., stations using 802.11b
494 /* Number of associated stations that do not support Short Slot Time */
495 int num_sta_no_short_slot_time
;
497 /* Number of associated stations that do not support Short Preamble */
498 int num_sta_no_short_preamble
;
500 int olbc
; /* Overlapping Legacy BSS Condition */
502 /* Number of HT associated stations that do not support greenfield */
503 int num_sta_ht_no_gf
;
505 /* Number of associated non-HT stations */
508 /* Number of HT associated stations 20 MHz */
509 int num_sta_ht_20mhz
;
511 /* Number of HT40 intolerant stations */
512 int num_sta_ht40_intolerant
;
514 /* Overlapping BSS information */
519 /* surveying helpers */
521 /* number of channels surveyed */
522 unsigned int chans_surveyed
;
524 /* lowest observed noise floor in dBm */
527 /* channel utilization calculation */
528 u64 last_channel_time
;
529 u64 last_channel_time_busy
;
530 u8 channel_utilization
;
532 unsigned int chan_util_samples_sum
;
533 unsigned int chan_util_num_sample_periods
;
534 unsigned int chan_util_average
;
536 /* eCSA IE will be added only if operating class is specified */
539 unsigned int dfs_cac_ms
;
540 struct os_reltime dfs_cac_start
;
542 /* Latched with the actual secondary channel information and will be
543 * used while juggling between HT20 and HT40 modes. */
547 unsigned int acs_num_completed_scans
;
548 #endif /* CONFIG_ACS */
550 void (*scan_cb
)(struct hostapd_iface
*iface
);
551 int num_ht40_scan_tries
;
553 struct dl_list sta_seen
; /* struct hostapd_sta_info */
554 unsigned int num_sta_seen
;
557 #ifdef CONFIG_AIRTIME_POLICY
558 unsigned int airtime_quantum
;
559 #endif /* CONFIG_AIRTIME_POLICY */
561 /* Previous WMM element information */
562 struct hostapd_wmm_ac_params prev_wmm
[WMM_AC_NUM
];
566 int hostapd_for_each_interface(struct hapd_interfaces
*interfaces
,
567 int (*cb
)(struct hostapd_iface
*iface
,
568 void *ctx
), void *ctx
);
569 int hostapd_reload_config(struct hostapd_iface
*iface
);
570 void hostapd_reconfig_encryption(struct hostapd_data
*hapd
);
571 struct hostapd_data
*
572 hostapd_alloc_bss_data(struct hostapd_iface
*hapd_iface
,
573 struct hostapd_config
*conf
,
574 struct hostapd_bss_config
*bss
);
575 int hostapd_setup_interface(struct hostapd_iface
*iface
);
576 int hostapd_setup_interface_complete(struct hostapd_iface
*iface
, int err
);
577 void hostapd_interface_deinit(struct hostapd_iface
*iface
);
578 void hostapd_interface_free(struct hostapd_iface
*iface
);
579 struct hostapd_iface
* hostapd_alloc_iface(void);
580 struct hostapd_iface
* hostapd_init(struct hapd_interfaces
*interfaces
,
581 const char *config_file
);
582 struct hostapd_iface
*
583 hostapd_interface_init_bss(struct hapd_interfaces
*interfaces
, const char *phy
,
584 const char *config_fname
, int debug
);
585 void hostapd_new_assoc_sta(struct hostapd_data
*hapd
, struct sta_info
*sta
,
587 void hostapd_interface_deinit_free(struct hostapd_iface
*iface
);
588 int hostapd_enable_iface(struct hostapd_iface
*hapd_iface
);
589 int hostapd_reload_iface(struct hostapd_iface
*hapd_iface
);
590 int hostapd_disable_iface(struct hostapd_iface
*hapd_iface
);
591 int hostapd_add_iface(struct hapd_interfaces
*ifaces
, char *buf
);
592 int hostapd_remove_iface(struct hapd_interfaces
*ifaces
, char *buf
);
593 void hostapd_channel_list_updated(struct hostapd_iface
*iface
, int initiator
);
594 void hostapd_set_state(struct hostapd_iface
*iface
, enum hostapd_iface_state s
);
595 const char * hostapd_state_text(enum hostapd_iface_state s
);
596 int hostapd_csa_in_progress(struct hostapd_iface
*iface
);
597 void hostapd_chan_switch_vht_config(struct hostapd_data
*hapd
, int vht_enabled
);
598 int hostapd_switch_channel(struct hostapd_data
*hapd
,
599 struct csa_settings
*settings
);
601 hostapd_switch_channel_fallback(struct hostapd_iface
*iface
,
602 const struct hostapd_freq_params
*freq_params
);
603 void hostapd_cleanup_cs_params(struct hostapd_data
*hapd
);
604 void hostapd_periodic_iface(struct hostapd_iface
*iface
);
605 int hostapd_owe_trans_get_info(struct hostapd_data
*hapd
);
608 int hostapd_register_probereq_cb(struct hostapd_data
*hapd
,
609 int (*cb
)(void *ctx
, const u8
*sa
,
610 const u8
*da
, const u8
*bssid
,
611 const u8
*ie
, size_t ie_len
,
614 void hostapd_prune_associations(struct hostapd_data
*hapd
, const u8
*addr
);
616 /* drv_callbacks.c (TODO: move to somewhere else?) */
617 void hostapd_notify_assoc_fils_finish(struct hostapd_data
*hapd
,
618 struct sta_info
*sta
);
619 int hostapd_notif_assoc(struct hostapd_data
*hapd
, const u8
*addr
,
620 const u8
*ie
, size_t ielen
, int reassoc
);
621 void hostapd_notif_disassoc(struct hostapd_data
*hapd
, const u8
*addr
);
622 void hostapd_event_sta_low_ack(struct hostapd_data
*hapd
, const u8
*addr
);
623 void hostapd_event_connect_failed_reason(struct hostapd_data
*hapd
,
624 const u8
*addr
, int reason_code
);
625 int hostapd_probe_req_rx(struct hostapd_data
*hapd
, const u8
*sa
, const u8
*da
,
626 const u8
*bssid
, const u8
*ie
, size_t ie_len
,
628 void hostapd_event_ch_switch(struct hostapd_data
*hapd
, int freq
, int ht
,
629 int offset
, int width
, int cf1
, int cf2
,
631 struct survey_results
;
632 void hostapd_event_get_survey(struct hostapd_iface
*iface
,
633 struct survey_results
*survey_results
);
634 void hostapd_acs_channel_selected(struct hostapd_data
*hapd
,
635 struct acs_selected_channels
*acs_res
);
637 const struct hostapd_eap_user
*
638 hostapd_get_eap_user(struct hostapd_data
*hapd
, const u8
*identity
,
639 size_t identity_len
, int phase2
);
641 struct hostapd_data
* hostapd_get_iface(struct hapd_interfaces
*interfaces
,
643 void hostapd_event_sta_opmode_changed(struct hostapd_data
*hapd
, const u8
*addr
,
644 enum smps_mode smps_mode
,
645 enum chan_width chan_width
, u8 rx_nss
);
648 void fst_hostapd_fill_iface_obj(struct hostapd_data
*hapd
,
649 struct fst_wpa_obj
*iface_obj
);
650 #endif /* CONFIG_FST */
652 #endif /* HOSTAPD_H */