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