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.
12 #include "common/defs.h"
13 #include "utils/list.h"
14 #include "ap_config.h"
15 #include "drivers/driver.h"
18 struct radius_server_data
;
19 struct upnp_wps_device_sm
;
22 struct ieee80211_ht_capabilities
;
23 struct full_dynamic_vlan
;
28 #endif /* CONFIG_MESH */
32 struct hapd_interfaces
{
33 int (*reload_config
)(struct hostapd_iface
*iface
);
34 struct hostapd_config
* (*config_read_cb
)(const char *config_fname
);
35 int (*ctrl_iface_init
)(struct hostapd_data
*hapd
);
36 void (*ctrl_iface_deinit
)(struct hostapd_data
*hapd
);
37 int (*for_each_interface
)(struct hapd_interfaces
*interfaces
,
38 int (*cb
)(struct hostapd_iface
*iface
,
39 void *ctx
), void *ctx
);
40 int (*driver_init
)(struct hostapd_iface
*iface
);
44 struct dl_list global_ctrl_dst
;
45 char *global_iface_path
;
46 char *global_iface_name
;
47 #ifndef CONFIG_NATIVE_WINDOWS
48 gid_t ctrl_iface_group
;
49 #endif /* CONFIG_NATIVE_WINDOWS */
50 struct hostapd_iface
**iface
;
52 size_t terminate_on_error
;
53 #ifndef CONFIG_NO_VLAN
54 struct dynamic_iface
*vlan_priv
;
55 #endif /* CONFIG_NO_VLAN */
56 #ifdef CONFIG_ETH_P_OUI
57 struct dl_list eth_p_oui
; /* OUI Extended EtherType handlers */
58 #endif /* CONFIG_ETH_P_OUI */
59 int eloop_initialized
;
62 enum hostapd_chan_status
{
63 HOSTAPD_CHAN_VALID
= 0, /* channel is ready */
64 HOSTAPD_CHAN_INVALID
= 1, /* no usable channel found */
65 HOSTAPD_CHAN_ACS
= 2, /* ACS work being performed */
68 struct hostapd_probereq_cb
{
69 int (*cb
)(void *ctx
, const u8
*sa
, const u8
*da
, const u8
*bssid
,
70 const u8
*ie
, size_t ie_len
, int ssi_signal
);
74 #define HOSTAPD_RATE_BASIC 0x00000001
76 struct hostapd_rate_data
{
77 int rate
; /* rate in 100 kbps */
78 int flags
; /* HOSTAPD_RATE_ flags */
81 struct hostapd_frame_info
{
84 int ssi_signal
; /* dBm */
88 WPS_STATUS_SUCCESS
= 1,
93 WPS_PBC_STATUS_DISABLE
,
94 WPS_PBC_STATUS_ACTIVE
,
95 WPS_PBC_STATUS_TIMEOUT
,
96 WPS_PBC_STATUS_OVERLAP
100 enum wps_status status
;
101 enum wps_error_indication failure_reason
;
102 enum pbc_status pbc_status
;
103 u8 peer_addr
[ETH_ALEN
];
106 struct hostapd_neighbor_entry
{
109 struct wpa_ssid_value ssid
;
112 struct wpabuf
*civic
;
113 /* LCI update time */
114 struct os_time lci_date
;
119 * struct hostapd_data - hostapd per-BSS data structure
121 struct hostapd_data
{
122 struct hostapd_iface
*iface
;
123 struct hostapd_config
*iconf
;
124 struct hostapd_bss_config
*conf
;
125 int interface_added
; /* virtual interface added for this BSS */
126 unsigned int started
:1;
127 unsigned int disabled
:1;
128 unsigned int reenable_beacon
:1;
130 u8 own_addr
[ETH_ALEN
];
132 int num_sta
; /* number of entries in sta_list */
133 struct sta_info
*sta_list
; /* STA info list head */
134 #define STA_HASH_SIZE 256
135 #define STA_HASH(sta) (sta[5])
136 struct sta_info
*sta_hash
[STA_HASH_SIZE
];
139 * Bitfield for indicating which AIDs are allocated. Only AID values
140 * 1-2007 are used and as such, the bit at index 0 corresponds to AID
143 #define AID_WORDS ((2008 + 31) / 32)
144 u32 sta_aid
[AID_WORDS
];
146 const struct wpa_driver_ops
*driver
;
149 void (*new_assoc_sta_cb
)(struct hostapd_data
*hapd
,
150 struct sta_info
*sta
, int reassoc
);
152 void *msg_ctx
; /* ctx for wpa_msg() calls */
153 void *msg_ctx_parent
; /* parent interface ctx for wpa_msg() calls */
155 struct radius_client_data
*radius
;
157 struct radius_das_data
*radius_das
;
159 struct iapp_data
*iapp
;
161 struct hostapd_cached_radius_acl
*acl_cache
;
162 struct hostapd_acl_query_data
*acl_queries
;
164 struct wpa_authenticator
*wpa_auth
;
165 struct eapol_authenticator
*eapol_auth
;
167 struct rsn_preauth_interface
*preauth_iface
;
168 struct os_reltime michael_mic_failure
;
169 int michael_mic_failures
;
170 int tkip_countermeasures
;
173 struct dl_list ctrl_dst
;
176 void *eap_sim_db_priv
;
177 struct radius_server_data
*radius_srv
;
178 struct dl_list erp_keys
; /* struct eap_server_erp_key */
180 int parameter_set_count
;
182 /* Time Advertisement */
183 u8 time_update_counter
;
184 struct wpabuf
*time_adv
;
186 #ifdef CONFIG_FULL_DYNAMIC_VLAN
187 struct full_dynamic_vlan
*full_dynamic_vlan
;
188 #endif /* CONFIG_FULL_DYNAMIC_VLAN */
190 struct l2_packet_data
*l2
;
192 #ifdef CONFIG_IEEE80211R_AP
193 struct dl_list l2_queue
;
194 struct dl_list l2_oui_queue
;
195 struct eth_p_oui_ctx
*oui_pull
;
196 struct eth_p_oui_ctx
*oui_resp
;
197 struct eth_p_oui_ctx
*oui_push
;
198 struct eth_p_oui_ctx
*oui_sreq
;
199 struct eth_p_oui_ctx
*oui_sresp
;
200 #endif /* CONFIG_IEEE80211R_AP */
202 struct wps_context
*wps
;
205 struct wpabuf
*wps_beacon_ie
;
206 struct wpabuf
*wps_probe_resp_ie
;
208 unsigned int ap_pin_failures
;
209 unsigned int ap_pin_failures_consecutive
;
210 struct upnp_wps_device_sm
*wps_upnp
;
211 unsigned int ap_pin_lockout_time
;
213 struct wps_stat wps_stats
;
214 #endif /* CONFIG_WPS */
216 struct hostapd_probereq_cb
*probereq_cb
;
217 size_t num_probereq_cb
;
219 void (*public_action_cb
)(void *ctx
, const u8
*buf
, size_t len
,
221 void *public_action_cb_ctx
;
222 void (*public_action_cb2
)(void *ctx
, const u8
*buf
, size_t len
,
224 void *public_action_cb2_ctx
;
226 int (*vendor_action_cb
)(void *ctx
, const u8
*buf
, size_t len
,
228 void *vendor_action_cb_ctx
;
230 void (*wps_reg_success_cb
)(void *ctx
, const u8
*mac_addr
,
232 void *wps_reg_success_cb_ctx
;
234 void (*wps_event_cb
)(void *ctx
, enum wps_event event
,
235 union wps_event_data
*data
);
236 void *wps_event_cb_ctx
;
238 void (*sta_authorized_cb
)(void *ctx
, const u8
*mac_addr
,
239 int authorized
, const u8
*p2p_dev_addr
);
240 void *sta_authorized_cb_ctx
;
242 void (*setup_complete_cb
)(void *ctx
);
243 void *setup_complete_cb_ctx
;
245 void (*new_psk_cb
)(void *ctx
, const u8
*mac_addr
,
246 const u8
*p2p_dev_addr
, const u8
*psk
,
248 void *new_psk_cb_ctx
;
250 /* channel switch parameters */
251 struct hostapd_freq_params cs_freq_params
;
254 unsigned int cs_c_off_beacon
;
255 unsigned int cs_c_off_proberesp
;
257 unsigned int cs_c_off_ecsa_beacon
;
258 unsigned int cs_c_off_ecsa_proberesp
;
261 unsigned int bss_load_update_timeout
;
264 struct p2p_data
*p2p
;
265 struct p2p_group
*p2p_group
;
266 struct wpabuf
*p2p_beacon_ie
;
267 struct wpabuf
*p2p_probe_resp_ie
;
269 /* Number of non-P2P association stations */
272 /* Periodic NoA (used only when no non-P2P clients in the group) */
276 #endif /* CONFIG_P2P */
277 #ifdef CONFIG_PROXYARP
278 struct l2_packet_data
*sock_dhcp
;
279 struct l2_packet_data
*sock_ndisc
;
280 #endif /* CONFIG_PROXYARP */
284 void (*mesh_sta_free_cb
)(struct hostapd_data
*hapd
,
285 struct sta_info
*sta
);
286 struct wpabuf
*mesh_pending_auth
;
287 struct os_reltime mesh_pending_auth_time
;
288 u8 mesh_required_peer
[ETH_ALEN
];
289 #endif /* CONFIG_MESH */
292 struct hostapd_eap_user tmp_eap_user
;
293 #endif /* CONFIG_SQLITE */
296 /** Key used for generating SAE anti-clogging tokens */
298 struct os_reltime last_sae_token_key_update
;
299 int dot11RSNASAERetransPeriod
; /* msec */
300 #endif /* CONFIG_SAE */
302 #ifdef CONFIG_TESTING_OPTIONS
303 unsigned int ext_mgmt_frame_handling
:1;
304 unsigned int ext_eapol_frame_io
:1;
306 struct l2_packet_data
*l2_test
;
308 enum wpa_alg last_gtk_alg
;
309 int last_gtk_key_idx
;
310 u8 last_gtk
[WPA_GTK_MAX_LEN
];
313 #ifdef CONFIG_IEEE80211W
314 enum wpa_alg last_igtk_alg
;
315 int last_igtk_key_idx
;
316 u8 last_igtk
[WPA_IGTK_MAX_LEN
];
317 size_t last_igtk_len
;
318 #endif /* CONFIG_IEEE80211W */
319 #endif /* CONFIG_TESTING_OPTIONS */
322 unsigned int mbo_assoc_disallow
;
324 * enable_oce - Enable OCE if it is enabled by user and device also
328 #endif /* CONFIG_MBO */
330 struct dl_list nr_db
;
335 unsigned int lci_req_active
:1;
336 unsigned int range_req_active
:1;
338 int dhcp_sock
; /* UDP socket used with the DHCP server */
341 struct dl_list dpp_bootstrap
; /* struct dpp_bootstrap_info */
342 struct dl_list dpp_configurator
; /* struct dpp_configurator */
344 struct dpp_authentication
*dpp_auth
;
345 u8 dpp_allowed_roles
;
347 int dpp_auth_ok_on_ack
;
348 struct gas_query_ap
*gas
;
349 struct dpp_pkex
*dpp_pkex
;
350 struct dpp_bootstrap_info
*dpp_pkex_bi
;
352 char *dpp_pkex_identifier
;
353 char *dpp_pkex_auth_cmd
;
354 char *dpp_configurator_params
;
355 #ifdef CONFIG_TESTING_OPTIONS
356 char *dpp_config_obj_override
;
357 char *dpp_discovery_override
;
358 char *dpp_groups_override
;
359 unsigned int dpp_ignore_netaccesskey_mismatch
:1;
360 #endif /* CONFIG_TESTING_OPTIONS */
361 #endif /* CONFIG_DPP */
365 struct hostapd_sta_info
{
368 struct os_reltime last_seen
;
370 #ifdef CONFIG_TAXONOMY
371 struct wpabuf
*probe_ie_taxonomy
;
372 #endif /* CONFIG_TAXONOMY */
376 * struct hostapd_iface - hostapd per-interface data structure
378 struct hostapd_iface
{
379 struct hapd_interfaces
*interfaces
;
382 struct hostapd_config
*conf
;
383 char phy
[16]; /* Name of the PHY (radio) */
385 enum hostapd_iface_state
{
386 HAPD_IFACE_UNINITIALIZED
,
388 HAPD_IFACE_COUNTRY_UPDATE
,
396 struct mesh_conf
*mconf
;
397 #endif /* CONFIG_MESH */
400 struct hostapd_data
**bss
;
402 unsigned int wait_channel_update
:1;
403 unsigned int cac_started
:1;
405 struct fst_iface
*fst
;
406 const struct wpabuf
*fst_ies
;
407 #endif /* CONFIG_FST */
410 * When set, indicates that the driver will handle the AP
411 * teardown: delete global keys, station keys, and stations.
413 unsigned int driver_ap_teardown
:1;
416 * When set, indicates that this interface is part of list of
417 * interfaces that need to be started together (synchronously).
419 unsigned int need_to_start_in_sync
:1;
421 /* Ready to start but waiting for other interfaces to become ready. */
422 unsigned int ready_to_start_in_sync
:1;
424 int num_ap
; /* number of entries in ap_list */
425 struct ap_info
*ap_list
; /* AP info list head */
426 struct ap_info
*ap_hash
[STA_HASH_SIZE
];
430 /* SMPS modes supported by the driver (WPA_DRIVER_SMPS_MODE_*) */
431 unsigned int smps_modes
;
434 * A bitmap of supported protocols for probe response offload. See
435 * struct wpa_driver_capa in driver.h
437 unsigned int probe_resp_offloads
;
439 /* extended capabilities supported by the driver */
440 const u8
*extended_capa
, *extended_capa_mask
;
441 unsigned int extended_capa_len
;
443 unsigned int drv_max_acl_mac_addrs
;
445 struct hostapd_hw_modes
*hw_features
;
447 struct hostapd_hw_modes
*current_mode
;
448 /* Rates that are currently used (i.e., filtered copy of
449 * current_mode->channels */
451 struct hostapd_rate_data
*current_rates
;
457 /* Number of associated Non-ERP stations (i.e., stations using 802.11b
461 /* Number of associated stations that do not support Short Slot Time */
462 int num_sta_no_short_slot_time
;
464 /* Number of associated stations that do not support Short Preamble */
465 int num_sta_no_short_preamble
;
467 int olbc
; /* Overlapping Legacy BSS Condition */
469 /* Number of HT associated stations that do not support greenfield */
470 int num_sta_ht_no_gf
;
472 /* Number of associated non-HT stations */
475 /* Number of HT associated stations 20 MHz */
476 int num_sta_ht_20mhz
;
478 /* Number of HT40 intolerant stations */
479 int num_sta_ht40_intolerant
;
481 /* Overlapping BSS information */
486 /* surveying helpers */
488 /* number of channels surveyed */
489 unsigned int chans_surveyed
;
491 /* lowest observed noise floor in dBm */
494 /* channel utilization calculation */
495 u64 last_channel_time
;
496 u64 last_channel_time_busy
;
497 u8 channel_utilization
;
499 /* eCSA IE will be added only if operating class is specified */
502 unsigned int dfs_cac_ms
;
503 struct os_reltime dfs_cac_start
;
505 /* Latched with the actual secondary channel information and will be
506 * used while juggling between HT20 and HT40 modes. */
510 unsigned int acs_num_completed_scans
;
511 #endif /* CONFIG_ACS */
513 void (*scan_cb
)(struct hostapd_iface
*iface
);
514 int num_ht40_scan_tries
;
516 struct dl_list sta_seen
; /* struct hostapd_sta_info */
517 unsigned int num_sta_seen
;
523 int hostapd_for_each_interface(struct hapd_interfaces
*interfaces
,
524 int (*cb
)(struct hostapd_iface
*iface
,
525 void *ctx
), void *ctx
);
526 int hostapd_reload_config(struct hostapd_iface
*iface
);
527 struct hostapd_data
*
528 hostapd_alloc_bss_data(struct hostapd_iface
*hapd_iface
,
529 struct hostapd_config
*conf
,
530 struct hostapd_bss_config
*bss
);
531 int hostapd_setup_interface(struct hostapd_iface
*iface
);
532 int hostapd_setup_interface_complete(struct hostapd_iface
*iface
, int err
);
533 void hostapd_interface_deinit(struct hostapd_iface
*iface
);
534 void hostapd_interface_free(struct hostapd_iface
*iface
);
535 struct hostapd_iface
* hostapd_alloc_iface(void);
536 struct hostapd_iface
* hostapd_init(struct hapd_interfaces
*interfaces
,
537 const char *config_file
);
538 struct hostapd_iface
*
539 hostapd_interface_init_bss(struct hapd_interfaces
*interfaces
, const char *phy
,
540 const char *config_fname
, int debug
);
541 void hostapd_new_assoc_sta(struct hostapd_data
*hapd
, struct sta_info
*sta
,
543 void hostapd_interface_deinit_free(struct hostapd_iface
*iface
);
544 int hostapd_enable_iface(struct hostapd_iface
*hapd_iface
);
545 int hostapd_reload_iface(struct hostapd_iface
*hapd_iface
);
546 int hostapd_disable_iface(struct hostapd_iface
*hapd_iface
);
547 int hostapd_add_iface(struct hapd_interfaces
*ifaces
, char *buf
);
548 int hostapd_remove_iface(struct hapd_interfaces
*ifaces
, char *buf
);
549 void hostapd_channel_list_updated(struct hostapd_iface
*iface
, int initiator
);
550 void hostapd_set_state(struct hostapd_iface
*iface
, enum hostapd_iface_state s
);
551 const char * hostapd_state_text(enum hostapd_iface_state s
);
552 int hostapd_csa_in_progress(struct hostapd_iface
*iface
);
553 int hostapd_switch_channel(struct hostapd_data
*hapd
,
554 struct csa_settings
*settings
);
556 hostapd_switch_channel_fallback(struct hostapd_iface
*iface
,
557 const struct hostapd_freq_params
*freq_params
);
558 void hostapd_cleanup_cs_params(struct hostapd_data
*hapd
);
559 void hostapd_periodic_iface(struct hostapd_iface
*iface
);
560 int hostapd_owe_trans_get_info(struct hostapd_data
*hapd
);
563 int hostapd_register_probereq_cb(struct hostapd_data
*hapd
,
564 int (*cb
)(void *ctx
, const u8
*sa
,
565 const u8
*da
, const u8
*bssid
,
566 const u8
*ie
, size_t ie_len
,
569 void hostapd_prune_associations(struct hostapd_data
*hapd
, const u8
*addr
);
571 /* drv_callbacks.c (TODO: move to somewhere else?) */
572 void hostapd_notify_assoc_fils_finish(struct hostapd_data
*hapd
,
573 struct sta_info
*sta
);
574 int hostapd_notif_assoc(struct hostapd_data
*hapd
, const u8
*addr
,
575 const u8
*ie
, size_t ielen
, int reassoc
);
576 void hostapd_notif_disassoc(struct hostapd_data
*hapd
, const u8
*addr
);
577 void hostapd_event_sta_low_ack(struct hostapd_data
*hapd
, const u8
*addr
);
578 void hostapd_event_connect_failed_reason(struct hostapd_data
*hapd
,
579 const u8
*addr
, int reason_code
);
580 int hostapd_probe_req_rx(struct hostapd_data
*hapd
, const u8
*sa
, const u8
*da
,
581 const u8
*bssid
, const u8
*ie
, size_t ie_len
,
583 void hostapd_event_ch_switch(struct hostapd_data
*hapd
, int freq
, int ht
,
584 int offset
, int width
, int cf1
, int cf2
);
585 struct survey_results
;
586 void hostapd_event_get_survey(struct hostapd_iface
*iface
,
587 struct survey_results
*survey_results
);
588 void hostapd_acs_channel_selected(struct hostapd_data
*hapd
,
589 struct acs_selected_channels
*acs_res
);
591 const struct hostapd_eap_user
*
592 hostapd_get_eap_user(struct hostapd_data
*hapd
, const u8
*identity
,
593 size_t identity_len
, int phase2
);
595 struct hostapd_data
* hostapd_get_iface(struct hapd_interfaces
*interfaces
,
599 void fst_hostapd_fill_iface_obj(struct hostapd_data
*hapd
,
600 struct fst_wpa_obj
*iface_obj
);
601 #endif /* CONFIG_FST */
603 #endif /* HOSTAPD_H */