xref: /freebsd/contrib/wpa/src/ap/hostapd.h (revision 0fcefb433d1265c4e6d4275eae7478cda1bf6a34)
1 /*
2  * hostapd / Initialization and configuration
3  * Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>
4  *
5  * This software may be distributed under the terms of the BSD license.
6  * See README for more details.
7  */
8 
9 #ifndef HOSTAPD_H
10 #define HOSTAPD_H
11 
12 #include "common/defs.h"
13 #include "ap_config.h"
14 
15 struct wpa_driver_ops;
16 struct wpa_ctrl_dst;
17 struct radius_server_data;
18 struct upnp_wps_device_sm;
19 struct hostapd_data;
20 struct sta_info;
21 struct hostap_sta_driver_data;
22 struct ieee80211_ht_capabilities;
23 struct full_dynamic_vlan;
24 enum wps_event;
25 union wps_event_data;
26 
27 struct hostapd_iface;
28 
29 struct hapd_interfaces {
30 	int (*reload_config)(struct hostapd_iface *iface);
31 	struct hostapd_config * (*config_read_cb)(const char *config_fname);
32 	int (*ctrl_iface_init)(struct hostapd_data *hapd);
33 	void (*ctrl_iface_deinit)(struct hostapd_data *hapd);
34 	int (*for_each_interface)(struct hapd_interfaces *interfaces,
35 				  int (*cb)(struct hostapd_iface *iface,
36 					    void *ctx), void *ctx);
37 	int (*driver_init)(struct hostapd_iface *iface);
38 
39 	size_t count;
40 	int global_ctrl_sock;
41 	char *global_iface_path;
42 	char *global_iface_name;
43 	struct hostapd_iface **iface;
44 };
45 
46 
47 struct hostapd_probereq_cb {
48 	int (*cb)(void *ctx, const u8 *sa, const u8 *da, const u8 *bssid,
49 		  const u8 *ie, size_t ie_len, int ssi_signal);
50 	void *ctx;
51 };
52 
53 #define HOSTAPD_RATE_BASIC 0x00000001
54 
55 struct hostapd_rate_data {
56 	int rate; /* rate in 100 kbps */
57 	int flags; /* HOSTAPD_RATE_ flags */
58 };
59 
60 struct hostapd_frame_info {
61 	u32 channel;
62 	u32 datarate;
63 	int ssi_signal; /* dBm */
64 };
65 
66 
67 /**
68  * struct hostapd_data - hostapd per-BSS data structure
69  */
70 struct hostapd_data {
71 	struct hostapd_iface *iface;
72 	struct hostapd_config *iconf;
73 	struct hostapd_bss_config *conf;
74 	int interface_added; /* virtual interface added for this BSS */
75 
76 	u8 own_addr[ETH_ALEN];
77 
78 	int num_sta; /* number of entries in sta_list */
79 	struct sta_info *sta_list; /* STA info list head */
80 #define STA_HASH_SIZE 256
81 #define STA_HASH(sta) (sta[5])
82 	struct sta_info *sta_hash[STA_HASH_SIZE];
83 
84 	/*
85 	 * Bitfield for indicating which AIDs are allocated. Only AID values
86 	 * 1-2007 are used and as such, the bit at index 0 corresponds to AID
87 	 * 1.
88 	 */
89 #define AID_WORDS ((2008 + 31) / 32)
90 	u32 sta_aid[AID_WORDS];
91 
92 	const struct wpa_driver_ops *driver;
93 	void *drv_priv;
94 
95 	void (*new_assoc_sta_cb)(struct hostapd_data *hapd,
96 				 struct sta_info *sta, int reassoc);
97 
98 	void *msg_ctx; /* ctx for wpa_msg() calls */
99 	void *msg_ctx_parent; /* parent interface ctx for wpa_msg() calls */
100 
101 	struct radius_client_data *radius;
102 	u32 acct_session_id_hi, acct_session_id_lo;
103 	struct radius_das_data *radius_das;
104 
105 	struct iapp_data *iapp;
106 
107 	struct hostapd_cached_radius_acl *acl_cache;
108 	struct hostapd_acl_query_data *acl_queries;
109 
110 	struct wpa_authenticator *wpa_auth;
111 	struct eapol_authenticator *eapol_auth;
112 
113 	struct rsn_preauth_interface *preauth_iface;
114 	time_t michael_mic_failure;
115 	int michael_mic_failures;
116 	int tkip_countermeasures;
117 
118 	int ctrl_sock;
119 	struct wpa_ctrl_dst *ctrl_dst;
120 
121 	void *ssl_ctx;
122 	void *eap_sim_db_priv;
123 	struct radius_server_data *radius_srv;
124 
125 	int parameter_set_count;
126 
127 	/* Time Advertisement */
128 	u8 time_update_counter;
129 	struct wpabuf *time_adv;
130 
131 #ifdef CONFIG_FULL_DYNAMIC_VLAN
132 	struct full_dynamic_vlan *full_dynamic_vlan;
133 #endif /* CONFIG_FULL_DYNAMIC_VLAN */
134 
135 	struct l2_packet_data *l2;
136 	struct wps_context *wps;
137 
138 	int beacon_set_done;
139 	struct wpabuf *wps_beacon_ie;
140 	struct wpabuf *wps_probe_resp_ie;
141 #ifdef CONFIG_WPS
142 	unsigned int ap_pin_failures;
143 	unsigned int ap_pin_failures_consecutive;
144 	struct upnp_wps_device_sm *wps_upnp;
145 	unsigned int ap_pin_lockout_time;
146 #endif /* CONFIG_WPS */
147 
148 	struct hostapd_probereq_cb *probereq_cb;
149 	size_t num_probereq_cb;
150 
151 	void (*public_action_cb)(void *ctx, const u8 *buf, size_t len,
152 				 int freq);
153 	void *public_action_cb_ctx;
154 
155 	int (*vendor_action_cb)(void *ctx, const u8 *buf, size_t len,
156 				int freq);
157 	void *vendor_action_cb_ctx;
158 
159 	void (*wps_reg_success_cb)(void *ctx, const u8 *mac_addr,
160 				   const u8 *uuid_e);
161 	void *wps_reg_success_cb_ctx;
162 
163 	void (*wps_event_cb)(void *ctx, enum wps_event event,
164 			     union wps_event_data *data);
165 	void *wps_event_cb_ctx;
166 
167 	void (*sta_authorized_cb)(void *ctx, const u8 *mac_addr,
168 				  int authorized, const u8 *p2p_dev_addr);
169 	void *sta_authorized_cb_ctx;
170 
171 	void (*setup_complete_cb)(void *ctx);
172 	void *setup_complete_cb_ctx;
173 
174 #ifdef CONFIG_P2P
175 	struct p2p_data *p2p;
176 	struct p2p_group *p2p_group;
177 	struct wpabuf *p2p_beacon_ie;
178 	struct wpabuf *p2p_probe_resp_ie;
179 
180 	/* Number of non-P2P association stations */
181 	int num_sta_no_p2p;
182 
183 	/* Periodic NoA (used only when no non-P2P clients in the group) */
184 	int noa_enabled;
185 	int noa_start;
186 	int noa_duration;
187 #endif /* CONFIG_P2P */
188 #ifdef CONFIG_INTERWORKING
189 	size_t gas_frag_limit;
190 #endif /* CONFIG_INTERWORKING */
191 
192 #ifdef CONFIG_SQLITE
193 	struct hostapd_eap_user tmp_eap_user;
194 #endif /* CONFIG_SQLITE */
195 };
196 
197 
198 /**
199  * struct hostapd_iface - hostapd per-interface data structure
200  */
201 struct hostapd_iface {
202 	struct hapd_interfaces *interfaces;
203 	void *owner;
204 	char *config_fname;
205 	struct hostapd_config *conf;
206 
207 	size_t num_bss;
208 	struct hostapd_data **bss;
209 
210 	int num_ap; /* number of entries in ap_list */
211 	struct ap_info *ap_list; /* AP info list head */
212 	struct ap_info *ap_hash[STA_HASH_SIZE];
213 	struct ap_info *ap_iter_list;
214 
215 	unsigned int drv_flags;
216 
217 	/*
218 	 * A bitmap of supported protocols for probe response offload. See
219 	 * struct wpa_driver_capa in driver.h
220 	 */
221 	unsigned int probe_resp_offloads;
222 
223 	struct hostapd_hw_modes *hw_features;
224 	int num_hw_features;
225 	struct hostapd_hw_modes *current_mode;
226 	/* Rates that are currently used (i.e., filtered copy of
227 	 * current_mode->channels */
228 	int num_rates;
229 	struct hostapd_rate_data *current_rates;
230 	int *basic_rates;
231 	int freq;
232 
233 	u16 hw_flags;
234 
235 	/* Number of associated Non-ERP stations (i.e., stations using 802.11b
236 	 * in 802.11g BSS) */
237 	int num_sta_non_erp;
238 
239 	/* Number of associated stations that do not support Short Slot Time */
240 	int num_sta_no_short_slot_time;
241 
242 	/* Number of associated stations that do not support Short Preamble */
243 	int num_sta_no_short_preamble;
244 
245 	int olbc; /* Overlapping Legacy BSS Condition */
246 
247 	/* Number of HT associated stations that do not support greenfield */
248 	int num_sta_ht_no_gf;
249 
250 	/* Number of associated non-HT stations */
251 	int num_sta_no_ht;
252 
253 	/* Number of HT associated stations 20 MHz */
254 	int num_sta_ht_20mhz;
255 
256 	/* Overlapping BSS information */
257 	int olbc_ht;
258 
259 	u16 ht_op_mode;
260 	void (*scan_cb)(struct hostapd_iface *iface);
261 };
262 
263 /* hostapd.c */
264 int hostapd_for_each_interface(struct hapd_interfaces *interfaces,
265 			       int (*cb)(struct hostapd_iface *iface,
266 					 void *ctx), void *ctx);
267 int hostapd_reload_config(struct hostapd_iface *iface);
268 struct hostapd_data *
269 hostapd_alloc_bss_data(struct hostapd_iface *hapd_iface,
270 		       struct hostapd_config *conf,
271 		       struct hostapd_bss_config *bss);
272 int hostapd_setup_interface(struct hostapd_iface *iface);
273 int hostapd_setup_interface_complete(struct hostapd_iface *iface, int err);
274 void hostapd_interface_deinit(struct hostapd_iface *iface);
275 void hostapd_interface_free(struct hostapd_iface *iface);
276 void hostapd_new_assoc_sta(struct hostapd_data *hapd, struct sta_info *sta,
277 			   int reassoc);
278 void hostapd_interface_deinit_free(struct hostapd_iface *iface);
279 int hostapd_enable_iface(struct hostapd_iface *hapd_iface);
280 int hostapd_reload_iface(struct hostapd_iface *hapd_iface);
281 int hostapd_disable_iface(struct hostapd_iface *hapd_iface);
282 int hostapd_add_iface(struct hapd_interfaces *ifaces, char *buf);
283 int hostapd_remove_iface(struct hapd_interfaces *ifaces, char *buf);
284 
285 /* utils.c */
286 int hostapd_register_probereq_cb(struct hostapd_data *hapd,
287 				 int (*cb)(void *ctx, const u8 *sa,
288 					   const u8 *da, const u8 *bssid,
289 					   const u8 *ie, size_t ie_len,
290 					   int ssi_signal),
291 				 void *ctx);
292 void hostapd_prune_associations(struct hostapd_data *hapd, const u8 *addr);
293 
294 /* drv_callbacks.c (TODO: move to somewhere else?) */
295 int hostapd_notif_assoc(struct hostapd_data *hapd, const u8 *addr,
296 			const u8 *ie, size_t ielen, int reassoc);
297 void hostapd_notif_disassoc(struct hostapd_data *hapd, const u8 *addr);
298 void hostapd_event_sta_low_ack(struct hostapd_data *hapd, const u8 *addr);
299 int hostapd_probe_req_rx(struct hostapd_data *hapd, const u8 *sa, const u8 *da,
300 			 const u8 *bssid, const u8 *ie, size_t ie_len,
301 			 int ssi_signal);
302 void hostapd_event_ch_switch(struct hostapd_data *hapd, int freq, int ht,
303 			     int offset);
304 
305 const struct hostapd_eap_user *
306 hostapd_get_eap_user(struct hostapd_data *hapd, const u8 *identity,
307 		     size_t identity_len, int phase2);
308 
309 #endif /* HOSTAPD_H */
310