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