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