xref: /freebsd/contrib/wpa/src/ap/ap_drv_ops.h (revision 53b70c86)
1 /*
2  * hostapd - Driver operations
3  * Copyright (c) 2009-2014, 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 AP_DRV_OPS
10 #define AP_DRV_OPS
11 
12 enum wpa_driver_if_type;
13 struct wpa_bss_params;
14 struct wpa_driver_scan_params;
15 struct ieee80211_ht_capabilities;
16 struct ieee80211_vht_capabilities;
17 struct hostapd_freq_params;
18 
19 u32 hostapd_sta_flags_to_drv(u32 flags);
20 int hostapd_build_ap_extra_ies(struct hostapd_data *hapd,
21 			       struct wpabuf **beacon,
22 			       struct wpabuf **proberesp,
23 			       struct wpabuf **assocresp);
24 void hostapd_free_ap_extra_ies(struct hostapd_data *hapd, struct wpabuf *beacon,
25 			       struct wpabuf *proberesp,
26 			       struct wpabuf *assocresp);
27 int hostapd_reset_ap_wps_ie(struct hostapd_data *hapd);
28 int hostapd_set_ap_wps_ie(struct hostapd_data *hapd);
29 int hostapd_set_authorized(struct hostapd_data *hapd,
30 			   struct sta_info *sta, int authorized);
31 int hostapd_set_sta_flags(struct hostapd_data *hapd, struct sta_info *sta);
32 int hostapd_set_drv_ieee8021x(struct hostapd_data *hapd, const char *ifname,
33 			      int enabled);
34 int hostapd_vlan_if_add(struct hostapd_data *hapd, const char *ifname);
35 int hostapd_vlan_if_remove(struct hostapd_data *hapd, const char *ifname);
36 int hostapd_set_wds_sta(struct hostapd_data *hapd, char *ifname_wds,
37 			const u8 *addr, int aid, int val);
38 int hostapd_sta_add(struct hostapd_data *hapd,
39 		    const u8 *addr, u16 aid, u16 capability,
40 		    const u8 *supp_rates, size_t supp_rates_len,
41 		    u16 listen_interval,
42 		    const struct ieee80211_ht_capabilities *ht_capab,
43 		    const struct ieee80211_vht_capabilities *vht_capab,
44 		    const struct ieee80211_he_capabilities *he_capab,
45 		    size_t he_capab_len,
46 		    const struct ieee80211_he_6ghz_band_cap *he_6ghz_capab,
47 		    u32 flags, u8 qosinfo, u8 vht_opmode, int supp_p2p_ps,
48 		    int set);
49 int hostapd_set_privacy(struct hostapd_data *hapd, int enabled);
50 int hostapd_set_generic_elem(struct hostapd_data *hapd, const u8 *elem,
51 			     size_t elem_len);
52 int hostapd_get_ssid(struct hostapd_data *hapd, u8 *buf, size_t len);
53 int hostapd_set_ssid(struct hostapd_data *hapd, const u8 *buf, size_t len);
54 int hostapd_if_add(struct hostapd_data *hapd, enum wpa_driver_if_type type,
55 		   const char *ifname, const u8 *addr, void *bss_ctx,
56 		   void **drv_priv, char *force_ifname, u8 *if_addr,
57 		   const char *bridge, int use_existing);
58 int hostapd_if_remove(struct hostapd_data *hapd, enum wpa_driver_if_type type,
59 		      const char *ifname);
60 int hostapd_set_ieee8021x(struct hostapd_data *hapd,
61 			  struct wpa_bss_params *params);
62 int hostapd_get_seqnum(const char *ifname, struct hostapd_data *hapd,
63 		       const u8 *addr, int idx, u8 *seq);
64 int hostapd_flush(struct hostapd_data *hapd);
65 int hostapd_set_freq(struct hostapd_data *hapd, enum hostapd_hw_mode mode,
66 		     int freq, int channel, int edmg, u8 edmg_channel,
67 		     int ht_enabled, int vht_enabled,
68 		     int he_enabled, int sec_channel_offset, int oper_chwidth,
69 		     int center_segment0, int center_segment1);
70 int hostapd_set_rts(struct hostapd_data *hapd, int rts);
71 int hostapd_set_frag(struct hostapd_data *hapd, int frag);
72 int hostapd_sta_set_flags(struct hostapd_data *hapd, u8 *addr,
73 			  int total_flags, int flags_or, int flags_and);
74 int hostapd_sta_set_airtime_weight(struct hostapd_data *hapd, const u8 *addr,
75 				   unsigned int weight);
76 int hostapd_set_country(struct hostapd_data *hapd, const char *country);
77 int hostapd_set_tx_queue_params(struct hostapd_data *hapd, int queue, int aifs,
78 				int cw_min, int cw_max, int burst_time);
79 struct hostapd_hw_modes *
80 hostapd_get_hw_feature_data(struct hostapd_data *hapd, u16 *num_modes,
81 			    u16 *flags, u8 *dfs_domain);
82 int hostapd_driver_commit(struct hostapd_data *hapd);
83 int hostapd_drv_none(struct hostapd_data *hapd);
84 bool hostapd_drv_nl80211(struct hostapd_data *hapd);
85 int hostapd_driver_scan(struct hostapd_data *hapd,
86 			struct wpa_driver_scan_params *params);
87 struct wpa_scan_results * hostapd_driver_get_scan_results(
88 	struct hostapd_data *hapd);
89 int hostapd_driver_set_noa(struct hostapd_data *hapd, u8 count, int start,
90 			   int duration);
91 int hostapd_drv_set_key(const char *ifname,
92 			struct hostapd_data *hapd,
93 			enum wpa_alg alg, const u8 *addr,
94 			int key_idx, int vlan_id, int set_tx,
95 			const u8 *seq, size_t seq_len,
96 			const u8 *key, size_t key_len, enum key_flag key_flag);
97 int hostapd_drv_send_mlme(struct hostapd_data *hapd,
98 			  const void *msg, size_t len, int noack,
99 			  const u16 *csa_offs, size_t csa_offs_len,
100 			  int no_encrypt);
101 int hostapd_drv_sta_deauth(struct hostapd_data *hapd,
102 			   const u8 *addr, int reason);
103 int hostapd_drv_sta_disassoc(struct hostapd_data *hapd,
104 			     const u8 *addr, int reason);
105 int hostapd_drv_send_action(struct hostapd_data *hapd, unsigned int freq,
106 			    unsigned int wait, const u8 *dst, const u8 *data,
107 			    size_t len);
108 int hostapd_drv_send_action_addr3_ap(struct hostapd_data *hapd,
109 				     unsigned int freq,
110 				     unsigned int wait, const u8 *dst,
111 				     const u8 *data, size_t len);
112 static inline void
113 hostapd_drv_send_action_cancel_wait(struct hostapd_data *hapd)
114 {
115 	if (!hapd->driver || !hapd->driver->send_action_cancel_wait ||
116 	    !hapd->drv_priv)
117 		return;
118 	hapd->driver->send_action_cancel_wait(hapd->drv_priv);
119 }
120 int hostapd_add_sta_node(struct hostapd_data *hapd, const u8 *addr,
121 			 u16 auth_alg);
122 int hostapd_sta_auth(struct hostapd_data *hapd, const u8 *addr,
123 		     u16 seq, u16 status, const u8 *ie, size_t len);
124 int hostapd_sta_assoc(struct hostapd_data *hapd, const u8 *addr,
125 		      int reassoc, u16 status, const u8 *ie, size_t len);
126 int hostapd_add_tspec(struct hostapd_data *hapd, const u8 *addr,
127 		      u8 *tspec_ie, size_t tspec_ielen);
128 int hostapd_start_dfs_cac(struct hostapd_iface *iface,
129 			  enum hostapd_hw_mode mode, int freq,
130 			  int channel, int ht_enabled, int vht_enabled,
131 			  int he_enabled,
132 			  int sec_channel_offset, int oper_chwidth,
133 			  int center_segment0, int center_segment1);
134 int hostapd_drv_do_acs(struct hostapd_data *hapd);
135 int hostapd_drv_update_dh_ie(struct hostapd_data *hapd, const u8 *peer,
136 			     u16 reason_code, const u8 *ie, size_t ielen);
137 int hostapd_drv_dpp_listen(struct hostapd_data *hapd, bool enable);
138 
139 
140 #include "drivers/driver.h"
141 
142 int hostapd_drv_wnm_oper(struct hostapd_data *hapd,
143 			 enum wnm_oper oper, const u8 *peer,
144 			 u8 *buf, u16 *buf_len);
145 
146 int hostapd_drv_set_qos_map(struct hostapd_data *hapd, const u8 *qos_map_set,
147 			    u8 qos_map_set_len);
148 
149 void hostapd_get_ext_capa(struct hostapd_iface *iface);
150 
151 static inline int hostapd_drv_set_countermeasures(struct hostapd_data *hapd,
152 						  int enabled)
153 {
154 	if (hapd->driver == NULL ||
155 	    hapd->driver->hapd_set_countermeasures == NULL)
156 		return 0;
157 	return hapd->driver->hapd_set_countermeasures(hapd->drv_priv, enabled);
158 }
159 
160 static inline int hostapd_drv_set_sta_vlan(const char *ifname,
161 					   struct hostapd_data *hapd,
162 					   const u8 *addr, int vlan_id)
163 {
164 	if (hapd->driver == NULL || hapd->driver->set_sta_vlan == NULL)
165 		return 0;
166 	return hapd->driver->set_sta_vlan(hapd->drv_priv, addr, ifname,
167 					  vlan_id);
168 }
169 
170 static inline int hostapd_drv_get_inact_sec(struct hostapd_data *hapd,
171 					    const u8 *addr)
172 {
173 	if (hapd->driver == NULL || hapd->driver->get_inact_sec == NULL)
174 		return 0;
175 	return hapd->driver->get_inact_sec(hapd->drv_priv, addr);
176 }
177 
178 static inline int hostapd_drv_sta_remove(struct hostapd_data *hapd,
179 					 const u8 *addr)
180 {
181 	if (!hapd->driver || !hapd->driver->sta_remove || !hapd->drv_priv)
182 		return 0;
183 	return hapd->driver->sta_remove(hapd->drv_priv, addr);
184 }
185 
186 static inline int hostapd_drv_hapd_send_eapol(struct hostapd_data *hapd,
187 					      const u8 *addr, const u8 *data,
188 					      size_t data_len, int encrypt,
189 					      u32 flags)
190 {
191 	if (hapd->driver == NULL || hapd->driver->hapd_send_eapol == NULL)
192 		return 0;
193 	return hapd->driver->hapd_send_eapol(hapd->drv_priv, addr, data,
194 					     data_len, encrypt,
195 					     hapd->own_addr, flags);
196 }
197 
198 static inline int hostapd_drv_read_sta_data(
199 	struct hostapd_data *hapd, struct hostap_sta_driver_data *data,
200 	const u8 *addr)
201 {
202 	if (hapd->driver == NULL || hapd->driver->read_sta_data == NULL)
203 		return -1;
204 	return hapd->driver->read_sta_data(hapd->drv_priv, data, addr);
205 }
206 
207 static inline int hostapd_drv_sta_clear_stats(struct hostapd_data *hapd,
208 					      const u8 *addr)
209 {
210 	if (hapd->driver == NULL || hapd->driver->sta_clear_stats == NULL)
211 		return 0;
212 	return hapd->driver->sta_clear_stats(hapd->drv_priv, addr);
213 }
214 
215 static inline int hostapd_drv_set_acl(struct hostapd_data *hapd,
216 				      struct hostapd_acl_params *params)
217 {
218 	if (hapd->driver == NULL || hapd->driver->set_acl == NULL)
219 		return 0;
220 	return hapd->driver->set_acl(hapd->drv_priv, params);
221 }
222 
223 static inline int hostapd_drv_set_ap(struct hostapd_data *hapd,
224 				     struct wpa_driver_ap_params *params)
225 {
226 	if (hapd->driver == NULL || hapd->driver->set_ap == NULL)
227 		return 0;
228 	return hapd->driver->set_ap(hapd->drv_priv, params);
229 }
230 
231 static inline int hostapd_drv_set_radius_acl_auth(struct hostapd_data *hapd,
232 						  const u8 *mac, int accepted,
233 						  u32 session_timeout)
234 {
235 	if (hapd->driver == NULL || hapd->driver->set_radius_acl_auth == NULL)
236 		return 0;
237 	return hapd->driver->set_radius_acl_auth(hapd->drv_priv, mac, accepted,
238 						 session_timeout);
239 }
240 
241 static inline int hostapd_drv_set_radius_acl_expire(struct hostapd_data *hapd,
242 						    const u8 *mac)
243 {
244 	if (hapd->driver == NULL ||
245 	    hapd->driver->set_radius_acl_expire == NULL)
246 		return 0;
247 	return hapd->driver->set_radius_acl_expire(hapd->drv_priv, mac);
248 }
249 
250 static inline int hostapd_drv_set_authmode(struct hostapd_data *hapd,
251 					   int auth_algs)
252 {
253 	if (hapd->driver == NULL || hapd->driver->set_authmode == NULL)
254 		return 0;
255 	return hapd->driver->set_authmode(hapd->drv_priv, auth_algs);
256 }
257 
258 static inline void hostapd_drv_poll_client(struct hostapd_data *hapd,
259 					   const u8 *own_addr, const u8 *addr,
260 					   int qos)
261 {
262 	if (hapd->driver == NULL || hapd->driver->poll_client == NULL)
263 		return;
264 	hapd->driver->poll_client(hapd->drv_priv, own_addr, addr, qos);
265 }
266 
267 static inline int hostapd_drv_get_survey(struct hostapd_data *hapd,
268 					 unsigned int freq)
269 {
270 	if (hapd->driver == NULL)
271 		return -1;
272 	if (!hapd->driver->get_survey)
273 		return -1;
274 	return hapd->driver->get_survey(hapd->drv_priv, freq);
275 }
276 
277 static inline int hostapd_get_country(struct hostapd_data *hapd, char *alpha2)
278 {
279 	if (hapd->driver == NULL || hapd->driver->get_country == NULL)
280 		return -1;
281 	return hapd->driver->get_country(hapd->drv_priv, alpha2);
282 }
283 
284 static inline const char * hostapd_drv_get_radio_name(struct hostapd_data *hapd)
285 {
286 	if (hapd->driver == NULL || hapd->drv_priv == NULL ||
287 	    hapd->driver->get_radio_name == NULL)
288 		return NULL;
289 	return hapd->driver->get_radio_name(hapd->drv_priv);
290 }
291 
292 static inline int hostapd_drv_switch_channel(struct hostapd_data *hapd,
293 					     struct csa_settings *settings)
294 {
295 	if (hapd->driver == NULL || hapd->driver->switch_channel == NULL ||
296 	    hapd->drv_priv == NULL)
297 		return -1;
298 
299 	return hapd->driver->switch_channel(hapd->drv_priv, settings);
300 }
301 
302 static inline int hostapd_drv_status(struct hostapd_data *hapd, char *buf,
303 				     size_t buflen)
304 {
305 	if (!hapd->driver || !hapd->driver->status || !hapd->drv_priv)
306 		return -1;
307 	return hapd->driver->status(hapd->drv_priv, buf, buflen);
308 }
309 
310 static inline int hostapd_drv_br_add_ip_neigh(struct hostapd_data *hapd,
311 					      int version, const u8 *ipaddr,
312 					      int prefixlen, const u8 *addr)
313 {
314 	if (hapd->driver == NULL || hapd->drv_priv == NULL ||
315 	    hapd->driver->br_add_ip_neigh == NULL)
316 		return -1;
317 	return hapd->driver->br_add_ip_neigh(hapd->drv_priv, version, ipaddr,
318 					     prefixlen, addr);
319 }
320 
321 static inline int hostapd_drv_br_delete_ip_neigh(struct hostapd_data *hapd,
322 						 u8 version, const u8 *ipaddr)
323 {
324 	if (hapd->driver == NULL || hapd->drv_priv == NULL ||
325 	    hapd->driver->br_delete_ip_neigh == NULL)
326 		return -1;
327 	return hapd->driver->br_delete_ip_neigh(hapd->drv_priv, version,
328 						ipaddr);
329 }
330 
331 static inline int hostapd_drv_br_port_set_attr(struct hostapd_data *hapd,
332 					       enum drv_br_port_attr attr,
333 					       unsigned int val)
334 {
335 	if (hapd->driver == NULL || hapd->drv_priv == NULL ||
336 	    hapd->driver->br_port_set_attr == NULL)
337 		return -1;
338 	return hapd->driver->br_port_set_attr(hapd->drv_priv, attr, val);
339 }
340 
341 static inline int hostapd_drv_br_set_net_param(struct hostapd_data *hapd,
342 					       enum drv_br_net_param param,
343 					       unsigned int val)
344 {
345 	if (hapd->driver == NULL || hapd->drv_priv == NULL ||
346 	    hapd->driver->br_set_net_param == NULL)
347 		return -1;
348 	return hapd->driver->br_set_net_param(hapd->drv_priv, param, val);
349 }
350 
351 static inline int hostapd_drv_vendor_cmd(struct hostapd_data *hapd,
352 					 int vendor_id, int subcmd,
353 					 const u8 *data, size_t data_len,
354 					 enum nested_attr nested_attr_flag,
355 					 struct wpabuf *buf)
356 {
357 	if (hapd->driver == NULL || hapd->driver->vendor_cmd == NULL)
358 		return -1;
359 	return hapd->driver->vendor_cmd(hapd->drv_priv, vendor_id, subcmd, data,
360 					data_len, nested_attr_flag, buf);
361 }
362 
363 static inline int hostapd_drv_stop_ap(struct hostapd_data *hapd)
364 {
365 	if (!hapd->driver || !hapd->driver->stop_ap || !hapd->drv_priv)
366 		return 0;
367 	return hapd->driver->stop_ap(hapd->drv_priv);
368 }
369 
370 static inline int hostapd_drv_channel_info(struct hostapd_data *hapd,
371 					   struct wpa_channel_info *ci)
372 {
373 	if (!hapd->driver || !hapd->driver->channel_info)
374 		return -1;
375 	return hapd->driver->channel_info(hapd->drv_priv, ci);
376 }
377 
378 static inline int
379 hostapd_drv_send_external_auth_status(struct hostapd_data *hapd,
380 				      struct external_auth *params)
381 {
382 	if (!hapd->driver || !hapd->drv_priv ||
383 	    !hapd->driver->send_external_auth_status)
384 		return -1;
385 	return hapd->driver->send_external_auth_status(hapd->drv_priv, params);
386 }
387 
388 static inline int
389 hostapd_drv_set_band(struct hostapd_data *hapd, u32 band_mask)
390 {
391 	if (!hapd->driver || !hapd->drv_priv || !hapd->driver->set_band)
392 		return -1;
393 	return hapd->driver->set_band(hapd->drv_priv, band_mask);
394 }
395 
396 #ifdef ANDROID
397 static inline int hostapd_drv_driver_cmd(struct hostapd_data *hapd,
398 					 char *cmd, char *buf, size_t buf_len)
399 {
400 	if (!hapd->driver->driver_cmd)
401 		return -1;
402 	return hapd->driver->driver_cmd(hapd->drv_priv, cmd, buf, buf_len);
403 }
404 #endif /* ANDROID */
405 
406 #ifdef CONFIG_TESTING_OPTIONS
407 static inline int
408 hostapd_drv_register_frame(struct hostapd_data *hapd, u16 type,
409 			   const u8 *match, size_t match_len,
410 			   bool multicast)
411 {
412 	if (!hapd->driver || !hapd->drv_priv || !hapd->driver->register_frame)
413 		return -1;
414 	return hapd->driver->register_frame(hapd->drv_priv, type, match,
415 					    match_len, multicast);
416 }
417 #endif /* CONFIG_TESTING_OPTIONS */
418 
419 #endif /* AP_DRV_OPS */
420