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
hostapd_drv_send_action_cancel_wait(struct hostapd_data * hapd)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
138
139 #include "drivers/driver.h"
140
141 int hostapd_drv_wnm_oper(struct hostapd_data *hapd,
142 enum wnm_oper oper, const u8 *peer,
143 u8 *buf, u16 *buf_len);
144
145 int hostapd_drv_set_qos_map(struct hostapd_data *hapd, const u8 *qos_map_set,
146 u8 qos_map_set_len);
147
148 void hostapd_get_ext_capa(struct hostapd_iface *iface);
149
hostapd_drv_set_countermeasures(struct hostapd_data * hapd,int enabled)150 static inline int hostapd_drv_set_countermeasures(struct hostapd_data *hapd,
151 int enabled)
152 {
153 if (hapd->driver == NULL ||
154 hapd->driver->hapd_set_countermeasures == NULL)
155 return 0;
156 return hapd->driver->hapd_set_countermeasures(hapd->drv_priv, enabled);
157 }
158
hostapd_drv_set_sta_vlan(const char * ifname,struct hostapd_data * hapd,const u8 * addr,int vlan_id)159 static inline int hostapd_drv_set_sta_vlan(const char *ifname,
160 struct hostapd_data *hapd,
161 const u8 *addr, int vlan_id)
162 {
163 if (hapd->driver == NULL || hapd->driver->set_sta_vlan == NULL)
164 return 0;
165 return hapd->driver->set_sta_vlan(hapd->drv_priv, addr, ifname,
166 vlan_id);
167 }
168
hostapd_drv_get_inact_sec(struct hostapd_data * hapd,const u8 * addr)169 static inline int hostapd_drv_get_inact_sec(struct hostapd_data *hapd,
170 const u8 *addr)
171 {
172 if (hapd->driver == NULL || hapd->driver->get_inact_sec == NULL)
173 return 0;
174 return hapd->driver->get_inact_sec(hapd->drv_priv, addr);
175 }
176
hostapd_drv_sta_remove(struct hostapd_data * hapd,const u8 * addr)177 static inline int hostapd_drv_sta_remove(struct hostapd_data *hapd,
178 const u8 *addr)
179 {
180 if (!hapd->driver || !hapd->driver->sta_remove || !hapd->drv_priv)
181 return 0;
182 return hapd->driver->sta_remove(hapd->drv_priv, addr);
183 }
184
hostapd_drv_hapd_send_eapol(struct hostapd_data * hapd,const u8 * addr,const u8 * data,size_t data_len,int encrypt,u32 flags)185 static inline int hostapd_drv_hapd_send_eapol(struct hostapd_data *hapd,
186 const u8 *addr, const u8 *data,
187 size_t data_len, int encrypt,
188 u32 flags)
189 {
190 if (hapd->driver == NULL || hapd->driver->hapd_send_eapol == NULL)
191 return 0;
192 return hapd->driver->hapd_send_eapol(hapd->drv_priv, addr, data,
193 data_len, encrypt,
194 hapd->own_addr, flags);
195 }
196
hostapd_drv_read_sta_data(struct hostapd_data * hapd,struct hostap_sta_driver_data * data,const u8 * addr)197 static inline int hostapd_drv_read_sta_data(
198 struct hostapd_data *hapd, struct hostap_sta_driver_data *data,
199 const u8 *addr)
200 {
201 if (hapd->driver == NULL || hapd->driver->read_sta_data == NULL)
202 return -1;
203 return hapd->driver->read_sta_data(hapd->drv_priv, data, addr);
204 }
205
hostapd_drv_sta_clear_stats(struct hostapd_data * hapd,const u8 * addr)206 static inline int hostapd_drv_sta_clear_stats(struct hostapd_data *hapd,
207 const u8 *addr)
208 {
209 if (hapd->driver == NULL || hapd->driver->sta_clear_stats == NULL)
210 return 0;
211 return hapd->driver->sta_clear_stats(hapd->drv_priv, addr);
212 }
213
hostapd_drv_set_acl(struct hostapd_data * hapd,struct hostapd_acl_params * params)214 static inline int hostapd_drv_set_acl(struct hostapd_data *hapd,
215 struct hostapd_acl_params *params)
216 {
217 if (hapd->driver == NULL || hapd->driver->set_acl == NULL)
218 return 0;
219 return hapd->driver->set_acl(hapd->drv_priv, params);
220 }
221
hostapd_drv_set_ap(struct hostapd_data * hapd,struct wpa_driver_ap_params * params)222 static inline int hostapd_drv_set_ap(struct hostapd_data *hapd,
223 struct wpa_driver_ap_params *params)
224 {
225 if (hapd->driver == NULL || hapd->driver->set_ap == NULL)
226 return 0;
227 return hapd->driver->set_ap(hapd->drv_priv, params);
228 }
229
hostapd_drv_set_radius_acl_auth(struct hostapd_data * hapd,const u8 * mac,int accepted,u32 session_timeout)230 static inline int hostapd_drv_set_radius_acl_auth(struct hostapd_data *hapd,
231 const u8 *mac, int accepted,
232 u32 session_timeout)
233 {
234 if (hapd->driver == NULL || hapd->driver->set_radius_acl_auth == NULL)
235 return 0;
236 return hapd->driver->set_radius_acl_auth(hapd->drv_priv, mac, accepted,
237 session_timeout);
238 }
239
hostapd_drv_set_radius_acl_expire(struct hostapd_data * hapd,const u8 * mac)240 static inline int hostapd_drv_set_radius_acl_expire(struct hostapd_data *hapd,
241 const u8 *mac)
242 {
243 if (hapd->driver == NULL ||
244 hapd->driver->set_radius_acl_expire == NULL)
245 return 0;
246 return hapd->driver->set_radius_acl_expire(hapd->drv_priv, mac);
247 }
248
hostapd_drv_set_authmode(struct hostapd_data * hapd,int auth_algs)249 static inline int hostapd_drv_set_authmode(struct hostapd_data *hapd,
250 int auth_algs)
251 {
252 if (hapd->driver == NULL || hapd->driver->set_authmode == NULL)
253 return 0;
254 return hapd->driver->set_authmode(hapd->drv_priv, auth_algs);
255 }
256
hostapd_drv_poll_client(struct hostapd_data * hapd,const u8 * own_addr,const u8 * addr,int qos)257 static inline void hostapd_drv_poll_client(struct hostapd_data *hapd,
258 const u8 *own_addr, const u8 *addr,
259 int qos)
260 {
261 if (hapd->driver == NULL || hapd->driver->poll_client == NULL)
262 return;
263 hapd->driver->poll_client(hapd->drv_priv, own_addr, addr, qos);
264 }
265
hostapd_drv_get_survey(struct hostapd_data * hapd,unsigned int freq)266 static inline int hostapd_drv_get_survey(struct hostapd_data *hapd,
267 unsigned int freq)
268 {
269 if (hapd->driver == NULL)
270 return -1;
271 if (!hapd->driver->get_survey)
272 return -1;
273 return hapd->driver->get_survey(hapd->drv_priv, freq);
274 }
275
hostapd_get_country(struct hostapd_data * hapd,char * alpha2)276 static inline int hostapd_get_country(struct hostapd_data *hapd, char *alpha2)
277 {
278 if (hapd->driver == NULL || hapd->driver->get_country == NULL)
279 return -1;
280 return hapd->driver->get_country(hapd->drv_priv, alpha2);
281 }
282
hostapd_drv_get_radio_name(struct hostapd_data * hapd)283 static inline const char * hostapd_drv_get_radio_name(struct hostapd_data *hapd)
284 {
285 if (hapd->driver == NULL || hapd->drv_priv == NULL ||
286 hapd->driver->get_radio_name == NULL)
287 return NULL;
288 return hapd->driver->get_radio_name(hapd->drv_priv);
289 }
290
hostapd_drv_switch_channel(struct hostapd_data * hapd,struct csa_settings * settings)291 static inline int hostapd_drv_switch_channel(struct hostapd_data *hapd,
292 struct csa_settings *settings)
293 {
294 if (hapd->driver == NULL || hapd->driver->switch_channel == NULL ||
295 hapd->drv_priv == NULL)
296 return -1;
297
298 return hapd->driver->switch_channel(hapd->drv_priv, settings);
299 }
300
hostapd_drv_status(struct hostapd_data * hapd,char * buf,size_t buflen)301 static inline int hostapd_drv_status(struct hostapd_data *hapd, char *buf,
302 size_t buflen)
303 {
304 if (!hapd->driver || !hapd->driver->status || !hapd->drv_priv)
305 return -1;
306 return hapd->driver->status(hapd->drv_priv, buf, buflen);
307 }
308
hostapd_drv_br_add_ip_neigh(struct hostapd_data * hapd,int version,const u8 * ipaddr,int prefixlen,const u8 * addr)309 static inline int hostapd_drv_br_add_ip_neigh(struct hostapd_data *hapd,
310 int version, const u8 *ipaddr,
311 int prefixlen, const u8 *addr)
312 {
313 if (hapd->driver == NULL || hapd->drv_priv == NULL ||
314 hapd->driver->br_add_ip_neigh == NULL)
315 return -1;
316 return hapd->driver->br_add_ip_neigh(hapd->drv_priv, version, ipaddr,
317 prefixlen, addr);
318 }
319
hostapd_drv_br_delete_ip_neigh(struct hostapd_data * hapd,u8 version,const u8 * ipaddr)320 static inline int hostapd_drv_br_delete_ip_neigh(struct hostapd_data *hapd,
321 u8 version, const u8 *ipaddr)
322 {
323 if (hapd->driver == NULL || hapd->drv_priv == NULL ||
324 hapd->driver->br_delete_ip_neigh == NULL)
325 return -1;
326 return hapd->driver->br_delete_ip_neigh(hapd->drv_priv, version,
327 ipaddr);
328 }
329
hostapd_drv_br_port_set_attr(struct hostapd_data * hapd,enum drv_br_port_attr attr,unsigned int val)330 static inline int hostapd_drv_br_port_set_attr(struct hostapd_data *hapd,
331 enum drv_br_port_attr attr,
332 unsigned int val)
333 {
334 if (hapd->driver == NULL || hapd->drv_priv == NULL ||
335 hapd->driver->br_port_set_attr == NULL)
336 return -1;
337 return hapd->driver->br_port_set_attr(hapd->drv_priv, attr, val);
338 }
339
hostapd_drv_br_set_net_param(struct hostapd_data * hapd,enum drv_br_net_param param,unsigned int val)340 static inline int hostapd_drv_br_set_net_param(struct hostapd_data *hapd,
341 enum drv_br_net_param param,
342 unsigned int val)
343 {
344 if (hapd->driver == NULL || hapd->drv_priv == NULL ||
345 hapd->driver->br_set_net_param == NULL)
346 return -1;
347 return hapd->driver->br_set_net_param(hapd->drv_priv, param, val);
348 }
349
hostapd_drv_vendor_cmd(struct hostapd_data * hapd,int vendor_id,int subcmd,const u8 * data,size_t data_len,struct wpabuf * buf)350 static inline int hostapd_drv_vendor_cmd(struct hostapd_data *hapd,
351 int vendor_id, int subcmd,
352 const u8 *data, size_t data_len,
353 struct wpabuf *buf)
354 {
355 if (hapd->driver == NULL || hapd->driver->vendor_cmd == NULL)
356 return -1;
357 return hapd->driver->vendor_cmd(hapd->drv_priv, vendor_id, subcmd, data,
358 data_len, buf);
359 }
360
hostapd_drv_stop_ap(struct hostapd_data * hapd)361 static inline int hostapd_drv_stop_ap(struct hostapd_data *hapd)
362 {
363 if (!hapd->driver || !hapd->driver->stop_ap || !hapd->drv_priv)
364 return 0;
365 return hapd->driver->stop_ap(hapd->drv_priv);
366 }
367
hostapd_drv_channel_info(struct hostapd_data * hapd,struct wpa_channel_info * ci)368 static inline int hostapd_drv_channel_info(struct hostapd_data *hapd,
369 struct wpa_channel_info *ci)
370 {
371 if (!hapd->driver || !hapd->driver->channel_info)
372 return -1;
373 return hapd->driver->channel_info(hapd->drv_priv, ci);
374 }
375
376 static inline int
hostapd_drv_send_external_auth_status(struct hostapd_data * hapd,struct external_auth * params)377 hostapd_drv_send_external_auth_status(struct hostapd_data *hapd,
378 struct external_auth *params)
379 {
380 if (!hapd->driver || !hapd->drv_priv ||
381 !hapd->driver->send_external_auth_status)
382 return -1;
383 return hapd->driver->send_external_auth_status(hapd->drv_priv, params);
384 }
385
386 static inline int
hostapd_drv_set_band(struct hostapd_data * hapd,enum set_band band)387 hostapd_drv_set_band(struct hostapd_data *hapd, enum set_band band)
388 {
389 if (!hapd->driver || !hapd->drv_priv || !hapd->driver->set_band)
390 return -1;
391 return hapd->driver->set_band(hapd->drv_priv, band);
392 }
393
394 #endif /* AP_DRV_OPS */
395