1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright 2002-2005, Instant802 Networks, Inc. 4 * Copyright 2005, Devicescape Software, Inc. 5 * Copyright 2006-2007 Jiri Benc <jbenc@suse.cz> 6 * Copyright 2007-2010 Johannes Berg <johannes@sipsolutions.net> 7 * Copyright 2013-2015 Intel Mobile Communications GmbH 8 * Copyright (C) 2018-2024 Intel Corporation 9 */ 10 11 #ifndef IEEE80211_I_H 12 #define IEEE80211_I_H 13 14 #include <linux/kernel.h> 15 #include <linux/device.h> 16 #include <linux/if_ether.h> 17 #include <linux/interrupt.h> 18 #include <linux/list.h> 19 #include <linux/netdevice.h> 20 #include <linux/skbuff.h> 21 #include <linux/workqueue.h> 22 #include <linux/types.h> 23 #include <linux/spinlock.h> 24 #include <linux/etherdevice.h> 25 #include <linux/leds.h> 26 #include <linux/idr.h> 27 #include <linux/rhashtable.h> 28 #include <linux/rbtree.h> 29 #include <net/ieee80211_radiotap.h> 30 #include <net/cfg80211.h> 31 #include <net/mac80211.h> 32 #include <net/fq.h> 33 #include "key.h" 34 #include "sta_info.h" 35 #include "debug.h" 36 #include "drop.h" 37 38 extern const struct cfg80211_ops mac80211_config_ops; 39 40 struct ieee80211_local; 41 struct ieee80211_mesh_fast_tx; 42 43 /* Maximum number of broadcast/multicast frames to buffer when some of the 44 * associated stations are using power saving. */ 45 #define AP_MAX_BC_BUFFER 128 46 47 /* Maximum number of frames buffered to all STAs, including multicast frames. 48 * Note: increasing this limit increases the potential memory requirement. Each 49 * frame can be up to about 2 kB long. */ 50 #define TOTAL_MAX_TX_BUFFER 512 51 52 /* Required encryption head and tailroom */ 53 #define IEEE80211_ENCRYPT_HEADROOM 8 54 #define IEEE80211_ENCRYPT_TAILROOM 18 55 56 /* power level hasn't been configured (or set to automatic) */ 57 #define IEEE80211_UNSET_POWER_LEVEL INT_MIN 58 59 /* 60 * Some APs experience problems when working with U-APSD. Decreasing the 61 * probability of that happening by using legacy mode for all ACs but VO isn't 62 * enough. 63 * 64 * Cisco 4410N originally forced us to enable VO by default only because it 65 * treated non-VO ACs as legacy. 66 * 67 * However some APs (notably Netgear R7000) silently reclassify packets to 68 * different ACs. Since u-APSD ACs require trigger frames for frame retrieval 69 * clients would never see some frames (e.g. ARP responses) or would fetch them 70 * accidentally after a long time. 71 * 72 * It makes little sense to enable u-APSD queues by default because it needs 73 * userspace applications to be aware of it to actually take advantage of the 74 * possible additional powersavings. Implicitly depending on driver autotrigger 75 * frame support doesn't make much sense. 76 */ 77 #define IEEE80211_DEFAULT_UAPSD_QUEUES 0 78 79 #define IEEE80211_DEFAULT_MAX_SP_LEN \ 80 IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL 81 82 extern const u8 ieee80211_ac_to_qos_mask[IEEE80211_NUM_ACS]; 83 84 #define IEEE80211_DEAUTH_FRAME_LEN (24 /* hdr */ + 2 /* reason */) 85 86 #define IEEE80211_MAX_NAN_INSTANCE_ID 255 87 88 enum ieee80211_status_data { 89 IEEE80211_STATUS_TYPE_MASK = 0x00f, 90 IEEE80211_STATUS_TYPE_INVALID = 0, 91 IEEE80211_STATUS_TYPE_SMPS = 1, 92 IEEE80211_STATUS_SUBDATA_MASK = 0xff0, 93 }; 94 95 static inline bool 96 ieee80211_sta_keep_active(struct sta_info *sta, u8 ac) 97 { 98 /* Keep a station's queues on the active list for deficit accounting 99 * purposes if it was active or queued during the last 100ms. 100 */ 101 return time_before_eq(jiffies, sta->airtime[ac].last_active + HZ / 10); 102 } 103 104 struct ieee80211_bss { 105 u32 device_ts_beacon, device_ts_presp; 106 107 bool wmm_used; 108 bool uapsd_supported; 109 110 #define IEEE80211_MAX_SUPP_RATES 32 111 u8 supp_rates[IEEE80211_MAX_SUPP_RATES]; 112 size_t supp_rates_len; 113 struct ieee80211_rate *beacon_rate; 114 115 u32 vht_cap_info; 116 117 /* 118 * During association, we save an ERP value from a probe response so 119 * that we can feed ERP info to the driver when handling the 120 * association completes. these fields probably won't be up-to-date 121 * otherwise, you probably don't want to use them. 122 */ 123 bool has_erp_value; 124 u8 erp_value; 125 126 /* Keep track of the corruption of the last beacon/probe response. */ 127 u8 corrupt_data; 128 129 /* Keep track of what bits of information we have valid info for. */ 130 u8 valid_data; 131 }; 132 133 /** 134 * enum ieee80211_corrupt_data_flags - BSS data corruption flags 135 * @IEEE80211_BSS_CORRUPT_BEACON: last beacon frame received was corrupted 136 * @IEEE80211_BSS_CORRUPT_PROBE_RESP: last probe response received was corrupted 137 * 138 * These are bss flags that are attached to a bss in the 139 * @corrupt_data field of &struct ieee80211_bss. 140 */ 141 enum ieee80211_bss_corrupt_data_flags { 142 IEEE80211_BSS_CORRUPT_BEACON = BIT(0), 143 IEEE80211_BSS_CORRUPT_PROBE_RESP = BIT(1) 144 }; 145 146 /** 147 * enum ieee80211_valid_data_flags - BSS valid data flags 148 * @IEEE80211_BSS_VALID_WMM: WMM/UAPSD data was gathered from non-corrupt IE 149 * @IEEE80211_BSS_VALID_RATES: Supported rates were gathered from non-corrupt IE 150 * @IEEE80211_BSS_VALID_ERP: ERP flag was gathered from non-corrupt IE 151 * 152 * These are bss flags that are attached to a bss in the 153 * @valid_data field of &struct ieee80211_bss. They show which parts 154 * of the data structure were received as a result of an un-corrupted 155 * beacon/probe response. 156 */ 157 enum ieee80211_bss_valid_data_flags { 158 IEEE80211_BSS_VALID_WMM = BIT(1), 159 IEEE80211_BSS_VALID_RATES = BIT(2), 160 IEEE80211_BSS_VALID_ERP = BIT(3) 161 }; 162 163 typedef unsigned __bitwise ieee80211_tx_result; 164 #define TX_CONTINUE ((__force ieee80211_tx_result) 0u) 165 #define TX_DROP ((__force ieee80211_tx_result) 1u) 166 #define TX_QUEUED ((__force ieee80211_tx_result) 2u) 167 168 #define IEEE80211_TX_UNICAST BIT(1) 169 #define IEEE80211_TX_PS_BUFFERED BIT(2) 170 171 struct ieee80211_tx_data { 172 struct sk_buff *skb; 173 struct sk_buff_head skbs; 174 struct ieee80211_local *local; 175 struct ieee80211_sub_if_data *sdata; 176 struct sta_info *sta; 177 struct ieee80211_key *key; 178 struct ieee80211_tx_rate rate; 179 180 unsigned int flags; 181 }; 182 183 /** 184 * enum ieee80211_packet_rx_flags - packet RX flags 185 * @IEEE80211_RX_AMSDU: a-MSDU packet 186 * @IEEE80211_RX_MALFORMED_ACTION_FRM: action frame is malformed 187 * @IEEE80211_RX_DEFERRED_RELEASE: frame was subjected to receive reordering 188 * 189 * These are per-frame flags that are attached to a frame in the 190 * @rx_flags field of &struct ieee80211_rx_status. 191 */ 192 enum ieee80211_packet_rx_flags { 193 IEEE80211_RX_AMSDU = BIT(3), 194 IEEE80211_RX_MALFORMED_ACTION_FRM = BIT(4), 195 IEEE80211_RX_DEFERRED_RELEASE = BIT(5), 196 }; 197 198 /** 199 * enum ieee80211_rx_flags - RX data flags 200 * 201 * @IEEE80211_RX_CMNTR: received on cooked monitor already 202 * @IEEE80211_RX_BEACON_REPORTED: This frame was already reported 203 * to cfg80211_report_obss_beacon(). 204 * 205 * These flags are used across handling multiple interfaces 206 * for a single frame. 207 */ 208 enum ieee80211_rx_flags { 209 IEEE80211_RX_CMNTR = BIT(0), 210 IEEE80211_RX_BEACON_REPORTED = BIT(1), 211 }; 212 213 struct ieee80211_rx_data { 214 struct list_head *list; 215 struct sk_buff *skb; 216 struct ieee80211_local *local; 217 struct ieee80211_sub_if_data *sdata; 218 struct ieee80211_link_data *link; 219 struct sta_info *sta; 220 struct link_sta_info *link_sta; 221 struct ieee80211_key *key; 222 223 unsigned int flags; 224 225 /* 226 * Index into sequence numbers array, 0..16 227 * since the last (16) is used for non-QoS, 228 * will be 16 on non-QoS frames. 229 */ 230 int seqno_idx; 231 232 /* 233 * Index into the security IV/PN arrays, 0..16 234 * since the last (16) is used for CCMP-encrypted 235 * management frames, will be set to 16 on mgmt 236 * frames and 0 on non-QoS frames. 237 */ 238 int security_idx; 239 240 int link_id; 241 242 union { 243 struct { 244 u32 iv32; 245 u16 iv16; 246 } tkip; 247 struct { 248 u8 pn[IEEE80211_CCMP_PN_LEN]; 249 } ccm_gcm; 250 }; 251 }; 252 253 struct ieee80211_csa_settings { 254 const u16 *counter_offsets_beacon; 255 const u16 *counter_offsets_presp; 256 257 int n_counter_offsets_beacon; 258 int n_counter_offsets_presp; 259 260 u8 count; 261 }; 262 263 struct ieee80211_color_change_settings { 264 u16 counter_offset_beacon; 265 u16 counter_offset_presp; 266 u8 count; 267 }; 268 269 struct beacon_data { 270 u8 *head, *tail; 271 int head_len, tail_len; 272 struct ieee80211_meshconf_ie *meshconf; 273 u16 cntdwn_counter_offsets[IEEE80211_MAX_CNTDWN_COUNTERS_NUM]; 274 u8 cntdwn_current_counter; 275 struct cfg80211_mbssid_elems *mbssid_ies; 276 struct cfg80211_rnr_elems *rnr_ies; 277 struct rcu_head rcu_head; 278 }; 279 280 struct probe_resp { 281 struct rcu_head rcu_head; 282 int len; 283 u16 cntdwn_counter_offsets[IEEE80211_MAX_CNTDWN_COUNTERS_NUM]; 284 u8 data[]; 285 }; 286 287 struct fils_discovery_data { 288 struct rcu_head rcu_head; 289 int len; 290 u8 data[]; 291 }; 292 293 struct unsol_bcast_probe_resp_data { 294 struct rcu_head rcu_head; 295 int len; 296 u8 data[]; 297 }; 298 299 struct ps_data { 300 /* yes, this looks ugly, but guarantees that we can later use 301 * bitmap_empty :) 302 * NB: don't touch this bitmap, use sta_info_{set,clear}_tim_bit */ 303 u8 tim[sizeof(unsigned long) * BITS_TO_LONGS(IEEE80211_MAX_AID + 1)] 304 __aligned(__alignof__(unsigned long)); 305 struct sk_buff_head bc_buf; 306 atomic_t num_sta_ps; /* number of stations in PS mode */ 307 int dtim_count; 308 bool dtim_bc_mc; 309 }; 310 311 struct ieee80211_if_ap { 312 struct list_head vlans; /* write-protected with RTNL and local->mtx */ 313 314 struct ps_data ps; 315 atomic_t num_mcast_sta; /* number of stations receiving multicast */ 316 317 bool multicast_to_unicast; 318 bool active; 319 }; 320 321 struct ieee80211_if_vlan { 322 struct list_head list; /* write-protected with RTNL and local->mtx */ 323 324 /* used for all tx if the VLAN is configured to 4-addr mode */ 325 struct sta_info __rcu *sta; 326 atomic_t num_mcast_sta; /* number of stations receiving multicast */ 327 }; 328 329 struct mesh_stats { 330 __u32 fwded_mcast; /* Mesh forwarded multicast frames */ 331 __u32 fwded_unicast; /* Mesh forwarded unicast frames */ 332 __u32 fwded_frames; /* Mesh total forwarded frames */ 333 __u32 dropped_frames_ttl; /* Not transmitted since mesh_ttl == 0*/ 334 __u32 dropped_frames_no_route; /* Not transmitted, no route found */ 335 }; 336 337 #define PREQ_Q_F_START 0x1 338 #define PREQ_Q_F_REFRESH 0x2 339 struct mesh_preq_queue { 340 struct list_head list; 341 u8 dst[ETH_ALEN]; 342 u8 flags; 343 }; 344 345 struct ieee80211_roc_work { 346 struct list_head list; 347 348 struct ieee80211_sub_if_data *sdata; 349 350 struct ieee80211_channel *chan; 351 352 bool started, abort, hw_begun, notified; 353 bool on_channel; 354 355 unsigned long start_time; 356 357 u32 duration, req_duration; 358 struct sk_buff *frame; 359 u64 cookie, mgmt_tx_cookie; 360 enum ieee80211_roc_type type; 361 }; 362 363 /* flags used in struct ieee80211_if_managed.flags */ 364 enum ieee80211_sta_flags { 365 IEEE80211_STA_CONNECTION_POLL = BIT(1), 366 IEEE80211_STA_CONTROL_PORT = BIT(2), 367 IEEE80211_STA_MFP_ENABLED = BIT(6), 368 IEEE80211_STA_UAPSD_ENABLED = BIT(7), 369 IEEE80211_STA_NULLFUNC_ACKED = BIT(8), 370 IEEE80211_STA_ENABLE_RRM = BIT(15), 371 }; 372 373 enum ieee80211_conn_mode { 374 IEEE80211_CONN_MODE_S1G, 375 IEEE80211_CONN_MODE_LEGACY, 376 IEEE80211_CONN_MODE_HT, 377 IEEE80211_CONN_MODE_VHT, 378 IEEE80211_CONN_MODE_HE, 379 IEEE80211_CONN_MODE_EHT, 380 }; 381 382 #define IEEE80211_CONN_MODE_HIGHEST IEEE80211_CONN_MODE_EHT 383 384 enum ieee80211_conn_bw_limit { 385 IEEE80211_CONN_BW_LIMIT_20, 386 IEEE80211_CONN_BW_LIMIT_40, 387 IEEE80211_CONN_BW_LIMIT_80, 388 IEEE80211_CONN_BW_LIMIT_160, /* also 80+80 */ 389 IEEE80211_CONN_BW_LIMIT_320, 390 }; 391 392 struct ieee80211_conn_settings { 393 enum ieee80211_conn_mode mode; 394 enum ieee80211_conn_bw_limit bw_limit; 395 }; 396 397 extern const struct ieee80211_conn_settings ieee80211_conn_settings_unlimited; 398 399 struct ieee80211_mgd_auth_data { 400 struct cfg80211_bss *bss; 401 unsigned long timeout; 402 int tries; 403 u16 algorithm, expected_transaction; 404 405 u8 key[WLAN_KEY_LEN_WEP104]; 406 u8 key_len, key_idx; 407 bool done, waiting; 408 bool peer_confirmed; 409 bool timeout_started; 410 int link_id; 411 412 u8 ap_addr[ETH_ALEN] __aligned(2); 413 414 u16 sae_trans, sae_status; 415 size_t data_len; 416 u8 data[]; 417 }; 418 419 struct ieee80211_mgd_assoc_data { 420 struct { 421 struct cfg80211_bss *bss; 422 423 u8 addr[ETH_ALEN] __aligned(2); 424 425 u8 ap_ht_param; 426 427 struct ieee80211_vht_cap ap_vht_cap; 428 429 size_t elems_len; 430 u8 *elems; /* pointing to inside ie[] below */ 431 432 struct ieee80211_conn_settings conn; 433 434 u16 status; 435 436 bool disabled; 437 } link[IEEE80211_MLD_MAX_NUM_LINKS]; 438 439 u8 ap_addr[ETH_ALEN] __aligned(2); 440 441 /* this is for a workaround, so we use it only for non-MLO */ 442 const u8 *supp_rates; 443 u8 supp_rates_len; 444 445 unsigned long timeout; 446 int tries; 447 448 u8 prev_ap_addr[ETH_ALEN]; 449 u8 ssid[IEEE80211_MAX_SSID_LEN]; 450 u8 ssid_len; 451 bool wmm, uapsd; 452 bool need_beacon; 453 bool synced; 454 bool timeout_started; 455 bool comeback; /* whether the AP has requested association comeback */ 456 bool s1g; 457 bool spp_amsdu; 458 459 unsigned int assoc_link_id; 460 461 u8 fils_nonces[2 * FILS_NONCE_LEN]; 462 u8 fils_kek[FILS_MAX_KEK_LEN]; 463 size_t fils_kek_len; 464 465 size_t ie_len; 466 u8 *ie_pos; /* used to fill ie[] with link[].elems */ 467 u8 ie[]; 468 }; 469 470 struct ieee80211_sta_tx_tspec { 471 /* timestamp of the first packet in the time slice */ 472 unsigned long time_slice_start; 473 474 u32 admitted_time; /* in usecs, unlike over the air */ 475 u8 tsid; 476 s8 up; /* signed to be able to invalidate with -1 during teardown */ 477 478 /* consumed TX time in microseconds in the time slice */ 479 u32 consumed_tx_time; 480 enum { 481 TX_TSPEC_ACTION_NONE = 0, 482 TX_TSPEC_ACTION_DOWNGRADE, 483 TX_TSPEC_ACTION_STOP_DOWNGRADE, 484 } action; 485 bool downgraded; 486 }; 487 488 /* Advertised TID-to-link mapping info */ 489 struct ieee80211_adv_ttlm_info { 490 /* time in TUs at which the new mapping is established, or 0 if there is 491 * no planned advertised TID-to-link mapping 492 */ 493 u16 switch_time; 494 u32 duration; /* duration of the planned T2L map in TUs */ 495 u16 map; /* map of usable links for all TIDs */ 496 bool active; /* whether the advertised mapping is active or not */ 497 }; 498 499 DECLARE_EWMA(beacon_signal, 4, 4) 500 501 struct ieee80211_if_managed { 502 struct timer_list timer; 503 struct timer_list conn_mon_timer; 504 struct timer_list bcn_mon_timer; 505 struct wiphy_work monitor_work; 506 struct wiphy_work beacon_connection_loss_work; 507 struct wiphy_work csa_connection_drop_work; 508 509 unsigned long beacon_timeout; 510 unsigned long probe_timeout; 511 int probe_send_count; 512 bool nullfunc_failed; 513 u8 connection_loss:1, 514 driver_disconnect:1, 515 reconnect:1, 516 associated:1; 517 518 struct ieee80211_mgd_auth_data *auth_data; 519 struct ieee80211_mgd_assoc_data *assoc_data; 520 521 bool powersave; /* powersave requested for this iface */ 522 bool broken_ap; /* AP is broken -- turn off powersave */ 523 524 unsigned int flags; 525 526 u16 mcast_seq_last; 527 528 bool status_acked; 529 bool status_received; 530 __le16 status_fc; 531 532 enum { 533 IEEE80211_MFP_DISABLED, 534 IEEE80211_MFP_OPTIONAL, 535 IEEE80211_MFP_REQUIRED 536 } mfp; /* management frame protection */ 537 538 /* 539 * Bitmask of enabled u-apsd queues, 540 * IEEE80211_WMM_IE_STA_QOSINFO_AC_BE & co. Needs a new association 541 * to take effect. 542 */ 543 unsigned int uapsd_queues; 544 545 /* 546 * Maximum number of buffered frames AP can deliver during a 547 * service period, IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL or similar. 548 * Needs a new association to take effect. 549 */ 550 unsigned int uapsd_max_sp_len; 551 552 u8 use_4addr; 553 554 /* 555 * State variables for keeping track of RSSI of the AP currently 556 * connected to and informing driver when RSSI has gone 557 * below/above a certain threshold. 558 */ 559 int rssi_min_thold, rssi_max_thold; 560 561 struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */ 562 struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */ 563 struct ieee80211_vht_cap vht_capa; /* configured VHT overrides */ 564 struct ieee80211_vht_cap vht_capa_mask; /* Valid parts of vht_capa */ 565 struct ieee80211_s1g_cap s1g_capa; /* configured S1G overrides */ 566 struct ieee80211_s1g_cap s1g_capa_mask; /* valid s1g_capa bits */ 567 568 /* TDLS support */ 569 u8 tdls_peer[ETH_ALEN] __aligned(2); 570 struct wiphy_delayed_work tdls_peer_del_work; 571 struct sk_buff *orig_teardown_skb; /* The original teardown skb */ 572 struct sk_buff *teardown_skb; /* A copy to send through the AP */ 573 spinlock_t teardown_lock; /* To lock changing teardown_skb */ 574 bool tdls_wider_bw_prohibited; 575 576 /* WMM-AC TSPEC support */ 577 struct ieee80211_sta_tx_tspec tx_tspec[IEEE80211_NUM_ACS]; 578 /* Use a separate work struct so that we can do something here 579 * while the sdata->work is flushing the queues, for example. 580 * otherwise, in scenarios where we hardly get any traffic out 581 * on the BE queue, but there's a lot of VO traffic, we might 582 * get stuck in a downgraded situation and flush takes forever. 583 */ 584 struct wiphy_delayed_work tx_tspec_wk; 585 586 /* Information elements from the last transmitted (Re)Association 587 * Request frame. 588 */ 589 u8 *assoc_req_ies; 590 size_t assoc_req_ies_len; 591 592 struct wiphy_delayed_work ml_reconf_work; 593 u16 removed_links; 594 595 /* TID-to-link mapping support */ 596 struct wiphy_delayed_work ttlm_work; 597 struct ieee80211_adv_ttlm_info ttlm_info; 598 599 /* dialog token enumerator for neg TTLM request */ 600 u8 dialog_token_alloc; 601 struct wiphy_delayed_work neg_ttlm_timeout_work; 602 }; 603 604 struct ieee80211_if_ibss { 605 struct timer_list timer; 606 struct wiphy_work csa_connection_drop_work; 607 608 unsigned long last_scan_completed; 609 610 u32 basic_rates; 611 612 bool fixed_bssid; 613 bool fixed_channel; 614 bool privacy; 615 616 bool control_port; 617 bool userspace_handles_dfs; 618 619 u8 bssid[ETH_ALEN] __aligned(2); 620 u8 ssid[IEEE80211_MAX_SSID_LEN]; 621 u8 ssid_len, ie_len; 622 u8 *ie; 623 struct cfg80211_chan_def chandef; 624 625 unsigned long ibss_join_req; 626 /* probe response/beacon for IBSS */ 627 struct beacon_data __rcu *presp; 628 629 struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */ 630 struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */ 631 632 spinlock_t incomplete_lock; 633 struct list_head incomplete_stations; 634 635 enum { 636 IEEE80211_IBSS_MLME_SEARCH, 637 IEEE80211_IBSS_MLME_JOINED, 638 } state; 639 }; 640 641 /** 642 * struct ieee80211_if_ocb - OCB mode state 643 * 644 * @housekeeping_timer: timer for periodic invocation of a housekeeping task 645 * @wrkq_flags: OCB deferred task action 646 * @incomplete_lock: delayed STA insertion lock 647 * @incomplete_stations: list of STAs waiting for delayed insertion 648 * @joined: indication if the interface is connected to an OCB network 649 */ 650 struct ieee80211_if_ocb { 651 struct timer_list housekeeping_timer; 652 unsigned long wrkq_flags; 653 654 spinlock_t incomplete_lock; 655 struct list_head incomplete_stations; 656 657 bool joined; 658 }; 659 660 /** 661 * struct ieee80211_mesh_sync_ops - Extensible synchronization framework interface 662 * 663 * these declarations define the interface, which enables 664 * vendor-specific mesh synchronization 665 * 666 * @rx_bcn_presp: beacon/probe response was received 667 * @adjust_tsf: TSF adjustment method 668 */ 669 struct ieee80211_mesh_sync_ops { 670 void (*rx_bcn_presp)(struct ieee80211_sub_if_data *sdata, u16 stype, 671 struct ieee80211_mgmt *mgmt, unsigned int len, 672 const struct ieee80211_meshconf_ie *mesh_cfg, 673 struct ieee80211_rx_status *rx_status); 674 675 /* should be called with beacon_data under RCU read lock */ 676 void (*adjust_tsf)(struct ieee80211_sub_if_data *sdata, 677 struct beacon_data *beacon); 678 /* add other framework functions here */ 679 }; 680 681 struct mesh_csa_settings { 682 struct rcu_head rcu_head; 683 struct cfg80211_csa_settings settings; 684 }; 685 686 /** 687 * struct mesh_table 688 * 689 * @known_gates: list of known mesh gates and their mpaths by the station. The 690 * gate's mpath may or may not be resolved and active. 691 * @gates_lock: protects updates to known_gates 692 * @rhead: the rhashtable containing struct mesh_paths, keyed by dest addr 693 * @walk_head: linked list containing all mesh_path objects 694 * @walk_lock: lock protecting walk_head 695 * @entries: number of entries in the table 696 */ 697 struct mesh_table { 698 struct hlist_head known_gates; 699 spinlock_t gates_lock; 700 struct rhashtable rhead; 701 struct hlist_head walk_head; 702 spinlock_t walk_lock; 703 atomic_t entries; /* Up to MAX_MESH_NEIGHBOURS */ 704 }; 705 706 /** 707 * struct mesh_tx_cache - mesh fast xmit header cache 708 * 709 * @rht: hash table containing struct ieee80211_mesh_fast_tx, using skb DA as key 710 * @walk_head: linked list containing all ieee80211_mesh_fast_tx objects 711 * @walk_lock: lock protecting walk_head and rht 712 */ 713 struct mesh_tx_cache { 714 struct rhashtable rht; 715 struct hlist_head walk_head; 716 spinlock_t walk_lock; 717 }; 718 719 struct ieee80211_if_mesh { 720 struct timer_list housekeeping_timer; 721 struct timer_list mesh_path_timer; 722 struct timer_list mesh_path_root_timer; 723 724 unsigned long wrkq_flags; 725 unsigned long mbss_changed[64 / BITS_PER_LONG]; 726 727 bool userspace_handles_dfs; 728 729 u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN]; 730 size_t mesh_id_len; 731 /* Active Path Selection Protocol Identifier */ 732 u8 mesh_pp_id; 733 /* Active Path Selection Metric Identifier */ 734 u8 mesh_pm_id; 735 /* Congestion Control Mode Identifier */ 736 u8 mesh_cc_id; 737 /* Synchronization Protocol Identifier */ 738 u8 mesh_sp_id; 739 /* Authentication Protocol Identifier */ 740 u8 mesh_auth_id; 741 /* Local mesh Sequence Number */ 742 u32 sn; 743 /* Last used PREQ ID */ 744 u32 preq_id; 745 atomic_t mpaths; 746 /* Timestamp of last SN update */ 747 unsigned long last_sn_update; 748 /* Time when it's ok to send next PERR */ 749 unsigned long next_perr; 750 /* Timestamp of last PREQ sent */ 751 unsigned long last_preq; 752 struct mesh_rmc *rmc; 753 spinlock_t mesh_preq_queue_lock; 754 struct mesh_preq_queue preq_queue; 755 int preq_queue_len; 756 struct mesh_stats mshstats; 757 struct mesh_config mshcfg; 758 atomic_t estab_plinks; 759 atomic_t mesh_seqnum; 760 bool accepting_plinks; 761 int num_gates; 762 struct beacon_data __rcu *beacon; 763 const u8 *ie; 764 u8 ie_len; 765 enum { 766 IEEE80211_MESH_SEC_NONE = 0x0, 767 IEEE80211_MESH_SEC_AUTHED = 0x1, 768 IEEE80211_MESH_SEC_SECURED = 0x2, 769 } security; 770 bool user_mpm; 771 /* Extensible Synchronization Framework */ 772 const struct ieee80211_mesh_sync_ops *sync_ops; 773 s64 sync_offset_clockdrift_max; 774 spinlock_t sync_offset_lock; 775 /* mesh power save */ 776 enum nl80211_mesh_power_mode nonpeer_pm; 777 int ps_peers_light_sleep; 778 int ps_peers_deep_sleep; 779 struct ps_data ps; 780 /* Channel Switching Support */ 781 struct mesh_csa_settings __rcu *csa; 782 enum { 783 IEEE80211_MESH_CSA_ROLE_NONE, 784 IEEE80211_MESH_CSA_ROLE_INIT, 785 IEEE80211_MESH_CSA_ROLE_REPEATER, 786 } csa_role; 787 u8 chsw_ttl; 788 u16 pre_value; 789 790 /* offset from skb->data while building IE */ 791 int meshconf_offset; 792 793 struct mesh_table mesh_paths; 794 struct mesh_table mpp_paths; /* Store paths for MPP&MAP */ 795 int mesh_paths_generation; 796 int mpp_paths_generation; 797 struct mesh_tx_cache tx_cache; 798 }; 799 800 #ifdef CONFIG_MAC80211_MESH 801 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \ 802 do { (msh)->mshstats.name++; } while (0) 803 #else 804 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \ 805 do { } while (0) 806 #endif 807 808 /** 809 * enum ieee80211_sub_if_data_flags - virtual interface flags 810 * 811 * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets 812 * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between 813 * associated stations and deliver multicast frames both 814 * back to wireless media and to the local net stack. 815 * @IEEE80211_SDATA_DISCONNECT_RESUME: Disconnect after resume. 816 * @IEEE80211_SDATA_IN_DRIVER: indicates interface was added to driver 817 * @IEEE80211_SDATA_DISCONNECT_HW_RESTART: Disconnect after hardware restart 818 * recovery 819 */ 820 enum ieee80211_sub_if_data_flags { 821 IEEE80211_SDATA_ALLMULTI = BIT(0), 822 IEEE80211_SDATA_DONT_BRIDGE_PACKETS = BIT(3), 823 IEEE80211_SDATA_DISCONNECT_RESUME = BIT(4), 824 IEEE80211_SDATA_IN_DRIVER = BIT(5), 825 IEEE80211_SDATA_DISCONNECT_HW_RESTART = BIT(6), 826 }; 827 828 /** 829 * enum ieee80211_sdata_state_bits - virtual interface state bits 830 * @SDATA_STATE_RUNNING: virtual interface is up & running; this 831 * mirrors netif_running() but is separate for interface type 832 * change handling while the interface is up 833 * @SDATA_STATE_OFFCHANNEL: This interface is currently in offchannel 834 * mode, so queues are stopped 835 * @SDATA_STATE_OFFCHANNEL_BEACON_STOPPED: Beaconing was stopped due 836 * to offchannel, reset when offchannel returns 837 */ 838 enum ieee80211_sdata_state_bits { 839 SDATA_STATE_RUNNING, 840 SDATA_STATE_OFFCHANNEL, 841 SDATA_STATE_OFFCHANNEL_BEACON_STOPPED, 842 }; 843 844 /** 845 * enum ieee80211_chanctx_mode - channel context configuration mode 846 * 847 * @IEEE80211_CHANCTX_SHARED: channel context may be used by 848 * multiple interfaces 849 * @IEEE80211_CHANCTX_EXCLUSIVE: channel context can be used 850 * only by a single interface. This can be used for example for 851 * non-fixed channel IBSS. 852 */ 853 enum ieee80211_chanctx_mode { 854 IEEE80211_CHANCTX_SHARED, 855 IEEE80211_CHANCTX_EXCLUSIVE 856 }; 857 858 /** 859 * enum ieee80211_chanctx_replace_state - channel context replacement state 860 * 861 * This is used for channel context in-place reservations that require channel 862 * context switch/swap. 863 * 864 * @IEEE80211_CHANCTX_REPLACE_NONE: no replacement is taking place 865 * @IEEE80211_CHANCTX_WILL_BE_REPLACED: this channel context will be replaced 866 * by a (not yet registered) channel context pointed by %replace_ctx. 867 * @IEEE80211_CHANCTX_REPLACES_OTHER: this (not yet registered) channel context 868 * replaces an existing channel context pointed to by %replace_ctx. 869 */ 870 enum ieee80211_chanctx_replace_state { 871 IEEE80211_CHANCTX_REPLACE_NONE, 872 IEEE80211_CHANCTX_WILL_BE_REPLACED, 873 IEEE80211_CHANCTX_REPLACES_OTHER, 874 }; 875 876 struct ieee80211_chanctx { 877 struct list_head list; 878 struct rcu_head rcu_head; 879 880 struct list_head assigned_links; 881 struct list_head reserved_links; 882 883 enum ieee80211_chanctx_replace_state replace_state; 884 struct ieee80211_chanctx *replace_ctx; 885 886 enum ieee80211_chanctx_mode mode; 887 bool driver_present; 888 889 /* temporary data for search algorithm etc. */ 890 struct ieee80211_chan_req req; 891 892 struct ieee80211_chanctx_conf conf; 893 }; 894 895 struct mac80211_qos_map { 896 struct cfg80211_qos_map qos_map; 897 struct rcu_head rcu_head; 898 }; 899 900 enum txq_info_flags { 901 IEEE80211_TXQ_STOP, 902 IEEE80211_TXQ_AMPDU, 903 IEEE80211_TXQ_NO_AMSDU, 904 IEEE80211_TXQ_DIRTY, 905 }; 906 907 /** 908 * struct txq_info - per tid queue 909 * 910 * @tin: contains packets split into multiple flows 911 * @def_cvars: codel vars for the @tin's default_flow 912 * @cstats: code statistics for this queue 913 * @frags: used to keep fragments created after dequeue 914 * @schedule_order: used with ieee80211_local->active_txqs 915 * @schedule_round: counter to prevent infinite loops on TXQ scheduling 916 * @flags: TXQ flags from &enum txq_info_flags 917 * @txq: the driver visible part 918 */ 919 struct txq_info { 920 struct fq_tin tin; 921 struct codel_vars def_cvars; 922 struct codel_stats cstats; 923 924 u16 schedule_round; 925 struct list_head schedule_order; 926 927 struct sk_buff_head frags; 928 929 unsigned long flags; 930 931 /* keep last! */ 932 struct ieee80211_txq txq; 933 }; 934 935 struct ieee80211_if_mntr { 936 u32 flags; 937 u8 mu_follow_addr[ETH_ALEN] __aligned(2); 938 939 struct list_head list; 940 }; 941 942 /** 943 * struct ieee80211_if_nan - NAN state 944 * 945 * @conf: current NAN configuration 946 * @func_lock: lock for @func_inst_ids 947 * @function_inst_ids: a bitmap of available instance_id's 948 */ 949 struct ieee80211_if_nan { 950 struct cfg80211_nan_conf conf; 951 952 /* protects function_inst_ids */ 953 spinlock_t func_lock; 954 struct idr function_inst_ids; 955 }; 956 957 struct ieee80211_link_data_managed { 958 u8 bssid[ETH_ALEN] __aligned(2); 959 960 u8 dtim_period; 961 enum ieee80211_smps_mode req_smps, /* requested smps mode */ 962 driver_smps_mode; /* smps mode request */ 963 964 struct ieee80211_conn_settings conn; 965 966 s16 p2p_noa_index; 967 968 bool tdls_chan_switch_prohibited; 969 970 bool have_beacon; 971 bool tracking_signal_avg; 972 bool disable_wmm_tracking; 973 bool operating_11g_mode; 974 975 bool csa_waiting_bcn; 976 bool csa_ignored_same_chan; 977 struct wiphy_delayed_work chswitch_work; 978 979 struct wiphy_work request_smps_work; 980 /* used to reconfigure hardware SM PS */ 981 struct wiphy_work recalc_smps; 982 983 bool beacon_crc_valid; 984 u32 beacon_crc; 985 struct ewma_beacon_signal ave_beacon_signal; 986 int last_ave_beacon_signal; 987 988 /* 989 * Number of Beacon frames used in ave_beacon_signal. This can be used 990 * to avoid generating less reliable cqm events that would be based 991 * only on couple of received frames. 992 */ 993 unsigned int count_beacon_signal; 994 995 /* Number of times beacon loss was invoked. */ 996 unsigned int beacon_loss_count; 997 998 /* 999 * Last Beacon frame signal strength average (ave_beacon_signal / 16) 1000 * that triggered a cqm event. 0 indicates that no event has been 1001 * generated for the current association. 1002 */ 1003 int last_cqm_event_signal; 1004 1005 int wmm_last_param_set; 1006 int mu_edca_last_param_set; 1007 1008 u8 bss_param_ch_cnt; 1009 1010 struct cfg80211_bss *bss; 1011 }; 1012 1013 struct ieee80211_link_data_ap { 1014 struct beacon_data __rcu *beacon; 1015 struct probe_resp __rcu *probe_resp; 1016 struct fils_discovery_data __rcu *fils_discovery; 1017 struct unsol_bcast_probe_resp_data __rcu *unsol_bcast_probe_resp; 1018 1019 /* to be used after channel switch. */ 1020 struct cfg80211_beacon_data *next_beacon; 1021 }; 1022 1023 struct ieee80211_link_data { 1024 struct ieee80211_sub_if_data *sdata; 1025 unsigned int link_id; 1026 1027 struct list_head assigned_chanctx_list; /* protected by wiphy mutex */ 1028 struct list_head reserved_chanctx_list; /* protected by wiphy mutex */ 1029 1030 /* multicast keys only */ 1031 struct ieee80211_key __rcu *gtk[NUM_DEFAULT_KEYS + 1032 NUM_DEFAULT_MGMT_KEYS + 1033 NUM_DEFAULT_BEACON_KEYS]; 1034 struct ieee80211_key __rcu *default_multicast_key; 1035 struct ieee80211_key __rcu *default_mgmt_key; 1036 struct ieee80211_key __rcu *default_beacon_key; 1037 1038 struct wiphy_work csa_finalize_work; 1039 bool csa_block_tx; 1040 1041 bool operating_11g_mode; 1042 1043 struct ieee80211_chan_req csa_chanreq; 1044 1045 struct wiphy_work color_change_finalize_work; 1046 struct delayed_work color_collision_detect_work; 1047 u64 color_bitmap; 1048 1049 /* context reservation -- protected with wiphy mutex */ 1050 struct ieee80211_chanctx *reserved_chanctx; 1051 struct ieee80211_chan_req reserved; 1052 bool reserved_radar_required; 1053 bool reserved_ready; 1054 1055 u8 needed_rx_chains; 1056 enum ieee80211_smps_mode smps_mode; 1057 1058 int user_power_level; /* in dBm */ 1059 int ap_power_level; /* in dBm */ 1060 1061 bool radar_required; 1062 struct wiphy_delayed_work dfs_cac_timer_work; 1063 1064 union { 1065 struct ieee80211_link_data_managed mgd; 1066 struct ieee80211_link_data_ap ap; 1067 } u; 1068 1069 struct ieee80211_tx_queue_params tx_conf[IEEE80211_NUM_ACS]; 1070 1071 struct ieee80211_bss_conf *conf; 1072 1073 #ifdef CONFIG_MAC80211_DEBUGFS 1074 struct dentry *debugfs_dir; 1075 #endif 1076 }; 1077 1078 struct ieee80211_sub_if_data { 1079 struct list_head list; 1080 1081 struct wireless_dev wdev; 1082 1083 /* keys */ 1084 struct list_head key_list; 1085 1086 /* count for keys needing tailroom space allocation */ 1087 int crypto_tx_tailroom_needed_cnt; 1088 int crypto_tx_tailroom_pending_dec; 1089 struct wiphy_delayed_work dec_tailroom_needed_wk; 1090 1091 struct net_device *dev; 1092 struct ieee80211_local *local; 1093 1094 unsigned int flags; 1095 1096 unsigned long state; 1097 1098 char name[IFNAMSIZ]; 1099 1100 struct ieee80211_fragment_cache frags; 1101 1102 /* TID bitmap for NoAck policy */ 1103 u16 noack_map; 1104 1105 /* bit field of ACM bits (BIT(802.1D tag)) */ 1106 u8 wmm_acm; 1107 1108 struct ieee80211_key __rcu *keys[NUM_DEFAULT_KEYS]; 1109 struct ieee80211_key __rcu *default_unicast_key; 1110 1111 u16 sequence_number; 1112 u16 mld_mcast_seq; 1113 __be16 control_port_protocol; 1114 bool control_port_no_encrypt; 1115 bool control_port_no_preauth; 1116 bool control_port_over_nl80211; 1117 1118 atomic_t num_tx_queued; 1119 struct mac80211_qos_map __rcu *qos_map; 1120 1121 struct wiphy_work work; 1122 struct sk_buff_head skb_queue; 1123 struct sk_buff_head status_queue; 1124 1125 /* 1126 * AP this belongs to: self in AP mode and 1127 * corresponding AP in VLAN mode, NULL for 1128 * all others (might be needed later in IBSS) 1129 */ 1130 struct ieee80211_if_ap *bss; 1131 1132 /* bitmap of allowed (non-MCS) rate indexes for rate control */ 1133 u32 rc_rateidx_mask[NUM_NL80211_BANDS]; 1134 1135 bool rc_has_mcs_mask[NUM_NL80211_BANDS]; 1136 u8 rc_rateidx_mcs_mask[NUM_NL80211_BANDS][IEEE80211_HT_MCS_MASK_LEN]; 1137 1138 bool rc_has_vht_mcs_mask[NUM_NL80211_BANDS]; 1139 u16 rc_rateidx_vht_mcs_mask[NUM_NL80211_BANDS][NL80211_VHT_NSS_MAX]; 1140 1141 /* Beacon frame (non-MCS) rate (as a bitmap) */ 1142 u32 beacon_rateidx_mask[NUM_NL80211_BANDS]; 1143 bool beacon_rate_set; 1144 1145 union { 1146 struct ieee80211_if_ap ap; 1147 struct ieee80211_if_vlan vlan; 1148 struct ieee80211_if_managed mgd; 1149 struct ieee80211_if_ibss ibss; 1150 struct ieee80211_if_mesh mesh; 1151 struct ieee80211_if_ocb ocb; 1152 struct ieee80211_if_mntr mntr; 1153 struct ieee80211_if_nan nan; 1154 } u; 1155 1156 struct ieee80211_link_data deflink; 1157 struct ieee80211_link_data __rcu *link[IEEE80211_MLD_MAX_NUM_LINKS]; 1158 1159 /* for ieee80211_set_active_links_async() */ 1160 struct wiphy_work activate_links_work; 1161 u16 desired_active_links; 1162 1163 #ifdef CONFIG_MAC80211_DEBUGFS 1164 struct { 1165 struct dentry *subdir_stations; 1166 struct dentry *default_unicast_key; 1167 struct dentry *default_multicast_key; 1168 struct dentry *default_mgmt_key; 1169 struct dentry *default_beacon_key; 1170 } debugfs; 1171 #endif 1172 1173 /* must be last, dynamically sized area in this! */ 1174 struct ieee80211_vif vif; 1175 }; 1176 1177 static inline 1178 struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p) 1179 { 1180 return container_of(p, struct ieee80211_sub_if_data, vif); 1181 } 1182 1183 #define sdata_dereference(p, sdata) \ 1184 wiphy_dereference(sdata->local->hw.wiphy, p) 1185 1186 #define for_each_sdata_link(_local, _link) \ 1187 /* outer loop just to define the variables ... */ \ 1188 for (struct ieee80211_sub_if_data *___sdata = NULL; \ 1189 !___sdata; \ 1190 ___sdata = (void *)~0 /* always stop */) \ 1191 list_for_each_entry(___sdata, &(_local)->interfaces, list) \ 1192 if (ieee80211_sdata_running(___sdata)) \ 1193 for (int ___link_id = 0; \ 1194 ___link_id < ARRAY_SIZE(___sdata->link); \ 1195 ___link_id++) \ 1196 if ((_link = wiphy_dereference((local)->hw.wiphy, \ 1197 ___sdata->link[___link_id]))) 1198 1199 static inline int 1200 ieee80211_get_mbssid_beacon_len(struct cfg80211_mbssid_elems *elems, 1201 struct cfg80211_rnr_elems *rnr_elems, 1202 u8 i) 1203 { 1204 int len = 0; 1205 1206 if (!elems || !elems->cnt || i > elems->cnt) 1207 return 0; 1208 1209 if (i < elems->cnt) { 1210 len = elems->elem[i].len; 1211 if (rnr_elems) { 1212 len += rnr_elems->elem[i].len; 1213 for (i = elems->cnt; i < rnr_elems->cnt; i++) 1214 len += rnr_elems->elem[i].len; 1215 } 1216 return len; 1217 } 1218 1219 /* i == elems->cnt, calculate total length of all MBSSID elements */ 1220 for (i = 0; i < elems->cnt; i++) 1221 len += elems->elem[i].len; 1222 1223 if (rnr_elems) { 1224 for (i = 0; i < rnr_elems->cnt; i++) 1225 len += rnr_elems->elem[i].len; 1226 } 1227 1228 return len; 1229 } 1230 1231 enum { 1232 IEEE80211_RX_MSG = 1, 1233 IEEE80211_TX_STATUS_MSG = 2, 1234 }; 1235 1236 enum queue_stop_reason { 1237 IEEE80211_QUEUE_STOP_REASON_DRIVER, 1238 IEEE80211_QUEUE_STOP_REASON_PS, 1239 IEEE80211_QUEUE_STOP_REASON_CSA, 1240 IEEE80211_QUEUE_STOP_REASON_AGGREGATION, 1241 IEEE80211_QUEUE_STOP_REASON_SUSPEND, 1242 IEEE80211_QUEUE_STOP_REASON_SKB_ADD, 1243 IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL, 1244 IEEE80211_QUEUE_STOP_REASON_FLUSH, 1245 IEEE80211_QUEUE_STOP_REASON_TDLS_TEARDOWN, 1246 IEEE80211_QUEUE_STOP_REASON_RESERVE_TID, 1247 IEEE80211_QUEUE_STOP_REASON_IFTYPE_CHANGE, 1248 1249 IEEE80211_QUEUE_STOP_REASONS, 1250 }; 1251 1252 #ifdef CONFIG_MAC80211_LEDS 1253 struct tpt_led_trigger { 1254 char name[32]; 1255 const struct ieee80211_tpt_blink *blink_table; 1256 unsigned int blink_table_len; 1257 struct timer_list timer; 1258 struct ieee80211_local *local; 1259 unsigned long prev_traffic; 1260 unsigned long tx_bytes, rx_bytes; 1261 unsigned int active, want; 1262 bool running; 1263 }; 1264 #endif 1265 1266 /** 1267 * enum mac80211_scan_flags - currently active scan mode 1268 * 1269 * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as 1270 * well be on the operating channel 1271 * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to 1272 * determine if we are on the operating channel or not 1273 * @SCAN_ONCHANNEL_SCANNING: Do a software scan on only the current operating 1274 * channel. This should not interrupt normal traffic. 1275 * @SCAN_COMPLETED: Set for our scan work function when the driver reported 1276 * that the scan completed. 1277 * @SCAN_ABORTED: Set for our scan work function when the driver reported 1278 * a scan complete for an aborted scan. 1279 * @SCAN_HW_CANCELLED: Set for our scan work function when the scan is being 1280 * cancelled. 1281 * @SCAN_BEACON_WAIT: Set whenever we're passive scanning because of radar/no-IR 1282 * and could send a probe request after receiving a beacon. 1283 * @SCAN_BEACON_DONE: Beacon received, we can now send a probe request 1284 */ 1285 enum mac80211_scan_flags { 1286 SCAN_SW_SCANNING, 1287 SCAN_HW_SCANNING, 1288 SCAN_ONCHANNEL_SCANNING, 1289 SCAN_COMPLETED, 1290 SCAN_ABORTED, 1291 SCAN_HW_CANCELLED, 1292 SCAN_BEACON_WAIT, 1293 SCAN_BEACON_DONE, 1294 }; 1295 1296 /** 1297 * enum mac80211_scan_state - scan state machine states 1298 * 1299 * @SCAN_DECISION: Main entry point to the scan state machine, this state 1300 * determines if we should keep on scanning or switch back to the 1301 * operating channel 1302 * @SCAN_SET_CHANNEL: Set the next channel to be scanned 1303 * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses 1304 * @SCAN_SUSPEND: Suspend the scan and go back to operating channel to 1305 * send out data 1306 * @SCAN_RESUME: Resume the scan and scan the next channel 1307 * @SCAN_ABORT: Abort the scan and go back to operating channel 1308 */ 1309 enum mac80211_scan_state { 1310 SCAN_DECISION, 1311 SCAN_SET_CHANNEL, 1312 SCAN_SEND_PROBE, 1313 SCAN_SUSPEND, 1314 SCAN_RESUME, 1315 SCAN_ABORT, 1316 }; 1317 1318 DECLARE_STATIC_KEY_FALSE(aql_disable); 1319 1320 struct ieee80211_local { 1321 /* embed the driver visible part. 1322 * don't cast (use the static inlines below), but we keep 1323 * it first anyway so they become a no-op */ 1324 struct ieee80211_hw hw; 1325 1326 struct fq fq; 1327 struct codel_vars *cvars; 1328 struct codel_params cparams; 1329 1330 /* protects active_txqs and txqi->schedule_order */ 1331 spinlock_t active_txq_lock[IEEE80211_NUM_ACS]; 1332 struct list_head active_txqs[IEEE80211_NUM_ACS]; 1333 u16 schedule_round[IEEE80211_NUM_ACS]; 1334 1335 /* serializes ieee80211_handle_wake_tx_queue */ 1336 spinlock_t handle_wake_tx_queue_lock; 1337 1338 u16 airtime_flags; 1339 u32 aql_txq_limit_low[IEEE80211_NUM_ACS]; 1340 u32 aql_txq_limit_high[IEEE80211_NUM_ACS]; 1341 u32 aql_threshold; 1342 atomic_t aql_total_pending_airtime; 1343 atomic_t aql_ac_pending_airtime[IEEE80211_NUM_ACS]; 1344 1345 const struct ieee80211_ops *ops; 1346 1347 /* 1348 * private workqueue to mac80211. mac80211 makes this accessible 1349 * via ieee80211_queue_work() 1350 */ 1351 struct workqueue_struct *workqueue; 1352 1353 unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES]; 1354 int q_stop_reasons[IEEE80211_MAX_QUEUES][IEEE80211_QUEUE_STOP_REASONS]; 1355 /* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */ 1356 spinlock_t queue_stop_reason_lock; 1357 1358 int open_count; 1359 int monitors, cooked_mntrs; 1360 /* number of interfaces with corresponding FIF_ flags */ 1361 int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll, 1362 fif_probe_req; 1363 bool probe_req_reg; 1364 bool rx_mcast_action_reg; 1365 unsigned int filter_flags; /* FIF_* */ 1366 1367 bool wiphy_ciphers_allocated; 1368 1369 struct cfg80211_chan_def dflt_chandef; 1370 bool emulate_chanctx; 1371 1372 /* protects the aggregated multicast list and filter calls */ 1373 spinlock_t filter_lock; 1374 1375 /* used for uploading changed mc list */ 1376 struct wiphy_work reconfig_filter; 1377 1378 /* aggregated multicast list */ 1379 struct netdev_hw_addr_list mc_list; 1380 1381 bool tim_in_locked_section; /* see ieee80211_beacon_get() */ 1382 1383 /* 1384 * suspended is true if we finished all the suspend _and_ we have 1385 * not yet come up from resume. This is to be used by mac80211 1386 * to ensure driver sanity during suspend and mac80211's own 1387 * sanity. It can eventually be used for WoW as well. 1388 */ 1389 bool suspended; 1390 1391 /* suspending is true during the whole suspend process */ 1392 bool suspending; 1393 1394 /* 1395 * Resuming is true while suspended, but when we're reprogramming the 1396 * hardware -- at that time it's allowed to use ieee80211_queue_work() 1397 * again even though some other parts of the stack are still suspended 1398 * and we still drop received frames to avoid waking the stack. 1399 */ 1400 bool resuming; 1401 1402 /* 1403 * quiescing is true during the suspend process _only_ to 1404 * ease timer cancelling etc. 1405 */ 1406 bool quiescing; 1407 1408 /* device is started */ 1409 bool started; 1410 1411 /* device is during a HW reconfig */ 1412 bool in_reconfig; 1413 1414 /* reconfiguration failed ... suppress some warnings etc. */ 1415 bool reconfig_failure; 1416 1417 /* wowlan is enabled -- don't reconfig on resume */ 1418 bool wowlan; 1419 1420 struct wiphy_work radar_detected_work; 1421 1422 /* number of RX chains the hardware has */ 1423 u8 rx_chains; 1424 1425 /* bitmap of which sbands were copied */ 1426 u8 sband_allocated; 1427 1428 int tx_headroom; /* required headroom for hardware/radiotap */ 1429 1430 /* Tasklet and skb queue to process calls from IRQ mode. All frames 1431 * added to skb_queue will be processed, but frames in 1432 * skb_queue_unreliable may be dropped if the total length of these 1433 * queues increases over the limit. */ 1434 #define IEEE80211_IRQSAFE_QUEUE_LIMIT 128 1435 struct tasklet_struct tasklet; 1436 struct sk_buff_head skb_queue; 1437 struct sk_buff_head skb_queue_unreliable; 1438 1439 spinlock_t rx_path_lock; 1440 1441 /* Station data */ 1442 /* 1443 * The list, hash table and counter are protected 1444 * by the wiphy mutex, reads are done with RCU. 1445 */ 1446 spinlock_t tim_lock; 1447 unsigned long num_sta; 1448 struct list_head sta_list; 1449 struct rhltable sta_hash; 1450 struct rhltable link_sta_hash; 1451 struct timer_list sta_cleanup; 1452 int sta_generation; 1453 1454 struct sk_buff_head pending[IEEE80211_MAX_QUEUES]; 1455 struct tasklet_struct tx_pending_tasklet; 1456 struct tasklet_struct wake_txqs_tasklet; 1457 1458 atomic_t agg_queue_stop[IEEE80211_MAX_QUEUES]; 1459 1460 /* number of interfaces with allmulti RX */ 1461 atomic_t iff_allmultis; 1462 1463 struct rate_control_ref *rate_ctrl; 1464 1465 struct arc4_ctx wep_tx_ctx; 1466 struct arc4_ctx wep_rx_ctx; 1467 u32 wep_iv; 1468 1469 /* see iface.c */ 1470 struct list_head interfaces; 1471 struct list_head mon_list; /* only that are IFF_UP && !cooked */ 1472 struct mutex iflist_mtx; 1473 1474 /* Scanning and BSS list */ 1475 unsigned long scanning; 1476 struct cfg80211_ssid scan_ssid; 1477 struct cfg80211_scan_request *int_scan_req; 1478 struct cfg80211_scan_request __rcu *scan_req; 1479 struct ieee80211_scan_request *hw_scan_req; 1480 struct cfg80211_chan_def scan_chandef; 1481 enum nl80211_band hw_scan_band; 1482 int scan_channel_idx; 1483 int scan_ies_len; 1484 int hw_scan_ies_bufsize; 1485 struct cfg80211_scan_info scan_info; 1486 1487 struct wiphy_work sched_scan_stopped_work; 1488 struct ieee80211_sub_if_data __rcu *sched_scan_sdata; 1489 struct cfg80211_sched_scan_request __rcu *sched_scan_req; 1490 u8 scan_addr[ETH_ALEN]; 1491 1492 unsigned long leave_oper_channel_time; 1493 enum mac80211_scan_state next_scan_state; 1494 struct wiphy_delayed_work scan_work; 1495 struct ieee80211_sub_if_data __rcu *scan_sdata; 1496 1497 /* Temporary remain-on-channel for off-channel operations */ 1498 struct ieee80211_channel *tmp_channel; 1499 1500 /* channel contexts */ 1501 struct list_head chanctx_list; 1502 1503 #ifdef CONFIG_MAC80211_LEDS 1504 struct led_trigger tx_led, rx_led, assoc_led, radio_led; 1505 struct led_trigger tpt_led; 1506 atomic_t tx_led_active, rx_led_active, assoc_led_active; 1507 atomic_t radio_led_active, tpt_led_active; 1508 struct tpt_led_trigger *tpt_led_trigger; 1509 #endif 1510 1511 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS 1512 /* SNMP counters */ 1513 /* dot11CountersTable */ 1514 u32 dot11TransmittedFragmentCount; 1515 u32 dot11MulticastTransmittedFrameCount; 1516 u32 dot11FailedCount; 1517 u32 dot11RetryCount; 1518 u32 dot11MultipleRetryCount; 1519 u32 dot11FrameDuplicateCount; 1520 u32 dot11ReceivedFragmentCount; 1521 u32 dot11MulticastReceivedFrameCount; 1522 u32 dot11TransmittedFrameCount; 1523 1524 /* TX/RX handler statistics */ 1525 unsigned int tx_handlers_drop; 1526 unsigned int tx_handlers_queued; 1527 unsigned int tx_handlers_drop_wep; 1528 unsigned int tx_handlers_drop_not_assoc; 1529 unsigned int tx_handlers_drop_unauth_port; 1530 unsigned int rx_handlers_drop; 1531 unsigned int rx_handlers_queued; 1532 unsigned int rx_handlers_drop_nullfunc; 1533 unsigned int rx_handlers_drop_defrag; 1534 unsigned int tx_expand_skb_head; 1535 unsigned int tx_expand_skb_head_cloned; 1536 unsigned int rx_expand_skb_head_defrag; 1537 unsigned int rx_handlers_fragments; 1538 unsigned int tx_status_drop; 1539 #define I802_DEBUG_INC(c) (c)++ 1540 #else /* CONFIG_MAC80211_DEBUG_COUNTERS */ 1541 #define I802_DEBUG_INC(c) do { } while (0) 1542 #endif /* CONFIG_MAC80211_DEBUG_COUNTERS */ 1543 1544 1545 int total_ps_buffered; /* total number of all buffered unicast and 1546 * multicast packets for power saving stations 1547 */ 1548 1549 bool pspolling; 1550 /* 1551 * PS can only be enabled when we have exactly one managed 1552 * interface (and monitors) in PS, this then points there. 1553 */ 1554 struct ieee80211_sub_if_data *ps_sdata; 1555 struct wiphy_work dynamic_ps_enable_work; 1556 struct wiphy_work dynamic_ps_disable_work; 1557 struct timer_list dynamic_ps_timer; 1558 struct notifier_block ifa_notifier; 1559 struct notifier_block ifa6_notifier; 1560 1561 /* 1562 * The dynamic ps timeout configured from user space via WEXT - 1563 * this will override whatever chosen by mac80211 internally. 1564 */ 1565 int dynamic_ps_forced_timeout; 1566 1567 int user_power_level; /* in dBm, for all interfaces */ 1568 1569 struct work_struct restart_work; 1570 1571 #ifdef CONFIG_MAC80211_DEBUGFS 1572 struct local_debugfsdentries { 1573 struct dentry *rcdir; 1574 struct dentry *keys; 1575 } debugfs; 1576 bool force_tx_status; 1577 #endif 1578 1579 /* 1580 * Remain-on-channel support 1581 */ 1582 struct wiphy_delayed_work roc_work; 1583 struct list_head roc_list; 1584 struct wiphy_work hw_roc_start, hw_roc_done; 1585 unsigned long hw_roc_start_time; 1586 u64 roc_cookie_counter; 1587 1588 struct idr ack_status_frames; 1589 spinlock_t ack_status_lock; 1590 1591 struct ieee80211_sub_if_data __rcu *p2p_sdata; 1592 1593 /* virtual monitor interface */ 1594 struct ieee80211_sub_if_data __rcu *monitor_sdata; 1595 struct ieee80211_chan_req monitor_chanreq; 1596 1597 /* extended capabilities provided by mac80211 */ 1598 u8 ext_capa[8]; 1599 1600 bool wbrf_supported; 1601 }; 1602 1603 static inline struct ieee80211_sub_if_data * 1604 IEEE80211_DEV_TO_SUB_IF(const struct net_device *dev) 1605 { 1606 return netdev_priv(dev); 1607 } 1608 1609 static inline struct ieee80211_sub_if_data * 1610 IEEE80211_WDEV_TO_SUB_IF(struct wireless_dev *wdev) 1611 { 1612 return container_of(wdev, struct ieee80211_sub_if_data, wdev); 1613 } 1614 1615 static inline struct ieee80211_supported_band * 1616 ieee80211_get_sband(struct ieee80211_sub_if_data *sdata) 1617 { 1618 struct ieee80211_local *local = sdata->local; 1619 struct ieee80211_chanctx_conf *chanctx_conf; 1620 enum nl80211_band band; 1621 1622 WARN_ON(ieee80211_vif_is_mld(&sdata->vif)); 1623 1624 rcu_read_lock(); 1625 chanctx_conf = rcu_dereference(sdata->vif.bss_conf.chanctx_conf); 1626 1627 if (!chanctx_conf) { 1628 rcu_read_unlock(); 1629 return NULL; 1630 } 1631 1632 band = chanctx_conf->def.chan->band; 1633 rcu_read_unlock(); 1634 1635 return local->hw.wiphy->bands[band]; 1636 } 1637 1638 static inline struct ieee80211_supported_band * 1639 ieee80211_get_link_sband(struct ieee80211_link_data *link) 1640 { 1641 struct ieee80211_local *local = link->sdata->local; 1642 struct ieee80211_chanctx_conf *chanctx_conf; 1643 enum nl80211_band band; 1644 1645 rcu_read_lock(); 1646 chanctx_conf = rcu_dereference(link->conf->chanctx_conf); 1647 if (!chanctx_conf) { 1648 rcu_read_unlock(); 1649 return NULL; 1650 } 1651 1652 band = chanctx_conf->def.chan->band; 1653 rcu_read_unlock(); 1654 1655 return local->hw.wiphy->bands[band]; 1656 } 1657 1658 /* this struct holds the value parsing from channel switch IE */ 1659 struct ieee80211_csa_ie { 1660 struct ieee80211_chan_req chanreq; 1661 u8 mode; 1662 u8 count; 1663 u8 ttl; 1664 u16 pre_value; 1665 u16 reason_code; 1666 u32 max_switch_time; 1667 }; 1668 1669 enum ieee80211_elems_parse_error { 1670 IEEE80211_PARSE_ERR_INVALID_END = BIT(0), 1671 IEEE80211_PARSE_ERR_DUP_ELEM = BIT(1), 1672 IEEE80211_PARSE_ERR_BAD_ELEM_SIZE = BIT(2), 1673 IEEE80211_PARSE_ERR_UNEXPECTED_ELEM = BIT(3), 1674 IEEE80211_PARSE_ERR_DUP_NEST_ML_BASIC = BIT(4), 1675 }; 1676 1677 /* Parsed Information Elements */ 1678 struct ieee802_11_elems { 1679 const u8 *ie_start; 1680 size_t total_len; 1681 u32 crc; 1682 1683 /* pointers to IEs */ 1684 const struct ieee80211_tdls_lnkie *lnk_id; 1685 const struct ieee80211_ch_switch_timing *ch_sw_timing; 1686 const u8 *ext_capab; 1687 const u8 *ssid; 1688 const u8 *supp_rates; 1689 const u8 *ds_params; 1690 const struct ieee80211_tim_ie *tim; 1691 const u8 *rsn; 1692 const u8 *rsnx; 1693 const u8 *erp_info; 1694 const u8 *ext_supp_rates; 1695 const u8 *wmm_info; 1696 const u8 *wmm_param; 1697 const struct ieee80211_ht_cap *ht_cap_elem; 1698 const struct ieee80211_ht_operation *ht_operation; 1699 const struct ieee80211_vht_cap *vht_cap_elem; 1700 const struct ieee80211_vht_operation *vht_operation; 1701 const struct ieee80211_meshconf_ie *mesh_config; 1702 const u8 *he_cap; 1703 const struct ieee80211_he_operation *he_operation; 1704 const struct ieee80211_he_spr *he_spr; 1705 const struct ieee80211_mu_edca_param_set *mu_edca_param_set; 1706 const struct ieee80211_he_6ghz_capa *he_6ghz_capa; 1707 const struct ieee80211_tx_pwr_env *tx_pwr_env[IEEE80211_TPE_MAX_IE_COUNT]; 1708 const u8 *uora_element; 1709 const u8 *mesh_id; 1710 const u8 *peering; 1711 const __le16 *awake_window; 1712 const u8 *preq; 1713 const u8 *prep; 1714 const u8 *perr; 1715 const struct ieee80211_rann_ie *rann; 1716 const struct ieee80211_channel_sw_ie *ch_switch_ie; 1717 const struct ieee80211_ext_chansw_ie *ext_chansw_ie; 1718 const struct ieee80211_wide_bw_chansw_ie *wide_bw_chansw_ie; 1719 const u8 *max_channel_switch_time; 1720 const u8 *country_elem; 1721 const u8 *pwr_constr_elem; 1722 const u8 *cisco_dtpc_elem; 1723 const struct ieee80211_timeout_interval_ie *timeout_int; 1724 const u8 *opmode_notif; 1725 const struct ieee80211_sec_chan_offs_ie *sec_chan_offs; 1726 struct ieee80211_mesh_chansw_params_ie *mesh_chansw_params_ie; 1727 const struct ieee80211_bss_max_idle_period_ie *max_idle_period_ie; 1728 const struct ieee80211_multiple_bssid_configuration *mbssid_config_ie; 1729 const struct ieee80211_bssid_index *bssid_index; 1730 u8 max_bssid_indicator; 1731 u8 dtim_count; 1732 u8 dtim_period; 1733 const struct ieee80211_addba_ext_ie *addba_ext_ie; 1734 const struct ieee80211_s1g_cap *s1g_capab; 1735 const struct ieee80211_s1g_oper_ie *s1g_oper; 1736 const struct ieee80211_s1g_bcn_compat_ie *s1g_bcn_compat; 1737 const struct ieee80211_aid_response_ie *aid_resp; 1738 const struct ieee80211_eht_cap_elem *eht_cap; 1739 const struct ieee80211_eht_operation *eht_operation; 1740 const struct ieee80211_multi_link_elem *ml_basic; 1741 const struct ieee80211_multi_link_elem *ml_reconf; 1742 const struct ieee80211_bandwidth_indication *bandwidth_indication; 1743 const struct ieee80211_ttlm_elem *ttlm[IEEE80211_TTLM_MAX_CNT]; 1744 1745 /* length of them, respectively */ 1746 u8 ext_capab_len; 1747 u8 ssid_len; 1748 u8 supp_rates_len; 1749 u8 tim_len; 1750 u8 rsn_len; 1751 u8 rsnx_len; 1752 u8 ext_supp_rates_len; 1753 u8 wmm_info_len; 1754 u8 wmm_param_len; 1755 u8 he_cap_len; 1756 u8 mesh_id_len; 1757 u8 peering_len; 1758 u8 preq_len; 1759 u8 prep_len; 1760 u8 perr_len; 1761 u8 country_elem_len; 1762 u8 bssid_index_len; 1763 u8 tx_pwr_env_len[IEEE80211_TPE_MAX_IE_COUNT]; 1764 u8 tx_pwr_env_num; 1765 u8 eht_cap_len; 1766 1767 /* mult-link element can be de-fragmented and thus u8 is not sufficient */ 1768 size_t ml_basic_len; 1769 size_t ml_reconf_len; 1770 1771 /* The basic Multi-Link element in the original IEs */ 1772 const struct element *ml_basic_elem; 1773 1774 /* The reconfiguration Multi-Link element in the original IEs */ 1775 const struct element *ml_reconf_elem; 1776 1777 u8 ttlm_num; 1778 1779 /* 1780 * store the per station profile pointer and length in case that the 1781 * parsing also handled Multi-Link element parsing for a specific link 1782 * ID. 1783 */ 1784 struct ieee80211_mle_per_sta_profile *prof; 1785 size_t sta_prof_len; 1786 1787 /* whether/which parse error occurred while retrieving these elements */ 1788 u8 parse_error; 1789 1790 /* 1791 * scratch buffer that can be used for various element parsing related 1792 * tasks, e.g., element de-fragmentation etc. 1793 */ 1794 size_t scratch_len; 1795 u8 *scratch_pos; 1796 u8 scratch[] __counted_by(scratch_len); 1797 }; 1798 1799 static inline struct ieee80211_local *hw_to_local( 1800 struct ieee80211_hw *hw) 1801 { 1802 return container_of(hw, struct ieee80211_local, hw); 1803 } 1804 1805 static inline struct txq_info *to_txq_info(struct ieee80211_txq *txq) 1806 { 1807 return container_of(txq, struct txq_info, txq); 1808 } 1809 1810 static inline bool txq_has_queue(struct ieee80211_txq *txq) 1811 { 1812 struct txq_info *txqi = to_txq_info(txq); 1813 1814 return !(skb_queue_empty(&txqi->frags) && !txqi->tin.backlog_packets); 1815 } 1816 1817 static inline bool 1818 ieee80211_have_rx_timestamp(struct ieee80211_rx_status *status) 1819 { 1820 return status->flag & RX_FLAG_MACTIME; 1821 } 1822 1823 void ieee80211_vif_inc_num_mcast(struct ieee80211_sub_if_data *sdata); 1824 void ieee80211_vif_dec_num_mcast(struct ieee80211_sub_if_data *sdata); 1825 1826 /* This function returns the number of multicast stations connected to this 1827 * interface. It returns -1 if that number is not tracked, that is for netdevs 1828 * not in AP or AP_VLAN mode or when using 4addr. 1829 */ 1830 static inline int 1831 ieee80211_vif_get_num_mcast_if(struct ieee80211_sub_if_data *sdata) 1832 { 1833 if (sdata->vif.type == NL80211_IFTYPE_AP) 1834 return atomic_read(&sdata->u.ap.num_mcast_sta); 1835 if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN && !sdata->u.vlan.sta) 1836 return atomic_read(&sdata->u.vlan.num_mcast_sta); 1837 return -1; 1838 } 1839 1840 u64 ieee80211_calculate_rx_timestamp(struct ieee80211_local *local, 1841 struct ieee80211_rx_status *status, 1842 unsigned int mpdu_len, 1843 unsigned int mpdu_offset); 1844 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed); 1845 int ieee80211_hw_conf_chan(struct ieee80211_local *local); 1846 void ieee80211_hw_conf_init(struct ieee80211_local *local); 1847 void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx); 1848 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata, 1849 u64 changed); 1850 void ieee80211_vif_cfg_change_notify(struct ieee80211_sub_if_data *sdata, 1851 u64 changed); 1852 void ieee80211_link_info_change_notify(struct ieee80211_sub_if_data *sdata, 1853 struct ieee80211_link_data *link, 1854 u64 changed); 1855 void ieee80211_configure_filter(struct ieee80211_local *local); 1856 u64 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata); 1857 1858 u64 ieee80211_mgmt_tx_cookie(struct ieee80211_local *local); 1859 int ieee80211_attach_ack_skb(struct ieee80211_local *local, struct sk_buff *skb, 1860 u64 *cookie, gfp_t gfp); 1861 1862 void ieee80211_check_fast_rx(struct sta_info *sta); 1863 void __ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata); 1864 void ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata); 1865 void ieee80211_clear_fast_rx(struct sta_info *sta); 1866 1867 bool ieee80211_is_our_addr(struct ieee80211_sub_if_data *sdata, 1868 const u8 *addr, int *out_link_id); 1869 1870 /* STA code */ 1871 void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata); 1872 int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata, 1873 struct cfg80211_auth_request *req); 1874 int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata, 1875 struct cfg80211_assoc_request *req); 1876 int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata, 1877 struct cfg80211_deauth_request *req); 1878 int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata, 1879 struct cfg80211_disassoc_request *req); 1880 void ieee80211_send_pspoll(struct ieee80211_local *local, 1881 struct ieee80211_sub_if_data *sdata); 1882 void ieee80211_recalc_ps(struct ieee80211_local *local); 1883 void ieee80211_recalc_ps_vif(struct ieee80211_sub_if_data *sdata); 1884 void ieee80211_sta_work(struct ieee80211_sub_if_data *sdata); 1885 void ieee80211_sta_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1886 struct sk_buff *skb); 1887 void ieee80211_sta_rx_queued_ext(struct ieee80211_sub_if_data *sdata, 1888 struct sk_buff *skb); 1889 void ieee80211_sta_reset_beacon_monitor(struct ieee80211_sub_if_data *sdata); 1890 void ieee80211_sta_reset_conn_monitor(struct ieee80211_sub_if_data *sdata); 1891 void ieee80211_mgd_stop(struct ieee80211_sub_if_data *sdata); 1892 void ieee80211_mgd_conn_tx_status(struct ieee80211_sub_if_data *sdata, 1893 __le16 fc, bool acked); 1894 void ieee80211_mgd_quiesce(struct ieee80211_sub_if_data *sdata); 1895 void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata); 1896 void ieee80211_sta_handle_tspec_ac_params(struct ieee80211_sub_if_data *sdata); 1897 void ieee80211_sta_connection_lost(struct ieee80211_sub_if_data *sdata, 1898 u8 reason, bool tx); 1899 void ieee80211_mgd_setup_link(struct ieee80211_link_data *link); 1900 void ieee80211_mgd_stop_link(struct ieee80211_link_data *link); 1901 void ieee80211_mgd_set_link_qos_params(struct ieee80211_link_data *link); 1902 1903 /* IBSS code */ 1904 void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local); 1905 void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata); 1906 void ieee80211_ibss_rx_no_sta(struct ieee80211_sub_if_data *sdata, 1907 const u8 *bssid, const u8 *addr, u32 supp_rates); 1908 int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata, 1909 struct cfg80211_ibss_params *params); 1910 int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata); 1911 void ieee80211_ibss_work(struct ieee80211_sub_if_data *sdata); 1912 void ieee80211_ibss_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1913 struct sk_buff *skb); 1914 int ieee80211_ibss_csa_beacon(struct ieee80211_sub_if_data *sdata, 1915 struct cfg80211_csa_settings *csa_settings, 1916 u64 *changed); 1917 int ieee80211_ibss_finish_csa(struct ieee80211_sub_if_data *sdata, 1918 u64 *changed); 1919 void ieee80211_ibss_stop(struct ieee80211_sub_if_data *sdata); 1920 1921 /* OCB code */ 1922 void ieee80211_ocb_work(struct ieee80211_sub_if_data *sdata); 1923 void ieee80211_ocb_rx_no_sta(struct ieee80211_sub_if_data *sdata, 1924 const u8 *bssid, const u8 *addr, u32 supp_rates); 1925 void ieee80211_ocb_setup_sdata(struct ieee80211_sub_if_data *sdata); 1926 int ieee80211_ocb_join(struct ieee80211_sub_if_data *sdata, 1927 struct ocb_setup *setup); 1928 int ieee80211_ocb_leave(struct ieee80211_sub_if_data *sdata); 1929 1930 /* mesh code */ 1931 void ieee80211_mesh_work(struct ieee80211_sub_if_data *sdata); 1932 void ieee80211_mesh_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1933 struct sk_buff *skb); 1934 int ieee80211_mesh_csa_beacon(struct ieee80211_sub_if_data *sdata, 1935 struct cfg80211_csa_settings *csa_settings, 1936 u64 *changed); 1937 int ieee80211_mesh_finish_csa(struct ieee80211_sub_if_data *sdata, 1938 u64 *changed); 1939 1940 /* scan/BSS handling */ 1941 void ieee80211_scan_work(struct wiphy *wiphy, struct wiphy_work *work); 1942 int ieee80211_request_ibss_scan(struct ieee80211_sub_if_data *sdata, 1943 const u8 *ssid, u8 ssid_len, 1944 struct ieee80211_channel **channels, 1945 unsigned int n_channels); 1946 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata, 1947 struct cfg80211_scan_request *req); 1948 void ieee80211_scan_cancel(struct ieee80211_local *local); 1949 void ieee80211_run_deferred_scan(struct ieee80211_local *local); 1950 void ieee80211_scan_rx(struct ieee80211_local *local, struct sk_buff *skb); 1951 1952 void ieee80211_inform_bss(struct wiphy *wiphy, struct cfg80211_bss *bss, 1953 const struct cfg80211_bss_ies *ies, void *data); 1954 1955 void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local); 1956 struct ieee80211_bss * 1957 ieee80211_bss_info_update(struct ieee80211_local *local, 1958 struct ieee80211_rx_status *rx_status, 1959 struct ieee80211_mgmt *mgmt, 1960 size_t len, 1961 struct ieee80211_channel *channel); 1962 void ieee80211_rx_bss_put(struct ieee80211_local *local, 1963 struct ieee80211_bss *bss); 1964 1965 /* scheduled scan handling */ 1966 int 1967 __ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata, 1968 struct cfg80211_sched_scan_request *req); 1969 int ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata, 1970 struct cfg80211_sched_scan_request *req); 1971 int ieee80211_request_sched_scan_stop(struct ieee80211_local *local); 1972 void ieee80211_sched_scan_end(struct ieee80211_local *local); 1973 void ieee80211_sched_scan_stopped_work(struct wiphy *wiphy, 1974 struct wiphy_work *work); 1975 1976 /* off-channel/mgmt-tx */ 1977 void ieee80211_offchannel_stop_vifs(struct ieee80211_local *local); 1978 void ieee80211_offchannel_return(struct ieee80211_local *local); 1979 void ieee80211_roc_setup(struct ieee80211_local *local); 1980 void ieee80211_start_next_roc(struct ieee80211_local *local); 1981 void ieee80211_roc_purge(struct ieee80211_local *local, 1982 struct ieee80211_sub_if_data *sdata); 1983 int ieee80211_remain_on_channel(struct wiphy *wiphy, struct wireless_dev *wdev, 1984 struct ieee80211_channel *chan, 1985 unsigned int duration, u64 *cookie); 1986 int ieee80211_cancel_remain_on_channel(struct wiphy *wiphy, 1987 struct wireless_dev *wdev, u64 cookie); 1988 int ieee80211_mgmt_tx(struct wiphy *wiphy, struct wireless_dev *wdev, 1989 struct cfg80211_mgmt_tx_params *params, u64 *cookie); 1990 int ieee80211_mgmt_tx_cancel_wait(struct wiphy *wiphy, 1991 struct wireless_dev *wdev, u64 cookie); 1992 1993 /* channel switch handling */ 1994 void ieee80211_csa_finalize_work(struct wiphy *wiphy, struct wiphy_work *work); 1995 int ieee80211_channel_switch(struct wiphy *wiphy, struct net_device *dev, 1996 struct cfg80211_csa_settings *params); 1997 1998 /* color change handling */ 1999 void ieee80211_color_change_finalize_work(struct wiphy *wiphy, 2000 struct wiphy_work *work); 2001 void ieee80211_color_collision_detection_work(struct work_struct *work); 2002 2003 /* interface handling */ 2004 #define MAC80211_SUPPORTED_FEATURES_TX (NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \ 2005 NETIF_F_HW_CSUM | NETIF_F_SG | \ 2006 NETIF_F_HIGHDMA | NETIF_F_GSO_SOFTWARE | \ 2007 NETIF_F_HW_TC) 2008 #define MAC80211_SUPPORTED_FEATURES_RX (NETIF_F_RXCSUM) 2009 #define MAC80211_SUPPORTED_FEATURES (MAC80211_SUPPORTED_FEATURES_TX | \ 2010 MAC80211_SUPPORTED_FEATURES_RX) 2011 2012 int ieee80211_iface_init(void); 2013 void ieee80211_iface_exit(void); 2014 int ieee80211_if_add(struct ieee80211_local *local, const char *name, 2015 unsigned char name_assign_type, 2016 struct wireless_dev **new_wdev, enum nl80211_iftype type, 2017 struct vif_params *params); 2018 int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata, 2019 enum nl80211_iftype type); 2020 void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata); 2021 void ieee80211_remove_interfaces(struct ieee80211_local *local); 2022 u32 ieee80211_idle_off(struct ieee80211_local *local); 2023 void ieee80211_recalc_idle(struct ieee80211_local *local); 2024 void ieee80211_adjust_monitor_flags(struct ieee80211_sub_if_data *sdata, 2025 const int offset); 2026 int ieee80211_do_open(struct wireless_dev *wdev, bool coming_up); 2027 void ieee80211_sdata_stop(struct ieee80211_sub_if_data *sdata); 2028 int ieee80211_add_virtual_monitor(struct ieee80211_local *local); 2029 void ieee80211_del_virtual_monitor(struct ieee80211_local *local); 2030 2031 bool __ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata); 2032 void ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata, 2033 bool update_bss); 2034 void ieee80211_recalc_offload(struct ieee80211_local *local); 2035 2036 static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata) 2037 { 2038 return test_bit(SDATA_STATE_RUNNING, &sdata->state); 2039 } 2040 2041 /* link handling */ 2042 void ieee80211_link_setup(struct ieee80211_link_data *link); 2043 void ieee80211_link_init(struct ieee80211_sub_if_data *sdata, 2044 int link_id, 2045 struct ieee80211_link_data *link, 2046 struct ieee80211_bss_conf *link_conf); 2047 void ieee80211_link_stop(struct ieee80211_link_data *link); 2048 int ieee80211_vif_set_links(struct ieee80211_sub_if_data *sdata, 2049 u16 new_links, u16 dormant_links); 2050 static inline void ieee80211_vif_clear_links(struct ieee80211_sub_if_data *sdata) 2051 { 2052 ieee80211_vif_set_links(sdata, 0, 0); 2053 } 2054 2055 /* tx handling */ 2056 void ieee80211_clear_tx_pending(struct ieee80211_local *local); 2057 void ieee80211_tx_pending(struct tasklet_struct *t); 2058 netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb, 2059 struct net_device *dev); 2060 netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb, 2061 struct net_device *dev); 2062 netdev_tx_t ieee80211_subif_start_xmit_8023(struct sk_buff *skb, 2063 struct net_device *dev); 2064 void __ieee80211_subif_start_xmit(struct sk_buff *skb, 2065 struct net_device *dev, 2066 u32 info_flags, 2067 u32 ctrl_flags, 2068 u64 *cookie); 2069 void ieee80211_purge_tx_queue(struct ieee80211_hw *hw, 2070 struct sk_buff_head *skbs); 2071 struct sk_buff * 2072 ieee80211_build_data_template(struct ieee80211_sub_if_data *sdata, 2073 struct sk_buff *skb, u32 info_flags); 2074 void ieee80211_tx_monitor(struct ieee80211_local *local, struct sk_buff *skb, 2075 int retry_count, bool send_to_cooked, 2076 struct ieee80211_tx_status *status); 2077 2078 void ieee80211_check_fast_xmit(struct sta_info *sta); 2079 void ieee80211_check_fast_xmit_all(struct ieee80211_local *local); 2080 void ieee80211_check_fast_xmit_iface(struct ieee80211_sub_if_data *sdata); 2081 void ieee80211_clear_fast_xmit(struct sta_info *sta); 2082 int ieee80211_tx_control_port(struct wiphy *wiphy, struct net_device *dev, 2083 const u8 *buf, size_t len, 2084 const u8 *dest, __be16 proto, bool unencrypted, 2085 int link_id, u64 *cookie); 2086 int ieee80211_probe_mesh_link(struct wiphy *wiphy, struct net_device *dev, 2087 const u8 *buf, size_t len); 2088 void __ieee80211_xmit_fast(struct ieee80211_sub_if_data *sdata, 2089 struct sta_info *sta, 2090 struct ieee80211_fast_tx *fast_tx, 2091 struct sk_buff *skb, bool ampdu, 2092 const u8 *da, const u8 *sa); 2093 void ieee80211_aggr_check(struct ieee80211_sub_if_data *sdata, 2094 struct sta_info *sta, struct sk_buff *skb); 2095 2096 /* HT */ 2097 void ieee80211_apply_htcap_overrides(struct ieee80211_sub_if_data *sdata, 2098 struct ieee80211_sta_ht_cap *ht_cap); 2099 bool ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_sub_if_data *sdata, 2100 struct ieee80211_supported_band *sband, 2101 const struct ieee80211_ht_cap *ht_cap_ie, 2102 struct link_sta_info *link_sta); 2103 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata, 2104 const u8 *da, u16 tid, 2105 u16 initiator, u16 reason_code); 2106 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata, 2107 enum ieee80211_smps_mode smps, const u8 *da, 2108 const u8 *bssid, int link_id); 2109 bool ieee80211_smps_is_restrictive(enum ieee80211_smps_mode smps_mode_old, 2110 enum ieee80211_smps_mode smps_mode_new); 2111 2112 void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid, 2113 u16 initiator, u16 reason, bool stop); 2114 void __ieee80211_start_rx_ba_session(struct sta_info *sta, 2115 u8 dialog_token, u16 timeout, 2116 u16 start_seq_num, u16 ba_policy, u16 tid, 2117 u16 buf_size, bool tx, bool auto_seq, 2118 const struct ieee80211_addba_ext_ie *addbaext); 2119 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta, 2120 enum ieee80211_agg_stop_reason reason); 2121 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata, 2122 struct sta_info *sta, 2123 struct ieee80211_mgmt *mgmt, size_t len); 2124 void ieee80211_process_addba_resp(struct ieee80211_local *local, 2125 struct sta_info *sta, 2126 struct ieee80211_mgmt *mgmt, 2127 size_t len); 2128 void ieee80211_process_addba_request(struct ieee80211_local *local, 2129 struct sta_info *sta, 2130 struct ieee80211_mgmt *mgmt, 2131 size_t len); 2132 2133 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid, 2134 enum ieee80211_agg_stop_reason reason); 2135 void ieee80211_start_tx_ba_cb(struct sta_info *sta, int tid, 2136 struct tid_ampdu_tx *tid_tx); 2137 void ieee80211_stop_tx_ba_cb(struct sta_info *sta, int tid, 2138 struct tid_ampdu_tx *tid_tx); 2139 void ieee80211_ba_session_work(struct wiphy *wiphy, struct wiphy_work *work); 2140 void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid); 2141 void ieee80211_release_reorder_timeout(struct sta_info *sta, int tid); 2142 2143 u8 ieee80211_mcs_to_chains(const struct ieee80211_mcs_info *mcs); 2144 enum nl80211_smps_mode 2145 ieee80211_smps_mode_to_smps_mode(enum ieee80211_smps_mode smps); 2146 2147 /* VHT */ 2148 void 2149 ieee80211_vht_cap_ie_to_sta_vht_cap(struct ieee80211_sub_if_data *sdata, 2150 struct ieee80211_supported_band *sband, 2151 const struct ieee80211_vht_cap *vht_cap_ie, 2152 const struct ieee80211_vht_cap *vht_cap_ie2, 2153 struct link_sta_info *link_sta); 2154 enum ieee80211_sta_rx_bandwidth 2155 ieee80211_sta_cap_rx_bw(struct link_sta_info *link_sta); 2156 enum ieee80211_sta_rx_bandwidth 2157 ieee80211_sta_cur_vht_bw(struct link_sta_info *link_sta); 2158 void ieee80211_sta_set_rx_nss(struct link_sta_info *link_sta); 2159 enum ieee80211_sta_rx_bandwidth 2160 ieee80211_chan_width_to_rx_bw(enum nl80211_chan_width width); 2161 enum nl80211_chan_width 2162 ieee80211_sta_cap_chan_bw(struct link_sta_info *link_sta); 2163 void ieee80211_process_mu_groups(struct ieee80211_sub_if_data *sdata, 2164 struct ieee80211_link_data *link, 2165 struct ieee80211_mgmt *mgmt); 2166 u32 __ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata, 2167 struct link_sta_info *sta, 2168 u8 opmode, enum nl80211_band band); 2169 void ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata, 2170 struct link_sta_info *sta, 2171 u8 opmode, enum nl80211_band band); 2172 void ieee80211_apply_vhtcap_overrides(struct ieee80211_sub_if_data *sdata, 2173 struct ieee80211_sta_vht_cap *vht_cap); 2174 void ieee80211_get_vht_mask_from_cap(__le16 vht_cap, 2175 u16 vht_mask[NL80211_VHT_NSS_MAX]); 2176 enum nl80211_chan_width 2177 ieee80211_sta_rx_bw_to_chan_width(struct link_sta_info *sta); 2178 2179 /* HE */ 2180 void 2181 ieee80211_he_cap_ie_to_sta_he_cap(struct ieee80211_sub_if_data *sdata, 2182 struct ieee80211_supported_band *sband, 2183 const u8 *he_cap_ie, u8 he_cap_len, 2184 const struct ieee80211_he_6ghz_capa *he_6ghz_capa, 2185 struct link_sta_info *link_sta); 2186 void 2187 ieee80211_he_spr_ie_to_bss_conf(struct ieee80211_vif *vif, 2188 const struct ieee80211_he_spr *he_spr_ie_elem); 2189 2190 void 2191 ieee80211_he_op_ie_to_bss_conf(struct ieee80211_vif *vif, 2192 const struct ieee80211_he_operation *he_op_ie_elem); 2193 2194 /* S1G */ 2195 void ieee80211_s1g_sta_rate_init(struct sta_info *sta); 2196 bool ieee80211_s1g_is_twt_setup(struct sk_buff *skb); 2197 void ieee80211_s1g_rx_twt_action(struct ieee80211_sub_if_data *sdata, 2198 struct sk_buff *skb); 2199 void ieee80211_s1g_status_twt_action(struct ieee80211_sub_if_data *sdata, 2200 struct sk_buff *skb); 2201 2202 /* Spectrum management */ 2203 void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata, 2204 struct ieee80211_mgmt *mgmt, 2205 size_t len); 2206 /** 2207 * ieee80211_parse_ch_switch_ie - parses channel switch IEs 2208 * @sdata: the sdata of the interface which has received the frame 2209 * @elems: parsed 802.11 elements received with the frame 2210 * @current_band: indicates the current band 2211 * @vht_cap_info: VHT capabilities of the transmitter 2212 * @conn: contains information about own capabilities and restrictions 2213 * to decide which channel switch announcements can be accepted 2214 * @bssid: the currently connected bssid (for reporting) 2215 * @csa_ie: parsed 802.11 csa elements on count, mode, chandef and mesh ttl. 2216 * All of them will be filled with if success only. 2217 * Return: 0 on success, <0 on error and >0 if there is nothing to parse. 2218 */ 2219 int ieee80211_parse_ch_switch_ie(struct ieee80211_sub_if_data *sdata, 2220 struct ieee802_11_elems *elems, 2221 enum nl80211_band current_band, 2222 u32 vht_cap_info, 2223 struct ieee80211_conn_settings *conn, 2224 u8 *bssid, 2225 struct ieee80211_csa_ie *csa_ie); 2226 2227 /* Suspend/resume and hw reconfiguration */ 2228 int ieee80211_reconfig(struct ieee80211_local *local); 2229 void ieee80211_stop_device(struct ieee80211_local *local); 2230 2231 int __ieee80211_suspend(struct ieee80211_hw *hw, 2232 struct cfg80211_wowlan *wowlan); 2233 2234 static inline int __ieee80211_resume(struct ieee80211_hw *hw) 2235 { 2236 struct ieee80211_local *local = hw_to_local(hw); 2237 2238 WARN(test_bit(SCAN_HW_SCANNING, &local->scanning) && 2239 !test_bit(SCAN_COMPLETED, &local->scanning), 2240 "%s: resume with hardware scan still in progress\n", 2241 wiphy_name(hw->wiphy)); 2242 2243 return ieee80211_reconfig(hw_to_local(hw)); 2244 } 2245 2246 /* utility functions/constants */ 2247 extern const void *const mac80211_wiphy_privid; /* for wiphy privid */ 2248 const char *ieee80211_conn_mode_str(enum ieee80211_conn_mode mode); 2249 enum ieee80211_conn_bw_limit 2250 ieee80211_min_bw_limit_from_chandef(struct cfg80211_chan_def *chandef); 2251 int ieee80211_frame_duration(enum nl80211_band band, size_t len, 2252 int rate, int erp, int short_preamble); 2253 void ieee80211_regulatory_limit_wmm_params(struct ieee80211_sub_if_data *sdata, 2254 struct ieee80211_tx_queue_params *qparam, 2255 int ac); 2256 void ieee80211_set_wmm_default(struct ieee80211_link_data *link, 2257 bool bss_notify, bool enable_qos); 2258 void ieee80211_xmit(struct ieee80211_sub_if_data *sdata, 2259 struct sta_info *sta, struct sk_buff *skb); 2260 2261 void __ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata, 2262 struct sk_buff *skb, int tid, int link_id, 2263 enum nl80211_band band); 2264 2265 /* sta_out needs to be checked for ERR_PTR() before using */ 2266 int ieee80211_lookup_ra_sta(struct ieee80211_sub_if_data *sdata, 2267 struct sk_buff *skb, 2268 struct sta_info **sta_out); 2269 2270 static inline void 2271 ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata, 2272 struct sk_buff *skb, int tid, 2273 enum nl80211_band band) 2274 { 2275 rcu_read_lock(); 2276 __ieee80211_tx_skb_tid_band(sdata, skb, tid, -1, band); 2277 rcu_read_unlock(); 2278 } 2279 2280 void ieee80211_tx_skb_tid(struct ieee80211_sub_if_data *sdata, 2281 struct sk_buff *skb, int tid, int link_id); 2282 2283 static inline void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata, 2284 struct sk_buff *skb) 2285 { 2286 /* Send all internal mgmt frames on VO. Accordingly set TID to 7. */ 2287 ieee80211_tx_skb_tid(sdata, skb, 7, -1); 2288 } 2289 2290 /** 2291 * struct ieee80211_elems_parse_params - element parsing parameters 2292 * @mode: connection mode for parsing 2293 * @start: pointer to the elements 2294 * @len: length of the elements 2295 * @action: %true if the elements came from an action frame 2296 * @filter: bitmap of element IDs to filter out while calculating 2297 * the element CRC 2298 * @crc: CRC starting value 2299 * @bss: the BSS to parse this as, for multi-BSSID cases this can 2300 * represent a non-transmitting BSS in which case the data 2301 * for that non-transmitting BSS is returned 2302 * @link_id: the link ID to parse elements for, if a STA profile 2303 * is present in the multi-link element, or -1 to ignore; 2304 * note that the code currently assumes parsing an association 2305 * (or re-association) response frame if this is given 2306 * @from_ap: frame is received from an AP (currently used only 2307 * for EHT capabilities parsing) 2308 */ 2309 struct ieee80211_elems_parse_params { 2310 enum ieee80211_conn_mode mode; 2311 const u8 *start; 2312 size_t len; 2313 bool action; 2314 u64 filter; 2315 u32 crc; 2316 struct cfg80211_bss *bss; 2317 int link_id; 2318 bool from_ap; 2319 }; 2320 2321 struct ieee802_11_elems * 2322 ieee802_11_parse_elems_full(struct ieee80211_elems_parse_params *params); 2323 2324 static inline struct ieee802_11_elems * 2325 ieee802_11_parse_elems_crc(const u8 *start, size_t len, bool action, 2326 u64 filter, u32 crc, 2327 struct cfg80211_bss *bss) 2328 { 2329 struct ieee80211_elems_parse_params params = { 2330 .mode = IEEE80211_CONN_MODE_HIGHEST, 2331 .start = start, 2332 .len = len, 2333 .action = action, 2334 .filter = filter, 2335 .crc = crc, 2336 .bss = bss, 2337 .link_id = -1, 2338 }; 2339 2340 return ieee802_11_parse_elems_full(¶ms); 2341 } 2342 2343 static inline struct ieee802_11_elems * 2344 ieee802_11_parse_elems(const u8 *start, size_t len, bool action, 2345 struct cfg80211_bss *bss) 2346 { 2347 return ieee802_11_parse_elems_crc(start, len, action, 0, 0, bss); 2348 } 2349 2350 extern const int ieee802_1d_to_ac[8]; 2351 2352 static inline int ieee80211_ac_from_tid(int tid) 2353 { 2354 return ieee802_1d_to_ac[tid & 7]; 2355 } 2356 2357 void ieee80211_dynamic_ps_enable_work(struct wiphy *wiphy, 2358 struct wiphy_work *work); 2359 void ieee80211_dynamic_ps_disable_work(struct wiphy *wiphy, 2360 struct wiphy_work *work); 2361 void ieee80211_dynamic_ps_timer(struct timer_list *t); 2362 void ieee80211_send_nullfunc(struct ieee80211_local *local, 2363 struct ieee80211_sub_if_data *sdata, 2364 bool powersave); 2365 void ieee80211_send_4addr_nullfunc(struct ieee80211_local *local, 2366 struct ieee80211_sub_if_data *sdata); 2367 void ieee80211_sta_tx_notify(struct ieee80211_sub_if_data *sdata, 2368 struct ieee80211_hdr *hdr, bool ack, u16 tx_time); 2369 2370 void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw, 2371 unsigned long queues, 2372 enum queue_stop_reason reason, 2373 bool refcounted); 2374 void ieee80211_stop_vif_queues(struct ieee80211_local *local, 2375 struct ieee80211_sub_if_data *sdata, 2376 enum queue_stop_reason reason); 2377 void ieee80211_wake_vif_queues(struct ieee80211_local *local, 2378 struct ieee80211_sub_if_data *sdata, 2379 enum queue_stop_reason reason); 2380 void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw, 2381 unsigned long queues, 2382 enum queue_stop_reason reason, 2383 bool refcounted); 2384 void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue, 2385 enum queue_stop_reason reason, 2386 bool refcounted); 2387 void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue, 2388 enum queue_stop_reason reason, 2389 bool refcounted); 2390 void ieee80211_add_pending_skb(struct ieee80211_local *local, 2391 struct sk_buff *skb); 2392 void ieee80211_add_pending_skbs(struct ieee80211_local *local, 2393 struct sk_buff_head *skbs); 2394 void ieee80211_flush_queues(struct ieee80211_local *local, 2395 struct ieee80211_sub_if_data *sdata, bool drop); 2396 void __ieee80211_flush_queues(struct ieee80211_local *local, 2397 struct ieee80211_sub_if_data *sdata, 2398 unsigned int queues, bool drop); 2399 2400 static inline bool ieee80211_can_run_worker(struct ieee80211_local *local) 2401 { 2402 /* 2403 * It's unsafe to try to do any work during reconfigure flow. 2404 * When the flow ends the work will be requeued. 2405 */ 2406 if (local->in_reconfig) 2407 return false; 2408 2409 /* 2410 * If quiescing is set, we are racing with __ieee80211_suspend. 2411 * __ieee80211_suspend flushes the workers after setting quiescing, 2412 * and we check quiescing / suspended before enqueing new workers. 2413 * We should abort the worker to avoid the races below. 2414 */ 2415 if (local->quiescing) 2416 return false; 2417 2418 /* 2419 * We might already be suspended if the following scenario occurs: 2420 * __ieee80211_suspend Control path 2421 * 2422 * if (local->quiescing) 2423 * return; 2424 * local->quiescing = true; 2425 * flush_workqueue(); 2426 * queue_work(...); 2427 * local->suspended = true; 2428 * local->quiescing = false; 2429 * worker starts running... 2430 */ 2431 if (local->suspended) 2432 return false; 2433 2434 return true; 2435 } 2436 2437 int ieee80211_txq_setup_flows(struct ieee80211_local *local); 2438 void ieee80211_txq_set_params(struct ieee80211_local *local); 2439 void ieee80211_txq_teardown_flows(struct ieee80211_local *local); 2440 void ieee80211_txq_init(struct ieee80211_sub_if_data *sdata, 2441 struct sta_info *sta, 2442 struct txq_info *txq, int tid); 2443 void ieee80211_txq_purge(struct ieee80211_local *local, 2444 struct txq_info *txqi); 2445 void ieee80211_purge_sta_txqs(struct sta_info *sta); 2446 void ieee80211_txq_remove_vlan(struct ieee80211_local *local, 2447 struct ieee80211_sub_if_data *sdata); 2448 void ieee80211_fill_txq_stats(struct cfg80211_txq_stats *txqstats, 2449 struct txq_info *txqi); 2450 void ieee80211_wake_txqs(struct tasklet_struct *t); 2451 void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata, 2452 u16 transaction, u16 auth_alg, u16 status, 2453 const u8 *extra, size_t extra_len, const u8 *bssid, 2454 const u8 *da, const u8 *key, u8 key_len, u8 key_idx, 2455 u32 tx_flags); 2456 void ieee80211_send_deauth_disassoc(struct ieee80211_sub_if_data *sdata, 2457 const u8 *da, const u8 *bssid, 2458 u16 stype, u16 reason, 2459 bool send_frame, u8 *frame_buf); 2460 2461 enum { 2462 IEEE80211_PROBE_FLAG_DIRECTED = BIT(0), 2463 IEEE80211_PROBE_FLAG_MIN_CONTENT = BIT(1), 2464 IEEE80211_PROBE_FLAG_RANDOM_SN = BIT(2), 2465 }; 2466 2467 int ieee80211_build_preq_ies(struct ieee80211_sub_if_data *sdata, u8 *buffer, 2468 size_t buffer_len, 2469 struct ieee80211_scan_ies *ie_desc, 2470 const u8 *ie, size_t ie_len, 2471 u8 bands_used, u32 *rate_masks, 2472 struct cfg80211_chan_def *chandef, 2473 u32 flags); 2474 struct sk_buff *ieee80211_build_probe_req(struct ieee80211_sub_if_data *sdata, 2475 const u8 *src, const u8 *dst, 2476 u32 ratemask, 2477 struct ieee80211_channel *chan, 2478 const u8 *ssid, size_t ssid_len, 2479 const u8 *ie, size_t ie_len, 2480 u32 flags); 2481 u32 ieee80211_sta_get_rates(struct ieee80211_sub_if_data *sdata, 2482 struct ieee802_11_elems *elems, 2483 enum nl80211_band band, u32 *basic_rates); 2484 int __ieee80211_request_smps_mgd(struct ieee80211_sub_if_data *sdata, 2485 struct ieee80211_link_data *link, 2486 enum ieee80211_smps_mode smps_mode); 2487 void ieee80211_recalc_smps(struct ieee80211_sub_if_data *sdata, 2488 struct ieee80211_link_data *link); 2489 void ieee80211_recalc_min_chandef(struct ieee80211_sub_if_data *sdata, 2490 int link_id); 2491 2492 size_t ieee80211_ie_split_vendor(const u8 *ies, size_t ielen, size_t offset); 2493 u8 *ieee80211_ie_build_ht_cap(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap, 2494 u16 cap); 2495 u8 *ieee80211_ie_build_ht_oper(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap, 2496 const struct cfg80211_chan_def *chandef, 2497 u16 prot_mode, bool rifs_mode); 2498 void ieee80211_ie_build_wide_bw_cs(u8 *pos, 2499 const struct cfg80211_chan_def *chandef); 2500 u8 *ieee80211_ie_build_vht_cap(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap, 2501 u32 cap); 2502 u8 *ieee80211_ie_build_vht_oper(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap, 2503 const struct cfg80211_chan_def *chandef); 2504 u8 ieee80211_ie_len_he_cap(struct ieee80211_sub_if_data *sdata); 2505 u8 *ieee80211_ie_build_he_oper(u8 *pos, struct cfg80211_chan_def *chandef); 2506 u8 *ieee80211_ie_build_eht_oper(u8 *pos, struct cfg80211_chan_def *chandef, 2507 const struct ieee80211_sta_eht_cap *eht_cap); 2508 int ieee80211_parse_bitrates(enum nl80211_chan_width width, 2509 const struct ieee80211_supported_band *sband, 2510 const u8 *srates, int srates_len, u32 *rates); 2511 u8 *ieee80211_add_wmm_info_ie(u8 *buf, u8 qosinfo); 2512 void ieee80211_add_s1g_capab_ie(struct ieee80211_sub_if_data *sdata, 2513 struct ieee80211_sta_s1g_cap *caps, 2514 struct sk_buff *skb); 2515 void ieee80211_add_aid_request_ie(struct ieee80211_sub_if_data *sdata, 2516 struct sk_buff *skb); 2517 2518 /* element building in SKBs */ 2519 int ieee80211_put_srates_elem(struct sk_buff *skb, 2520 const struct ieee80211_supported_band *sband, 2521 u32 basic_rates, u32 rate_flags, u32 masked_rates, 2522 u8 element_id); 2523 int ieee80211_put_he_cap(struct sk_buff *skb, 2524 struct ieee80211_sub_if_data *sdata, 2525 const struct ieee80211_supported_band *sband, 2526 const struct ieee80211_conn_settings *conn); 2527 int ieee80211_put_he_6ghz_cap(struct sk_buff *skb, 2528 struct ieee80211_sub_if_data *sdata, 2529 enum ieee80211_smps_mode smps_mode); 2530 int ieee80211_put_eht_cap(struct sk_buff *skb, 2531 struct ieee80211_sub_if_data *sdata, 2532 const struct ieee80211_supported_band *sband, 2533 const struct ieee80211_conn_settings *conn); 2534 2535 /* channel management */ 2536 bool ieee80211_chandef_ht_oper(const struct ieee80211_ht_operation *ht_oper, 2537 struct cfg80211_chan_def *chandef); 2538 bool ieee80211_chandef_vht_oper(struct ieee80211_hw *hw, u32 vht_cap_info, 2539 const struct ieee80211_vht_operation *oper, 2540 const struct ieee80211_ht_operation *htop, 2541 struct cfg80211_chan_def *chandef); 2542 void ieee80211_chandef_eht_oper(const struct ieee80211_eht_operation_info *info, 2543 struct cfg80211_chan_def *chandef); 2544 bool ieee80211_chandef_he_6ghz_oper(struct ieee80211_local *local, 2545 const struct ieee80211_he_operation *he_oper, 2546 const struct ieee80211_eht_operation *eht_oper, 2547 struct cfg80211_chan_def *chandef); 2548 bool ieee80211_chandef_s1g_oper(const struct ieee80211_s1g_oper_ie *oper, 2549 struct cfg80211_chan_def *chandef); 2550 void ieee80211_chandef_downgrade(struct cfg80211_chan_def *chandef, 2551 struct ieee80211_conn_settings *conn); 2552 static inline void 2553 ieee80211_chanreq_downgrade(struct ieee80211_chan_req *chanreq, 2554 struct ieee80211_conn_settings *conn) 2555 { 2556 ieee80211_chandef_downgrade(&chanreq->oper, conn); 2557 if (WARN_ON(!conn)) 2558 return; 2559 if (conn->mode < IEEE80211_CONN_MODE_EHT) 2560 chanreq->ap.chan = NULL; 2561 } 2562 2563 bool ieee80211_chanreq_identical(const struct ieee80211_chan_req *a, 2564 const struct ieee80211_chan_req *b); 2565 2566 int __must_check 2567 ieee80211_link_use_channel(struct ieee80211_link_data *link, 2568 const struct ieee80211_chan_req *req, 2569 enum ieee80211_chanctx_mode mode); 2570 int __must_check 2571 ieee80211_link_reserve_chanctx(struct ieee80211_link_data *link, 2572 const struct ieee80211_chan_req *req, 2573 enum ieee80211_chanctx_mode mode, 2574 bool radar_required); 2575 int __must_check 2576 ieee80211_link_use_reserved_context(struct ieee80211_link_data *link); 2577 int ieee80211_link_unreserve_chanctx(struct ieee80211_link_data *link); 2578 2579 int __must_check 2580 ieee80211_link_change_chanreq(struct ieee80211_link_data *link, 2581 const struct ieee80211_chan_req *req, 2582 u64 *changed); 2583 void ieee80211_link_release_channel(struct ieee80211_link_data *link); 2584 void ieee80211_link_vlan_copy_chanctx(struct ieee80211_link_data *link); 2585 void ieee80211_link_copy_chanctx_to_vlans(struct ieee80211_link_data *link, 2586 bool clear); 2587 int ieee80211_chanctx_refcount(struct ieee80211_local *local, 2588 struct ieee80211_chanctx *ctx); 2589 2590 void ieee80211_recalc_smps_chanctx(struct ieee80211_local *local, 2591 struct ieee80211_chanctx *chanctx); 2592 void ieee80211_recalc_chanctx_min_def(struct ieee80211_local *local, 2593 struct ieee80211_chanctx *ctx, 2594 struct ieee80211_link_data *rsvd_for); 2595 bool ieee80211_is_radar_required(struct ieee80211_local *local); 2596 2597 void ieee80211_dfs_cac_timer_work(struct wiphy *wiphy, struct wiphy_work *work); 2598 void ieee80211_dfs_cac_cancel(struct ieee80211_local *local); 2599 void ieee80211_dfs_radar_detected_work(struct wiphy *wiphy, 2600 struct wiphy_work *work); 2601 int ieee80211_send_action_csa(struct ieee80211_sub_if_data *sdata, 2602 struct cfg80211_csa_settings *csa_settings); 2603 2604 void ieee80211_recalc_dtim(struct ieee80211_local *local, 2605 struct ieee80211_sub_if_data *sdata); 2606 int ieee80211_check_combinations(struct ieee80211_sub_if_data *sdata, 2607 const struct cfg80211_chan_def *chandef, 2608 enum ieee80211_chanctx_mode chanmode, 2609 u8 radar_detect); 2610 int ieee80211_max_num_channels(struct ieee80211_local *local); 2611 void ieee80211_recalc_chanctx_chantype(struct ieee80211_local *local, 2612 struct ieee80211_chanctx *ctx); 2613 2614 /* TDLS */ 2615 int ieee80211_tdls_mgmt(struct wiphy *wiphy, struct net_device *dev, 2616 const u8 *peer, int link_id, 2617 u8 action_code, u8 dialog_token, u16 status_code, 2618 u32 peer_capability, bool initiator, 2619 const u8 *extra_ies, size_t extra_ies_len); 2620 int ieee80211_tdls_oper(struct wiphy *wiphy, struct net_device *dev, 2621 const u8 *peer, enum nl80211_tdls_operation oper); 2622 void ieee80211_tdls_peer_del_work(struct wiphy *wiphy, struct wiphy_work *wk); 2623 int ieee80211_tdls_channel_switch(struct wiphy *wiphy, struct net_device *dev, 2624 const u8 *addr, u8 oper_class, 2625 struct cfg80211_chan_def *chandef); 2626 void ieee80211_tdls_cancel_channel_switch(struct wiphy *wiphy, 2627 struct net_device *dev, 2628 const u8 *addr); 2629 void ieee80211_teardown_tdls_peers(struct ieee80211_sub_if_data *sdata); 2630 void ieee80211_tdls_handle_disconnect(struct ieee80211_sub_if_data *sdata, 2631 const u8 *peer, u16 reason); 2632 void 2633 ieee80211_process_tdls_channel_switch(struct ieee80211_sub_if_data *sdata, 2634 struct sk_buff *skb); 2635 2636 2637 const char *ieee80211_get_reason_code_string(u16 reason_code); 2638 u16 ieee80211_encode_usf(int val); 2639 u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len, 2640 enum nl80211_iftype type); 2641 2642 extern const struct ethtool_ops ieee80211_ethtool_ops; 2643 2644 u32 ieee80211_calc_expected_tx_airtime(struct ieee80211_hw *hw, 2645 struct ieee80211_vif *vif, 2646 struct ieee80211_sta *pubsta, 2647 int len, bool ampdu); 2648 #ifdef CONFIG_MAC80211_NOINLINE 2649 #define debug_noinline noinline 2650 #else 2651 #define debug_noinline 2652 #endif 2653 2654 void ieee80211_init_frag_cache(struct ieee80211_fragment_cache *cache); 2655 void ieee80211_destroy_frag_cache(struct ieee80211_fragment_cache *cache); 2656 2657 u8 ieee80211_ie_len_eht_cap(struct ieee80211_sub_if_data *sdata); 2658 2659 void 2660 ieee80211_eht_cap_ie_to_sta_eht_cap(struct ieee80211_sub_if_data *sdata, 2661 struct ieee80211_supported_band *sband, 2662 const u8 *he_cap_ie, u8 he_cap_len, 2663 const struct ieee80211_eht_cap_elem *eht_cap_ie_elem, 2664 u8 eht_cap_len, 2665 struct link_sta_info *link_sta); 2666 void ieee80211_process_neg_ttlm_req(struct ieee80211_sub_if_data *sdata, 2667 struct ieee80211_mgmt *mgmt, size_t len); 2668 void ieee80211_process_neg_ttlm_res(struct ieee80211_sub_if_data *sdata, 2669 struct ieee80211_mgmt *mgmt, size_t len); 2670 int ieee80211_req_neg_ttlm(struct ieee80211_sub_if_data *sdata, 2671 struct cfg80211_ttlm_params *params); 2672 2673 void ieee80211_check_wbrf_support(struct ieee80211_local *local); 2674 void ieee80211_add_wbrf(struct ieee80211_local *local, struct cfg80211_chan_def *chandef); 2675 void ieee80211_remove_wbrf(struct ieee80211_local *local, struct cfg80211_chan_def *chandef); 2676 2677 #if IS_ENABLED(CONFIG_MAC80211_KUNIT_TEST) 2678 #define EXPORT_SYMBOL_IF_MAC80211_KUNIT(sym) EXPORT_SYMBOL_IF_KUNIT(sym) 2679 #define VISIBLE_IF_MAC80211_KUNIT 2680 ieee80211_rx_result 2681 ieee80211_drop_unencrypted_mgmt(struct ieee80211_rx_data *rx); 2682 #else 2683 #define EXPORT_SYMBOL_IF_MAC80211_KUNIT(sym) 2684 #define VISIBLE_IF_MAC80211_KUNIT static 2685 #endif 2686 2687 #endif /* IEEE80211_I_H */ 2688