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_bss_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_bss_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 1011 struct ieee80211_link_data_ap { 1012 struct beacon_data __rcu *beacon; 1013 struct probe_resp __rcu *probe_resp; 1014 struct fils_discovery_data __rcu *fils_discovery; 1015 struct unsol_bcast_probe_resp_data __rcu *unsol_bcast_probe_resp; 1016 1017 /* to be used after channel switch. */ 1018 struct cfg80211_beacon_data *next_beacon; 1019 }; 1020 1021 struct ieee80211_link_data { 1022 struct ieee80211_sub_if_data *sdata; 1023 unsigned int link_id; 1024 1025 struct list_head assigned_chanctx_list; /* protected by wiphy mutex */ 1026 struct list_head reserved_chanctx_list; /* protected by wiphy mutex */ 1027 1028 /* multicast keys only */ 1029 struct ieee80211_key __rcu *gtk[NUM_DEFAULT_KEYS + 1030 NUM_DEFAULT_MGMT_KEYS + 1031 NUM_DEFAULT_BEACON_KEYS]; 1032 struct ieee80211_key __rcu *default_multicast_key; 1033 struct ieee80211_key __rcu *default_mgmt_key; 1034 struct ieee80211_key __rcu *default_beacon_key; 1035 1036 struct wiphy_work csa_finalize_work; 1037 1038 bool operating_11g_mode; 1039 1040 struct ieee80211_chan_req csa_chanreq; 1041 1042 struct wiphy_work color_change_finalize_work; 1043 struct delayed_work color_collision_detect_work; 1044 u64 color_bitmap; 1045 1046 /* context reservation -- protected with wiphy mutex */ 1047 struct ieee80211_chanctx *reserved_chanctx; 1048 struct ieee80211_chan_req reserved; 1049 bool reserved_radar_required; 1050 bool reserved_ready; 1051 1052 u8 needed_rx_chains; 1053 enum ieee80211_smps_mode smps_mode; 1054 1055 int user_power_level; /* in dBm */ 1056 int ap_power_level; /* in dBm */ 1057 1058 bool radar_required; 1059 struct wiphy_delayed_work dfs_cac_timer_work; 1060 1061 union { 1062 struct ieee80211_link_data_managed mgd; 1063 struct ieee80211_link_data_ap ap; 1064 } u; 1065 1066 struct ieee80211_tx_queue_params tx_conf[IEEE80211_NUM_ACS]; 1067 1068 struct ieee80211_bss_conf *conf; 1069 1070 #ifdef CONFIG_MAC80211_DEBUGFS 1071 struct dentry *debugfs_dir; 1072 #endif 1073 }; 1074 1075 struct ieee80211_sub_if_data { 1076 struct list_head list; 1077 1078 struct wireless_dev wdev; 1079 1080 /* keys */ 1081 struct list_head key_list; 1082 1083 /* count for keys needing tailroom space allocation */ 1084 int crypto_tx_tailroom_needed_cnt; 1085 int crypto_tx_tailroom_pending_dec; 1086 struct wiphy_delayed_work dec_tailroom_needed_wk; 1087 1088 struct net_device *dev; 1089 struct ieee80211_local *local; 1090 1091 unsigned int flags; 1092 1093 unsigned long state; 1094 1095 bool csa_blocked_tx; 1096 1097 char name[IFNAMSIZ]; 1098 1099 struct ieee80211_fragment_cache frags; 1100 1101 /* TID bitmap for NoAck policy */ 1102 u16 noack_map; 1103 1104 /* bit field of ACM bits (BIT(802.1D tag)) */ 1105 u8 wmm_acm; 1106 1107 struct ieee80211_key __rcu *keys[NUM_DEFAULT_KEYS]; 1108 struct ieee80211_key __rcu *default_unicast_key; 1109 1110 u16 sequence_number; 1111 u16 mld_mcast_seq; 1112 __be16 control_port_protocol; 1113 bool control_port_no_encrypt; 1114 bool control_port_no_preauth; 1115 bool control_port_over_nl80211; 1116 1117 atomic_t num_tx_queued; 1118 struct mac80211_qos_map __rcu *qos_map; 1119 1120 struct wiphy_work work; 1121 struct sk_buff_head skb_queue; 1122 struct sk_buff_head status_queue; 1123 1124 /* 1125 * AP this belongs to: self in AP mode and 1126 * corresponding AP in VLAN mode, NULL for 1127 * all others (might be needed later in IBSS) 1128 */ 1129 struct ieee80211_if_ap *bss; 1130 1131 /* bitmap of allowed (non-MCS) rate indexes for rate control */ 1132 u32 rc_rateidx_mask[NUM_NL80211_BANDS]; 1133 1134 bool rc_has_mcs_mask[NUM_NL80211_BANDS]; 1135 u8 rc_rateidx_mcs_mask[NUM_NL80211_BANDS][IEEE80211_HT_MCS_MASK_LEN]; 1136 1137 bool rc_has_vht_mcs_mask[NUM_NL80211_BANDS]; 1138 u16 rc_rateidx_vht_mcs_mask[NUM_NL80211_BANDS][NL80211_VHT_NSS_MAX]; 1139 1140 /* Beacon frame (non-MCS) rate (as a bitmap) */ 1141 u32 beacon_rateidx_mask[NUM_NL80211_BANDS]; 1142 bool beacon_rate_set; 1143 1144 union { 1145 struct ieee80211_if_ap ap; 1146 struct ieee80211_if_vlan vlan; 1147 struct ieee80211_if_managed mgd; 1148 struct ieee80211_if_ibss ibss; 1149 struct ieee80211_if_mesh mesh; 1150 struct ieee80211_if_ocb ocb; 1151 struct ieee80211_if_mntr mntr; 1152 struct ieee80211_if_nan nan; 1153 } u; 1154 1155 struct ieee80211_link_data deflink; 1156 struct ieee80211_link_data __rcu *link[IEEE80211_MLD_MAX_NUM_LINKS]; 1157 1158 /* for ieee80211_set_active_links_async() */ 1159 struct wiphy_work activate_links_work; 1160 u16 desired_active_links; 1161 1162 #ifdef CONFIG_MAC80211_DEBUGFS 1163 struct { 1164 struct dentry *subdir_stations; 1165 struct dentry *default_unicast_key; 1166 struct dentry *default_multicast_key; 1167 struct dentry *default_mgmt_key; 1168 struct dentry *default_beacon_key; 1169 } debugfs; 1170 #endif 1171 1172 /* must be last, dynamically sized area in this! */ 1173 struct ieee80211_vif vif; 1174 }; 1175 1176 static inline 1177 struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p) 1178 { 1179 return container_of(p, struct ieee80211_sub_if_data, vif); 1180 } 1181 1182 #define sdata_dereference(p, sdata) \ 1183 wiphy_dereference(sdata->local->hw.wiphy, p) 1184 1185 #define for_each_sdata_link(_local, _link) \ 1186 /* outer loop just to define the variables ... */ \ 1187 for (struct ieee80211_sub_if_data *___sdata = NULL; \ 1188 !___sdata; \ 1189 ___sdata = (void *)~0 /* always stop */) \ 1190 list_for_each_entry(___sdata, &(_local)->interfaces, list) \ 1191 if (ieee80211_sdata_running(___sdata)) \ 1192 for (int ___link_id = 0; \ 1193 ___link_id < ARRAY_SIZE(___sdata->link); \ 1194 ___link_id++) \ 1195 if ((_link = wiphy_dereference((local)->hw.wiphy, \ 1196 ___sdata->link[___link_id]))) 1197 1198 static inline int 1199 ieee80211_get_mbssid_beacon_len(struct cfg80211_mbssid_elems *elems, 1200 struct cfg80211_rnr_elems *rnr_elems, 1201 u8 i) 1202 { 1203 int len = 0; 1204 1205 if (!elems || !elems->cnt || i > elems->cnt) 1206 return 0; 1207 1208 if (i < elems->cnt) { 1209 len = elems->elem[i].len; 1210 if (rnr_elems) { 1211 len += rnr_elems->elem[i].len; 1212 for (i = elems->cnt; i < rnr_elems->cnt; i++) 1213 len += rnr_elems->elem[i].len; 1214 } 1215 return len; 1216 } 1217 1218 /* i == elems->cnt, calculate total length of all MBSSID elements */ 1219 for (i = 0; i < elems->cnt; i++) 1220 len += elems->elem[i].len; 1221 1222 if (rnr_elems) { 1223 for (i = 0; i < rnr_elems->cnt; i++) 1224 len += rnr_elems->elem[i].len; 1225 } 1226 1227 return len; 1228 } 1229 1230 enum { 1231 IEEE80211_RX_MSG = 1, 1232 IEEE80211_TX_STATUS_MSG = 2, 1233 }; 1234 1235 enum queue_stop_reason { 1236 IEEE80211_QUEUE_STOP_REASON_DRIVER, 1237 IEEE80211_QUEUE_STOP_REASON_PS, 1238 IEEE80211_QUEUE_STOP_REASON_CSA, 1239 IEEE80211_QUEUE_STOP_REASON_AGGREGATION, 1240 IEEE80211_QUEUE_STOP_REASON_SUSPEND, 1241 IEEE80211_QUEUE_STOP_REASON_SKB_ADD, 1242 IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL, 1243 IEEE80211_QUEUE_STOP_REASON_FLUSH, 1244 IEEE80211_QUEUE_STOP_REASON_TDLS_TEARDOWN, 1245 IEEE80211_QUEUE_STOP_REASON_RESERVE_TID, 1246 IEEE80211_QUEUE_STOP_REASON_IFTYPE_CHANGE, 1247 1248 IEEE80211_QUEUE_STOP_REASONS, 1249 }; 1250 1251 #ifdef CONFIG_MAC80211_LEDS 1252 struct tpt_led_trigger { 1253 char name[32]; 1254 const struct ieee80211_tpt_blink *blink_table; 1255 unsigned int blink_table_len; 1256 struct timer_list timer; 1257 struct ieee80211_local *local; 1258 unsigned long prev_traffic; 1259 unsigned long tx_bytes, rx_bytes; 1260 unsigned int active, want; 1261 bool running; 1262 }; 1263 #endif 1264 1265 /** 1266 * enum mac80211_scan_flags - currently active scan mode 1267 * 1268 * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as 1269 * well be on the operating channel 1270 * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to 1271 * determine if we are on the operating channel or not 1272 * @SCAN_ONCHANNEL_SCANNING: Do a software scan on only the current operating 1273 * channel. This should not interrupt normal traffic. 1274 * @SCAN_COMPLETED: Set for our scan work function when the driver reported 1275 * that the scan completed. 1276 * @SCAN_ABORTED: Set for our scan work function when the driver reported 1277 * a scan complete for an aborted scan. 1278 * @SCAN_HW_CANCELLED: Set for our scan work function when the scan is being 1279 * cancelled. 1280 * @SCAN_BEACON_WAIT: Set whenever we're passive scanning because of radar/no-IR 1281 * and could send a probe request after receiving a beacon. 1282 * @SCAN_BEACON_DONE: Beacon received, we can now send a probe request 1283 */ 1284 enum mac80211_scan_flags { 1285 SCAN_SW_SCANNING, 1286 SCAN_HW_SCANNING, 1287 SCAN_ONCHANNEL_SCANNING, 1288 SCAN_COMPLETED, 1289 SCAN_ABORTED, 1290 SCAN_HW_CANCELLED, 1291 SCAN_BEACON_WAIT, 1292 SCAN_BEACON_DONE, 1293 }; 1294 1295 /** 1296 * enum mac80211_scan_state - scan state machine states 1297 * 1298 * @SCAN_DECISION: Main entry point to the scan state machine, this state 1299 * determines if we should keep on scanning or switch back to the 1300 * operating channel 1301 * @SCAN_SET_CHANNEL: Set the next channel to be scanned 1302 * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses 1303 * @SCAN_SUSPEND: Suspend the scan and go back to operating channel to 1304 * send out data 1305 * @SCAN_RESUME: Resume the scan and scan the next channel 1306 * @SCAN_ABORT: Abort the scan and go back to operating channel 1307 */ 1308 enum mac80211_scan_state { 1309 SCAN_DECISION, 1310 SCAN_SET_CHANNEL, 1311 SCAN_SEND_PROBE, 1312 SCAN_SUSPEND, 1313 SCAN_RESUME, 1314 SCAN_ABORT, 1315 }; 1316 1317 DECLARE_STATIC_KEY_FALSE(aql_disable); 1318 1319 struct ieee80211_local { 1320 /* embed the driver visible part. 1321 * don't cast (use the static inlines below), but we keep 1322 * it first anyway so they become a no-op */ 1323 struct ieee80211_hw hw; 1324 1325 struct fq fq; 1326 struct codel_vars *cvars; 1327 struct codel_params cparams; 1328 1329 /* protects active_txqs and txqi->schedule_order */ 1330 spinlock_t active_txq_lock[IEEE80211_NUM_ACS]; 1331 struct list_head active_txqs[IEEE80211_NUM_ACS]; 1332 u16 schedule_round[IEEE80211_NUM_ACS]; 1333 1334 /* serializes ieee80211_handle_wake_tx_queue */ 1335 spinlock_t handle_wake_tx_queue_lock; 1336 1337 u16 airtime_flags; 1338 u32 aql_txq_limit_low[IEEE80211_NUM_ACS]; 1339 u32 aql_txq_limit_high[IEEE80211_NUM_ACS]; 1340 u32 aql_threshold; 1341 atomic_t aql_total_pending_airtime; 1342 atomic_t aql_ac_pending_airtime[IEEE80211_NUM_ACS]; 1343 1344 const struct ieee80211_ops *ops; 1345 1346 /* 1347 * private workqueue to mac80211. mac80211 makes this accessible 1348 * via ieee80211_queue_work() 1349 */ 1350 struct workqueue_struct *workqueue; 1351 1352 unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES]; 1353 int q_stop_reasons[IEEE80211_MAX_QUEUES][IEEE80211_QUEUE_STOP_REASONS]; 1354 /* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */ 1355 spinlock_t queue_stop_reason_lock; 1356 1357 int open_count; 1358 int monitors, cooked_mntrs; 1359 /* number of interfaces with corresponding FIF_ flags */ 1360 int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll, 1361 fif_probe_req; 1362 bool probe_req_reg; 1363 bool rx_mcast_action_reg; 1364 unsigned int filter_flags; /* FIF_* */ 1365 1366 bool wiphy_ciphers_allocated; 1367 1368 struct cfg80211_chan_def dflt_chandef; 1369 bool emulate_chanctx; 1370 1371 /* protects the aggregated multicast list and filter calls */ 1372 spinlock_t filter_lock; 1373 1374 /* used for uploading changed mc list */ 1375 struct wiphy_work reconfig_filter; 1376 1377 /* aggregated multicast list */ 1378 struct netdev_hw_addr_list mc_list; 1379 1380 bool tim_in_locked_section; /* see ieee80211_beacon_get() */ 1381 1382 /* 1383 * suspended is true if we finished all the suspend _and_ we have 1384 * not yet come up from resume. This is to be used by mac80211 1385 * to ensure driver sanity during suspend and mac80211's own 1386 * sanity. It can eventually be used for WoW as well. 1387 */ 1388 bool suspended; 1389 1390 /* suspending is true during the whole suspend process */ 1391 bool suspending; 1392 1393 /* 1394 * Resuming is true while suspended, but when we're reprogramming the 1395 * hardware -- at that time it's allowed to use ieee80211_queue_work() 1396 * again even though some other parts of the stack are still suspended 1397 * and we still drop received frames to avoid waking the stack. 1398 */ 1399 bool resuming; 1400 1401 /* 1402 * quiescing is true during the suspend process _only_ to 1403 * ease timer cancelling etc. 1404 */ 1405 bool quiescing; 1406 1407 /* device is started */ 1408 bool started; 1409 1410 /* device is during a HW reconfig */ 1411 bool in_reconfig; 1412 1413 /* reconfiguration failed ... suppress some warnings etc. */ 1414 bool reconfig_failure; 1415 1416 /* wowlan is enabled -- don't reconfig on resume */ 1417 bool wowlan; 1418 1419 struct wiphy_work radar_detected_work; 1420 1421 /* number of RX chains the hardware has */ 1422 u8 rx_chains; 1423 1424 /* bitmap of which sbands were copied */ 1425 u8 sband_allocated; 1426 1427 int tx_headroom; /* required headroom for hardware/radiotap */ 1428 1429 /* Tasklet and skb queue to process calls from IRQ mode. All frames 1430 * added to skb_queue will be processed, but frames in 1431 * skb_queue_unreliable may be dropped if the total length of these 1432 * queues increases over the limit. */ 1433 #define IEEE80211_IRQSAFE_QUEUE_LIMIT 128 1434 struct tasklet_struct tasklet; 1435 struct sk_buff_head skb_queue; 1436 struct sk_buff_head skb_queue_unreliable; 1437 1438 spinlock_t rx_path_lock; 1439 1440 /* Station data */ 1441 /* 1442 * The list, hash table and counter are protected 1443 * by the wiphy mutex, reads are done with RCU. 1444 */ 1445 spinlock_t tim_lock; 1446 unsigned long num_sta; 1447 struct list_head sta_list; 1448 struct rhltable sta_hash; 1449 struct rhltable link_sta_hash; 1450 struct timer_list sta_cleanup; 1451 int sta_generation; 1452 1453 struct sk_buff_head pending[IEEE80211_MAX_QUEUES]; 1454 struct tasklet_struct tx_pending_tasklet; 1455 struct tasklet_struct wake_txqs_tasklet; 1456 1457 atomic_t agg_queue_stop[IEEE80211_MAX_QUEUES]; 1458 1459 /* number of interfaces with allmulti RX */ 1460 atomic_t iff_allmultis; 1461 1462 struct rate_control_ref *rate_ctrl; 1463 1464 struct arc4_ctx wep_tx_ctx; 1465 struct arc4_ctx wep_rx_ctx; 1466 u32 wep_iv; 1467 1468 /* see iface.c */ 1469 struct list_head interfaces; 1470 struct list_head mon_list; /* only that are IFF_UP && !cooked */ 1471 struct mutex iflist_mtx; 1472 1473 /* Scanning and BSS list */ 1474 unsigned long scanning; 1475 struct cfg80211_ssid scan_ssid; 1476 struct cfg80211_scan_request *int_scan_req; 1477 struct cfg80211_scan_request __rcu *scan_req; 1478 struct ieee80211_scan_request *hw_scan_req; 1479 struct cfg80211_chan_def scan_chandef; 1480 enum nl80211_band hw_scan_band; 1481 int scan_channel_idx; 1482 int scan_ies_len; 1483 int hw_scan_ies_bufsize; 1484 struct cfg80211_scan_info scan_info; 1485 1486 struct wiphy_work sched_scan_stopped_work; 1487 struct ieee80211_sub_if_data __rcu *sched_scan_sdata; 1488 struct cfg80211_sched_scan_request __rcu *sched_scan_req; 1489 u8 scan_addr[ETH_ALEN]; 1490 1491 unsigned long leave_oper_channel_time; 1492 enum mac80211_scan_state next_scan_state; 1493 struct wiphy_delayed_work scan_work; 1494 struct ieee80211_sub_if_data __rcu *scan_sdata; 1495 1496 /* Temporary remain-on-channel for off-channel operations */ 1497 struct ieee80211_channel *tmp_channel; 1498 1499 /* channel contexts */ 1500 struct list_head chanctx_list; 1501 1502 #ifdef CONFIG_MAC80211_LEDS 1503 struct led_trigger tx_led, rx_led, assoc_led, radio_led; 1504 struct led_trigger tpt_led; 1505 atomic_t tx_led_active, rx_led_active, assoc_led_active; 1506 atomic_t radio_led_active, tpt_led_active; 1507 struct tpt_led_trigger *tpt_led_trigger; 1508 #endif 1509 1510 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS 1511 /* SNMP counters */ 1512 /* dot11CountersTable */ 1513 u32 dot11TransmittedFragmentCount; 1514 u32 dot11MulticastTransmittedFrameCount; 1515 u32 dot11FailedCount; 1516 u32 dot11RetryCount; 1517 u32 dot11MultipleRetryCount; 1518 u32 dot11FrameDuplicateCount; 1519 u32 dot11ReceivedFragmentCount; 1520 u32 dot11MulticastReceivedFrameCount; 1521 u32 dot11TransmittedFrameCount; 1522 1523 /* TX/RX handler statistics */ 1524 unsigned int tx_handlers_drop; 1525 unsigned int tx_handlers_queued; 1526 unsigned int tx_handlers_drop_wep; 1527 unsigned int tx_handlers_drop_not_assoc; 1528 unsigned int tx_handlers_drop_unauth_port; 1529 unsigned int rx_handlers_drop; 1530 unsigned int rx_handlers_queued; 1531 unsigned int rx_handlers_drop_nullfunc; 1532 unsigned int rx_handlers_drop_defrag; 1533 unsigned int tx_expand_skb_head; 1534 unsigned int tx_expand_skb_head_cloned; 1535 unsigned int rx_expand_skb_head_defrag; 1536 unsigned int rx_handlers_fragments; 1537 unsigned int tx_status_drop; 1538 #define I802_DEBUG_INC(c) (c)++ 1539 #else /* CONFIG_MAC80211_DEBUG_COUNTERS */ 1540 #define I802_DEBUG_INC(c) do { } while (0) 1541 #endif /* CONFIG_MAC80211_DEBUG_COUNTERS */ 1542 1543 1544 int total_ps_buffered; /* total number of all buffered unicast and 1545 * multicast packets for power saving stations 1546 */ 1547 1548 bool pspolling; 1549 /* 1550 * PS can only be enabled when we have exactly one managed 1551 * interface (and monitors) in PS, this then points there. 1552 */ 1553 struct ieee80211_sub_if_data *ps_sdata; 1554 struct wiphy_work dynamic_ps_enable_work; 1555 struct wiphy_work dynamic_ps_disable_work; 1556 struct timer_list dynamic_ps_timer; 1557 struct notifier_block ifa_notifier; 1558 struct notifier_block ifa6_notifier; 1559 1560 /* 1561 * The dynamic ps timeout configured from user space via WEXT - 1562 * this will override whatever chosen by mac80211 internally. 1563 */ 1564 int dynamic_ps_forced_timeout; 1565 1566 int user_power_level; /* in dBm, for all interfaces */ 1567 1568 struct work_struct restart_work; 1569 1570 #ifdef CONFIG_MAC80211_DEBUGFS 1571 struct local_debugfsdentries { 1572 struct dentry *rcdir; 1573 struct dentry *keys; 1574 } debugfs; 1575 bool force_tx_status; 1576 #endif 1577 1578 /* 1579 * Remain-on-channel support 1580 */ 1581 struct wiphy_delayed_work roc_work; 1582 struct list_head roc_list; 1583 struct wiphy_work hw_roc_start, hw_roc_done; 1584 unsigned long hw_roc_start_time; 1585 u64 roc_cookie_counter; 1586 1587 struct idr ack_status_frames; 1588 spinlock_t ack_status_lock; 1589 1590 struct ieee80211_sub_if_data __rcu *p2p_sdata; 1591 1592 /* virtual monitor interface */ 1593 struct ieee80211_sub_if_data __rcu *monitor_sdata; 1594 struct ieee80211_chan_req monitor_chanreq; 1595 1596 /* extended capabilities provided by mac80211 */ 1597 u8 ext_capa[8]; 1598 1599 bool wbrf_supported; 1600 }; 1601 1602 static inline struct ieee80211_sub_if_data * 1603 IEEE80211_DEV_TO_SUB_IF(const struct net_device *dev) 1604 { 1605 return netdev_priv(dev); 1606 } 1607 1608 static inline struct ieee80211_sub_if_data * 1609 IEEE80211_WDEV_TO_SUB_IF(struct wireless_dev *wdev) 1610 { 1611 return container_of(wdev, struct ieee80211_sub_if_data, wdev); 1612 } 1613 1614 static inline struct ieee80211_supported_band * 1615 ieee80211_get_sband(struct ieee80211_sub_if_data *sdata) 1616 { 1617 struct ieee80211_local *local = sdata->local; 1618 struct ieee80211_chanctx_conf *chanctx_conf; 1619 enum nl80211_band band; 1620 1621 WARN_ON(ieee80211_vif_is_mld(&sdata->vif)); 1622 1623 rcu_read_lock(); 1624 chanctx_conf = rcu_dereference(sdata->vif.bss_conf.chanctx_conf); 1625 1626 if (!chanctx_conf) { 1627 rcu_read_unlock(); 1628 return NULL; 1629 } 1630 1631 band = chanctx_conf->def.chan->band; 1632 rcu_read_unlock(); 1633 1634 return local->hw.wiphy->bands[band]; 1635 } 1636 1637 static inline struct ieee80211_supported_band * 1638 ieee80211_get_link_sband(struct ieee80211_link_data *link) 1639 { 1640 struct ieee80211_local *local = link->sdata->local; 1641 struct ieee80211_chanctx_conf *chanctx_conf; 1642 enum nl80211_band band; 1643 1644 rcu_read_lock(); 1645 chanctx_conf = rcu_dereference(link->conf->chanctx_conf); 1646 if (!chanctx_conf) { 1647 rcu_read_unlock(); 1648 return NULL; 1649 } 1650 1651 band = chanctx_conf->def.chan->band; 1652 rcu_read_unlock(); 1653 1654 return local->hw.wiphy->bands[band]; 1655 } 1656 1657 /* this struct holds the value parsing from channel switch IE */ 1658 struct ieee80211_csa_ie { 1659 struct ieee80211_chan_req chanreq; 1660 u8 mode; 1661 u8 count; 1662 u8 ttl; 1663 u16 pre_value; 1664 u16 reason_code; 1665 u32 max_switch_time; 1666 }; 1667 1668 enum ieee80211_elems_parse_error { 1669 IEEE80211_PARSE_ERR_INVALID_END = BIT(0), 1670 IEEE80211_PARSE_ERR_DUP_ELEM = BIT(1), 1671 IEEE80211_PARSE_ERR_BAD_ELEM_SIZE = BIT(2), 1672 IEEE80211_PARSE_ERR_UNEXPECTED_ELEM = BIT(3), 1673 IEEE80211_PARSE_ERR_DUP_NEST_ML_BASIC = BIT(4), 1674 }; 1675 1676 /* Parsed Information Elements */ 1677 struct ieee802_11_elems { 1678 const u8 *ie_start; 1679 size_t total_len; 1680 u32 crc; 1681 1682 /* pointers to IEs */ 1683 const struct ieee80211_tdls_lnkie *lnk_id; 1684 const struct ieee80211_ch_switch_timing *ch_sw_timing; 1685 const u8 *ext_capab; 1686 const u8 *ssid; 1687 const u8 *supp_rates; 1688 const u8 *ds_params; 1689 const struct ieee80211_tim_ie *tim; 1690 const u8 *rsn; 1691 const u8 *rsnx; 1692 const u8 *erp_info; 1693 const u8 *ext_supp_rates; 1694 const u8 *wmm_info; 1695 const u8 *wmm_param; 1696 const struct ieee80211_ht_cap *ht_cap_elem; 1697 const struct ieee80211_ht_operation *ht_operation; 1698 const struct ieee80211_vht_cap *vht_cap_elem; 1699 const struct ieee80211_vht_operation *vht_operation; 1700 const struct ieee80211_meshconf_ie *mesh_config; 1701 const u8 *he_cap; 1702 const struct ieee80211_he_operation *he_operation; 1703 const struct ieee80211_he_spr *he_spr; 1704 const struct ieee80211_mu_edca_param_set *mu_edca_param_set; 1705 const struct ieee80211_he_6ghz_capa *he_6ghz_capa; 1706 const struct ieee80211_tx_pwr_env *tx_pwr_env[IEEE80211_TPE_MAX_IE_COUNT]; 1707 const u8 *uora_element; 1708 const u8 *mesh_id; 1709 const u8 *peering; 1710 const __le16 *awake_window; 1711 const u8 *preq; 1712 const u8 *prep; 1713 const u8 *perr; 1714 const struct ieee80211_rann_ie *rann; 1715 const struct ieee80211_channel_sw_ie *ch_switch_ie; 1716 const struct ieee80211_ext_chansw_ie *ext_chansw_ie; 1717 const struct ieee80211_wide_bw_chansw_ie *wide_bw_chansw_ie; 1718 const u8 *max_channel_switch_time; 1719 const u8 *country_elem; 1720 const u8 *pwr_constr_elem; 1721 const u8 *cisco_dtpc_elem; 1722 const struct ieee80211_timeout_interval_ie *timeout_int; 1723 const u8 *opmode_notif; 1724 const struct ieee80211_sec_chan_offs_ie *sec_chan_offs; 1725 struct ieee80211_mesh_chansw_params_ie *mesh_chansw_params_ie; 1726 const struct ieee80211_bss_max_idle_period_ie *max_idle_period_ie; 1727 const struct ieee80211_multiple_bssid_configuration *mbssid_config_ie; 1728 const struct ieee80211_bssid_index *bssid_index; 1729 u8 max_bssid_indicator; 1730 u8 dtim_count; 1731 u8 dtim_period; 1732 const struct ieee80211_addba_ext_ie *addba_ext_ie; 1733 const struct ieee80211_s1g_cap *s1g_capab; 1734 const struct ieee80211_s1g_oper_ie *s1g_oper; 1735 const struct ieee80211_s1g_bcn_compat_ie *s1g_bcn_compat; 1736 const struct ieee80211_aid_response_ie *aid_resp; 1737 const struct ieee80211_eht_cap_elem *eht_cap; 1738 const struct ieee80211_eht_operation *eht_operation; 1739 const struct ieee80211_multi_link_elem *ml_basic; 1740 const struct ieee80211_multi_link_elem *ml_reconf; 1741 const struct ieee80211_bandwidth_indication *bandwidth_indication; 1742 const struct ieee80211_ttlm_elem *ttlm[IEEE80211_TTLM_MAX_CNT]; 1743 1744 /* length of them, respectively */ 1745 u8 ext_capab_len; 1746 u8 ssid_len; 1747 u8 supp_rates_len; 1748 u8 tim_len; 1749 u8 rsn_len; 1750 u8 rsnx_len; 1751 u8 ext_supp_rates_len; 1752 u8 wmm_info_len; 1753 u8 wmm_param_len; 1754 u8 he_cap_len; 1755 u8 mesh_id_len; 1756 u8 peering_len; 1757 u8 preq_len; 1758 u8 prep_len; 1759 u8 perr_len; 1760 u8 country_elem_len; 1761 u8 bssid_index_len; 1762 u8 tx_pwr_env_len[IEEE80211_TPE_MAX_IE_COUNT]; 1763 u8 tx_pwr_env_num; 1764 u8 eht_cap_len; 1765 1766 /* mult-link element can be de-fragmented and thus u8 is not sufficient */ 1767 size_t ml_basic_len; 1768 size_t ml_reconf_len; 1769 1770 u8 ttlm_num; 1771 1772 /* 1773 * store the per station profile pointer and length in case that the 1774 * parsing also handled Multi-Link element parsing for a specific link 1775 * ID. 1776 */ 1777 struct ieee80211_mle_per_sta_profile *prof; 1778 size_t sta_prof_len; 1779 1780 /* whether/which parse error occurred while retrieving these elements */ 1781 u8 parse_error; 1782 }; 1783 1784 static inline struct ieee80211_local *hw_to_local( 1785 struct ieee80211_hw *hw) 1786 { 1787 return container_of(hw, struct ieee80211_local, hw); 1788 } 1789 1790 static inline struct txq_info *to_txq_info(struct ieee80211_txq *txq) 1791 { 1792 return container_of(txq, struct txq_info, txq); 1793 } 1794 1795 static inline bool txq_has_queue(struct ieee80211_txq *txq) 1796 { 1797 struct txq_info *txqi = to_txq_info(txq); 1798 1799 return !(skb_queue_empty(&txqi->frags) && !txqi->tin.backlog_packets); 1800 } 1801 1802 static inline bool 1803 ieee80211_have_rx_timestamp(struct ieee80211_rx_status *status) 1804 { 1805 return status->flag & RX_FLAG_MACTIME; 1806 } 1807 1808 void ieee80211_vif_inc_num_mcast(struct ieee80211_sub_if_data *sdata); 1809 void ieee80211_vif_dec_num_mcast(struct ieee80211_sub_if_data *sdata); 1810 1811 /* This function returns the number of multicast stations connected to this 1812 * interface. It returns -1 if that number is not tracked, that is for netdevs 1813 * not in AP or AP_VLAN mode or when using 4addr. 1814 */ 1815 static inline int 1816 ieee80211_vif_get_num_mcast_if(struct ieee80211_sub_if_data *sdata) 1817 { 1818 if (sdata->vif.type == NL80211_IFTYPE_AP) 1819 return atomic_read(&sdata->u.ap.num_mcast_sta); 1820 if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN && !sdata->u.vlan.sta) 1821 return atomic_read(&sdata->u.vlan.num_mcast_sta); 1822 return -1; 1823 } 1824 1825 u64 ieee80211_calculate_rx_timestamp(struct ieee80211_local *local, 1826 struct ieee80211_rx_status *status, 1827 unsigned int mpdu_len, 1828 unsigned int mpdu_offset); 1829 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed); 1830 int ieee80211_hw_conf_chan(struct ieee80211_local *local); 1831 void ieee80211_hw_conf_init(struct ieee80211_local *local); 1832 void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx); 1833 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata, 1834 u64 changed); 1835 void ieee80211_vif_cfg_change_notify(struct ieee80211_sub_if_data *sdata, 1836 u64 changed); 1837 void ieee80211_link_info_change_notify(struct ieee80211_sub_if_data *sdata, 1838 struct ieee80211_link_data *link, 1839 u64 changed); 1840 void ieee80211_configure_filter(struct ieee80211_local *local); 1841 u64 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata); 1842 1843 u64 ieee80211_mgmt_tx_cookie(struct ieee80211_local *local); 1844 int ieee80211_attach_ack_skb(struct ieee80211_local *local, struct sk_buff *skb, 1845 u64 *cookie, gfp_t gfp); 1846 1847 void ieee80211_check_fast_rx(struct sta_info *sta); 1848 void __ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata); 1849 void ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata); 1850 void ieee80211_clear_fast_rx(struct sta_info *sta); 1851 1852 bool ieee80211_is_our_addr(struct ieee80211_sub_if_data *sdata, 1853 const u8 *addr, int *out_link_id); 1854 1855 /* STA code */ 1856 void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata); 1857 int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata, 1858 struct cfg80211_auth_request *req); 1859 int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata, 1860 struct cfg80211_assoc_request *req); 1861 int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata, 1862 struct cfg80211_deauth_request *req); 1863 int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata, 1864 struct cfg80211_disassoc_request *req); 1865 void ieee80211_send_pspoll(struct ieee80211_local *local, 1866 struct ieee80211_sub_if_data *sdata); 1867 void ieee80211_recalc_ps(struct ieee80211_local *local); 1868 void ieee80211_recalc_ps_vif(struct ieee80211_sub_if_data *sdata); 1869 void ieee80211_sta_work(struct ieee80211_sub_if_data *sdata); 1870 void ieee80211_sta_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1871 struct sk_buff *skb); 1872 void ieee80211_sta_rx_queued_ext(struct ieee80211_sub_if_data *sdata, 1873 struct sk_buff *skb); 1874 void ieee80211_sta_reset_beacon_monitor(struct ieee80211_sub_if_data *sdata); 1875 void ieee80211_sta_reset_conn_monitor(struct ieee80211_sub_if_data *sdata); 1876 void ieee80211_mgd_stop(struct ieee80211_sub_if_data *sdata); 1877 void ieee80211_mgd_conn_tx_status(struct ieee80211_sub_if_data *sdata, 1878 __le16 fc, bool acked); 1879 void ieee80211_mgd_quiesce(struct ieee80211_sub_if_data *sdata); 1880 void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata); 1881 void ieee80211_sta_handle_tspec_ac_params(struct ieee80211_sub_if_data *sdata); 1882 void ieee80211_sta_connection_lost(struct ieee80211_sub_if_data *sdata, 1883 u8 reason, bool tx); 1884 void ieee80211_mgd_setup_link(struct ieee80211_link_data *link); 1885 void ieee80211_mgd_stop_link(struct ieee80211_link_data *link); 1886 void ieee80211_mgd_set_link_qos_params(struct ieee80211_link_data *link); 1887 1888 /* IBSS code */ 1889 void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local); 1890 void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata); 1891 void ieee80211_ibss_rx_no_sta(struct ieee80211_sub_if_data *sdata, 1892 const u8 *bssid, const u8 *addr, u32 supp_rates); 1893 int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata, 1894 struct cfg80211_ibss_params *params); 1895 int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata); 1896 void ieee80211_ibss_work(struct ieee80211_sub_if_data *sdata); 1897 void ieee80211_ibss_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1898 struct sk_buff *skb); 1899 int ieee80211_ibss_csa_beacon(struct ieee80211_sub_if_data *sdata, 1900 struct cfg80211_csa_settings *csa_settings, 1901 u64 *changed); 1902 int ieee80211_ibss_finish_csa(struct ieee80211_sub_if_data *sdata, 1903 u64 *changed); 1904 void ieee80211_ibss_stop(struct ieee80211_sub_if_data *sdata); 1905 1906 /* OCB code */ 1907 void ieee80211_ocb_work(struct ieee80211_sub_if_data *sdata); 1908 void ieee80211_ocb_rx_no_sta(struct ieee80211_sub_if_data *sdata, 1909 const u8 *bssid, const u8 *addr, u32 supp_rates); 1910 void ieee80211_ocb_setup_sdata(struct ieee80211_sub_if_data *sdata); 1911 int ieee80211_ocb_join(struct ieee80211_sub_if_data *sdata, 1912 struct ocb_setup *setup); 1913 int ieee80211_ocb_leave(struct ieee80211_sub_if_data *sdata); 1914 1915 /* mesh code */ 1916 void ieee80211_mesh_work(struct ieee80211_sub_if_data *sdata); 1917 void ieee80211_mesh_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata, 1918 struct sk_buff *skb); 1919 int ieee80211_mesh_csa_beacon(struct ieee80211_sub_if_data *sdata, 1920 struct cfg80211_csa_settings *csa_settings, 1921 u64 *changed); 1922 int ieee80211_mesh_finish_csa(struct ieee80211_sub_if_data *sdata, 1923 u64 *changed); 1924 1925 /* scan/BSS handling */ 1926 void ieee80211_scan_work(struct wiphy *wiphy, struct wiphy_work *work); 1927 int ieee80211_request_ibss_scan(struct ieee80211_sub_if_data *sdata, 1928 const u8 *ssid, u8 ssid_len, 1929 struct ieee80211_channel **channels, 1930 unsigned int n_channels); 1931 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata, 1932 struct cfg80211_scan_request *req); 1933 void ieee80211_scan_cancel(struct ieee80211_local *local); 1934 void ieee80211_run_deferred_scan(struct ieee80211_local *local); 1935 void ieee80211_scan_rx(struct ieee80211_local *local, struct sk_buff *skb); 1936 1937 void ieee80211_inform_bss(struct wiphy *wiphy, struct cfg80211_bss *bss, 1938 const struct cfg80211_bss_ies *ies, void *data); 1939 1940 void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local); 1941 struct ieee80211_bss * 1942 ieee80211_bss_info_update(struct ieee80211_local *local, 1943 struct ieee80211_rx_status *rx_status, 1944 struct ieee80211_mgmt *mgmt, 1945 size_t len, 1946 struct ieee80211_channel *channel); 1947 void ieee80211_rx_bss_put(struct ieee80211_local *local, 1948 struct ieee80211_bss *bss); 1949 1950 /* scheduled scan handling */ 1951 int 1952 __ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata, 1953 struct cfg80211_sched_scan_request *req); 1954 int ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata, 1955 struct cfg80211_sched_scan_request *req); 1956 int ieee80211_request_sched_scan_stop(struct ieee80211_local *local); 1957 void ieee80211_sched_scan_end(struct ieee80211_local *local); 1958 void ieee80211_sched_scan_stopped_work(struct wiphy *wiphy, 1959 struct wiphy_work *work); 1960 1961 /* off-channel/mgmt-tx */ 1962 void ieee80211_offchannel_stop_vifs(struct ieee80211_local *local); 1963 void ieee80211_offchannel_return(struct ieee80211_local *local); 1964 void ieee80211_roc_setup(struct ieee80211_local *local); 1965 void ieee80211_start_next_roc(struct ieee80211_local *local); 1966 void ieee80211_roc_purge(struct ieee80211_local *local, 1967 struct ieee80211_sub_if_data *sdata); 1968 int ieee80211_remain_on_channel(struct wiphy *wiphy, struct wireless_dev *wdev, 1969 struct ieee80211_channel *chan, 1970 unsigned int duration, u64 *cookie); 1971 int ieee80211_cancel_remain_on_channel(struct wiphy *wiphy, 1972 struct wireless_dev *wdev, u64 cookie); 1973 int ieee80211_mgmt_tx(struct wiphy *wiphy, struct wireless_dev *wdev, 1974 struct cfg80211_mgmt_tx_params *params, u64 *cookie); 1975 int ieee80211_mgmt_tx_cancel_wait(struct wiphy *wiphy, 1976 struct wireless_dev *wdev, u64 cookie); 1977 1978 /* channel switch handling */ 1979 void ieee80211_csa_finalize_work(struct wiphy *wiphy, struct wiphy_work *work); 1980 int ieee80211_channel_switch(struct wiphy *wiphy, struct net_device *dev, 1981 struct cfg80211_csa_settings *params); 1982 1983 /* color change handling */ 1984 void ieee80211_color_change_finalize_work(struct wiphy *wiphy, 1985 struct wiphy_work *work); 1986 void ieee80211_color_collision_detection_work(struct work_struct *work); 1987 1988 /* interface handling */ 1989 #define MAC80211_SUPPORTED_FEATURES_TX (NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \ 1990 NETIF_F_HW_CSUM | NETIF_F_SG | \ 1991 NETIF_F_HIGHDMA | NETIF_F_GSO_SOFTWARE | \ 1992 NETIF_F_HW_TC) 1993 #define MAC80211_SUPPORTED_FEATURES_RX (NETIF_F_RXCSUM) 1994 #define MAC80211_SUPPORTED_FEATURES (MAC80211_SUPPORTED_FEATURES_TX | \ 1995 MAC80211_SUPPORTED_FEATURES_RX) 1996 1997 int ieee80211_iface_init(void); 1998 void ieee80211_iface_exit(void); 1999 int ieee80211_if_add(struct ieee80211_local *local, const char *name, 2000 unsigned char name_assign_type, 2001 struct wireless_dev **new_wdev, enum nl80211_iftype type, 2002 struct vif_params *params); 2003 int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata, 2004 enum nl80211_iftype type); 2005 void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata); 2006 void ieee80211_remove_interfaces(struct ieee80211_local *local); 2007 u32 ieee80211_idle_off(struct ieee80211_local *local); 2008 void ieee80211_recalc_idle(struct ieee80211_local *local); 2009 void ieee80211_adjust_monitor_flags(struct ieee80211_sub_if_data *sdata, 2010 const int offset); 2011 int ieee80211_do_open(struct wireless_dev *wdev, bool coming_up); 2012 void ieee80211_sdata_stop(struct ieee80211_sub_if_data *sdata); 2013 int ieee80211_add_virtual_monitor(struct ieee80211_local *local); 2014 void ieee80211_del_virtual_monitor(struct ieee80211_local *local); 2015 2016 bool __ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata); 2017 void ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata, 2018 bool update_bss); 2019 void ieee80211_recalc_offload(struct ieee80211_local *local); 2020 2021 static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata) 2022 { 2023 return test_bit(SDATA_STATE_RUNNING, &sdata->state); 2024 } 2025 2026 /* link handling */ 2027 void ieee80211_link_setup(struct ieee80211_link_data *link); 2028 void ieee80211_link_init(struct ieee80211_sub_if_data *sdata, 2029 int link_id, 2030 struct ieee80211_link_data *link, 2031 struct ieee80211_bss_conf *link_conf); 2032 void ieee80211_link_stop(struct ieee80211_link_data *link); 2033 int ieee80211_vif_set_links(struct ieee80211_sub_if_data *sdata, 2034 u16 new_links, u16 dormant_links); 2035 static inline void ieee80211_vif_clear_links(struct ieee80211_sub_if_data *sdata) 2036 { 2037 ieee80211_vif_set_links(sdata, 0, 0); 2038 } 2039 2040 /* tx handling */ 2041 void ieee80211_clear_tx_pending(struct ieee80211_local *local); 2042 void ieee80211_tx_pending(struct tasklet_struct *t); 2043 netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb, 2044 struct net_device *dev); 2045 netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb, 2046 struct net_device *dev); 2047 netdev_tx_t ieee80211_subif_start_xmit_8023(struct sk_buff *skb, 2048 struct net_device *dev); 2049 void __ieee80211_subif_start_xmit(struct sk_buff *skb, 2050 struct net_device *dev, 2051 u32 info_flags, 2052 u32 ctrl_flags, 2053 u64 *cookie); 2054 void ieee80211_purge_tx_queue(struct ieee80211_hw *hw, 2055 struct sk_buff_head *skbs); 2056 struct sk_buff * 2057 ieee80211_build_data_template(struct ieee80211_sub_if_data *sdata, 2058 struct sk_buff *skb, u32 info_flags); 2059 void ieee80211_tx_monitor(struct ieee80211_local *local, struct sk_buff *skb, 2060 int retry_count, bool send_to_cooked, 2061 struct ieee80211_tx_status *status); 2062 2063 void ieee80211_check_fast_xmit(struct sta_info *sta); 2064 void ieee80211_check_fast_xmit_all(struct ieee80211_local *local); 2065 void ieee80211_check_fast_xmit_iface(struct ieee80211_sub_if_data *sdata); 2066 void ieee80211_clear_fast_xmit(struct sta_info *sta); 2067 int ieee80211_tx_control_port(struct wiphy *wiphy, struct net_device *dev, 2068 const u8 *buf, size_t len, 2069 const u8 *dest, __be16 proto, bool unencrypted, 2070 int link_id, u64 *cookie); 2071 int ieee80211_probe_mesh_link(struct wiphy *wiphy, struct net_device *dev, 2072 const u8 *buf, size_t len); 2073 void __ieee80211_xmit_fast(struct ieee80211_sub_if_data *sdata, 2074 struct sta_info *sta, 2075 struct ieee80211_fast_tx *fast_tx, 2076 struct sk_buff *skb, bool ampdu, 2077 const u8 *da, const u8 *sa); 2078 void ieee80211_aggr_check(struct ieee80211_sub_if_data *sdata, 2079 struct sta_info *sta, struct sk_buff *skb); 2080 2081 /* HT */ 2082 void ieee80211_apply_htcap_overrides(struct ieee80211_sub_if_data *sdata, 2083 struct ieee80211_sta_ht_cap *ht_cap); 2084 bool ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_sub_if_data *sdata, 2085 struct ieee80211_supported_band *sband, 2086 const struct ieee80211_ht_cap *ht_cap_ie, 2087 struct link_sta_info *link_sta); 2088 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata, 2089 const u8 *da, u16 tid, 2090 u16 initiator, u16 reason_code); 2091 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata, 2092 enum ieee80211_smps_mode smps, const u8 *da, 2093 const u8 *bssid, int link_id); 2094 bool ieee80211_smps_is_restrictive(enum ieee80211_smps_mode smps_mode_old, 2095 enum ieee80211_smps_mode smps_mode_new); 2096 2097 void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid, 2098 u16 initiator, u16 reason, bool stop); 2099 void __ieee80211_start_rx_ba_session(struct sta_info *sta, 2100 u8 dialog_token, u16 timeout, 2101 u16 start_seq_num, u16 ba_policy, u16 tid, 2102 u16 buf_size, bool tx, bool auto_seq, 2103 const struct ieee80211_addba_ext_ie *addbaext); 2104 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta, 2105 enum ieee80211_agg_stop_reason reason); 2106 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata, 2107 struct sta_info *sta, 2108 struct ieee80211_mgmt *mgmt, size_t len); 2109 void ieee80211_process_addba_resp(struct ieee80211_local *local, 2110 struct sta_info *sta, 2111 struct ieee80211_mgmt *mgmt, 2112 size_t len); 2113 void ieee80211_process_addba_request(struct ieee80211_local *local, 2114 struct sta_info *sta, 2115 struct ieee80211_mgmt *mgmt, 2116 size_t len); 2117 2118 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid, 2119 enum ieee80211_agg_stop_reason reason); 2120 void ieee80211_start_tx_ba_cb(struct sta_info *sta, int tid, 2121 struct tid_ampdu_tx *tid_tx); 2122 void ieee80211_stop_tx_ba_cb(struct sta_info *sta, int tid, 2123 struct tid_ampdu_tx *tid_tx); 2124 void ieee80211_ba_session_work(struct wiphy *wiphy, struct wiphy_work *work); 2125 void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid); 2126 void ieee80211_release_reorder_timeout(struct sta_info *sta, int tid); 2127 2128 u8 ieee80211_mcs_to_chains(const struct ieee80211_mcs_info *mcs); 2129 enum nl80211_smps_mode 2130 ieee80211_smps_mode_to_smps_mode(enum ieee80211_smps_mode smps); 2131 2132 /* VHT */ 2133 void 2134 ieee80211_vht_cap_ie_to_sta_vht_cap(struct ieee80211_sub_if_data *sdata, 2135 struct ieee80211_supported_band *sband, 2136 const struct ieee80211_vht_cap *vht_cap_ie, 2137 const struct ieee80211_vht_cap *vht_cap_ie2, 2138 struct link_sta_info *link_sta); 2139 enum ieee80211_sta_rx_bandwidth 2140 ieee80211_sta_cap_rx_bw(struct link_sta_info *link_sta); 2141 enum ieee80211_sta_rx_bandwidth 2142 ieee80211_sta_cur_vht_bw(struct link_sta_info *link_sta); 2143 void ieee80211_sta_init_nss(struct link_sta_info *link_sta); 2144 enum ieee80211_sta_rx_bandwidth 2145 ieee80211_chan_width_to_rx_bw(enum nl80211_chan_width width); 2146 enum nl80211_chan_width 2147 ieee80211_sta_cap_chan_bw(struct link_sta_info *link_sta); 2148 void ieee80211_process_mu_groups(struct ieee80211_sub_if_data *sdata, 2149 struct ieee80211_link_data *link, 2150 struct ieee80211_mgmt *mgmt); 2151 u32 __ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata, 2152 struct link_sta_info *sta, 2153 u8 opmode, enum nl80211_band band); 2154 void ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata, 2155 struct link_sta_info *sta, 2156 u8 opmode, enum nl80211_band band); 2157 void ieee80211_apply_vhtcap_overrides(struct ieee80211_sub_if_data *sdata, 2158 struct ieee80211_sta_vht_cap *vht_cap); 2159 void ieee80211_get_vht_mask_from_cap(__le16 vht_cap, 2160 u16 vht_mask[NL80211_VHT_NSS_MAX]); 2161 enum nl80211_chan_width 2162 ieee80211_sta_rx_bw_to_chan_width(struct link_sta_info *sta); 2163 2164 /* HE */ 2165 void 2166 ieee80211_he_cap_ie_to_sta_he_cap(struct ieee80211_sub_if_data *sdata, 2167 struct ieee80211_supported_band *sband, 2168 const u8 *he_cap_ie, u8 he_cap_len, 2169 const struct ieee80211_he_6ghz_capa *he_6ghz_capa, 2170 struct link_sta_info *link_sta); 2171 void 2172 ieee80211_he_spr_ie_to_bss_conf(struct ieee80211_vif *vif, 2173 const struct ieee80211_he_spr *he_spr_ie_elem); 2174 2175 void 2176 ieee80211_he_op_ie_to_bss_conf(struct ieee80211_vif *vif, 2177 const struct ieee80211_he_operation *he_op_ie_elem); 2178 2179 /* S1G */ 2180 void ieee80211_s1g_sta_rate_init(struct sta_info *sta); 2181 bool ieee80211_s1g_is_twt_setup(struct sk_buff *skb); 2182 void ieee80211_s1g_rx_twt_action(struct ieee80211_sub_if_data *sdata, 2183 struct sk_buff *skb); 2184 void ieee80211_s1g_status_twt_action(struct ieee80211_sub_if_data *sdata, 2185 struct sk_buff *skb); 2186 2187 /* Spectrum management */ 2188 void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata, 2189 struct ieee80211_mgmt *mgmt, 2190 size_t len); 2191 /** 2192 * ieee80211_parse_ch_switch_ie - parses channel switch IEs 2193 * @sdata: the sdata of the interface which has received the frame 2194 * @elems: parsed 802.11 elements received with the frame 2195 * @current_band: indicates the current band 2196 * @vht_cap_info: VHT capabilities of the transmitter 2197 * @conn: contains information about own capabilities and restrictions 2198 * to decide which channel switch announcements can be accepted 2199 * @bssid: the currently connected bssid (for reporting) 2200 * @csa_ie: parsed 802.11 csa elements on count, mode, chandef and mesh ttl. 2201 * All of them will be filled with if success only. 2202 * Return: 0 on success, <0 on error and >0 if there is nothing to parse. 2203 */ 2204 int ieee80211_parse_ch_switch_ie(struct ieee80211_sub_if_data *sdata, 2205 struct ieee802_11_elems *elems, 2206 enum nl80211_band current_band, 2207 u32 vht_cap_info, 2208 struct ieee80211_conn_settings *conn, 2209 u8 *bssid, 2210 struct ieee80211_csa_ie *csa_ie); 2211 2212 /* Suspend/resume and hw reconfiguration */ 2213 int ieee80211_reconfig(struct ieee80211_local *local); 2214 void ieee80211_stop_device(struct ieee80211_local *local); 2215 2216 int __ieee80211_suspend(struct ieee80211_hw *hw, 2217 struct cfg80211_wowlan *wowlan); 2218 2219 static inline int __ieee80211_resume(struct ieee80211_hw *hw) 2220 { 2221 struct ieee80211_local *local = hw_to_local(hw); 2222 2223 WARN(test_bit(SCAN_HW_SCANNING, &local->scanning) && 2224 !test_bit(SCAN_COMPLETED, &local->scanning), 2225 "%s: resume with hardware scan still in progress\n", 2226 wiphy_name(hw->wiphy)); 2227 2228 return ieee80211_reconfig(hw_to_local(hw)); 2229 } 2230 2231 /* utility functions/constants */ 2232 extern const void *const mac80211_wiphy_privid; /* for wiphy privid */ 2233 const char *ieee80211_conn_mode_str(enum ieee80211_conn_mode mode); 2234 enum ieee80211_conn_bw_limit 2235 ieee80211_min_bw_limit_from_chandef(struct cfg80211_chan_def *chandef); 2236 int ieee80211_frame_duration(enum nl80211_band band, size_t len, 2237 int rate, int erp, int short_preamble); 2238 void ieee80211_regulatory_limit_wmm_params(struct ieee80211_sub_if_data *sdata, 2239 struct ieee80211_tx_queue_params *qparam, 2240 int ac); 2241 void ieee80211_set_wmm_default(struct ieee80211_link_data *link, 2242 bool bss_notify, bool enable_qos); 2243 void ieee80211_xmit(struct ieee80211_sub_if_data *sdata, 2244 struct sta_info *sta, struct sk_buff *skb); 2245 2246 void __ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata, 2247 struct sk_buff *skb, int tid, int link_id, 2248 enum nl80211_band band); 2249 2250 /* sta_out needs to be checked for ERR_PTR() before using */ 2251 int ieee80211_lookup_ra_sta(struct ieee80211_sub_if_data *sdata, 2252 struct sk_buff *skb, 2253 struct sta_info **sta_out); 2254 2255 static inline void 2256 ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata, 2257 struct sk_buff *skb, int tid, 2258 enum nl80211_band band) 2259 { 2260 rcu_read_lock(); 2261 __ieee80211_tx_skb_tid_band(sdata, skb, tid, -1, band); 2262 rcu_read_unlock(); 2263 } 2264 2265 void ieee80211_tx_skb_tid(struct ieee80211_sub_if_data *sdata, 2266 struct sk_buff *skb, int tid, int link_id); 2267 2268 static inline void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata, 2269 struct sk_buff *skb) 2270 { 2271 /* Send all internal mgmt frames on VO. Accordingly set TID to 7. */ 2272 ieee80211_tx_skb_tid(sdata, skb, 7, -1); 2273 } 2274 2275 /** 2276 * struct ieee80211_elems_parse_params - element parsing parameters 2277 * @mode: connection mode for parsing 2278 * @start: pointer to the elements 2279 * @len: length of the elements 2280 * @action: %true if the elements came from an action frame 2281 * @filter: bitmap of element IDs to filter out while calculating 2282 * the element CRC 2283 * @crc: CRC starting value 2284 * @bss: the BSS to parse this as, for multi-BSSID cases this can 2285 * represent a non-transmitting BSS in which case the data 2286 * for that non-transmitting BSS is returned 2287 * @link_id: the link ID to parse elements for, if a STA profile 2288 * is present in the multi-link element, or -1 to ignore; 2289 * note that the code currently assumes parsing an association 2290 * (or re-association) response frame if this is given 2291 * @from_ap: frame is received from an AP (currently used only 2292 * for EHT capabilities parsing) 2293 */ 2294 struct ieee80211_elems_parse_params { 2295 enum ieee80211_conn_mode mode; 2296 const u8 *start; 2297 size_t len; 2298 bool action; 2299 u64 filter; 2300 u32 crc; 2301 struct cfg80211_bss *bss; 2302 int link_id; 2303 bool from_ap; 2304 }; 2305 2306 struct ieee802_11_elems * 2307 ieee802_11_parse_elems_full(struct ieee80211_elems_parse_params *params); 2308 2309 static inline struct ieee802_11_elems * 2310 ieee802_11_parse_elems_crc(const u8 *start, size_t len, bool action, 2311 u64 filter, u32 crc, 2312 struct cfg80211_bss *bss) 2313 { 2314 struct ieee80211_elems_parse_params params = { 2315 .mode = IEEE80211_CONN_MODE_HIGHEST, 2316 .start = start, 2317 .len = len, 2318 .action = action, 2319 .filter = filter, 2320 .crc = crc, 2321 .bss = bss, 2322 .link_id = -1, 2323 }; 2324 2325 return ieee802_11_parse_elems_full(¶ms); 2326 } 2327 2328 static inline struct ieee802_11_elems * 2329 ieee802_11_parse_elems(const u8 *start, size_t len, bool action, 2330 struct cfg80211_bss *bss) 2331 { 2332 return ieee802_11_parse_elems_crc(start, len, action, 0, 0, bss); 2333 } 2334 2335 extern const int ieee802_1d_to_ac[8]; 2336 2337 static inline int ieee80211_ac_from_tid(int tid) 2338 { 2339 return ieee802_1d_to_ac[tid & 7]; 2340 } 2341 2342 void ieee80211_dynamic_ps_enable_work(struct wiphy *wiphy, 2343 struct wiphy_work *work); 2344 void ieee80211_dynamic_ps_disable_work(struct wiphy *wiphy, 2345 struct wiphy_work *work); 2346 void ieee80211_dynamic_ps_timer(struct timer_list *t); 2347 void ieee80211_send_nullfunc(struct ieee80211_local *local, 2348 struct ieee80211_sub_if_data *sdata, 2349 bool powersave); 2350 void ieee80211_send_4addr_nullfunc(struct ieee80211_local *local, 2351 struct ieee80211_sub_if_data *sdata); 2352 void ieee80211_sta_tx_notify(struct ieee80211_sub_if_data *sdata, 2353 struct ieee80211_hdr *hdr, bool ack, u16 tx_time); 2354 2355 void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw, 2356 unsigned long queues, 2357 enum queue_stop_reason reason, 2358 bool refcounted); 2359 void ieee80211_stop_vif_queues(struct ieee80211_local *local, 2360 struct ieee80211_sub_if_data *sdata, 2361 enum queue_stop_reason reason); 2362 void ieee80211_wake_vif_queues(struct ieee80211_local *local, 2363 struct ieee80211_sub_if_data *sdata, 2364 enum queue_stop_reason reason); 2365 void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw, 2366 unsigned long queues, 2367 enum queue_stop_reason reason, 2368 bool refcounted); 2369 void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue, 2370 enum queue_stop_reason reason, 2371 bool refcounted); 2372 void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue, 2373 enum queue_stop_reason reason, 2374 bool refcounted); 2375 void ieee80211_add_pending_skb(struct ieee80211_local *local, 2376 struct sk_buff *skb); 2377 void ieee80211_add_pending_skbs(struct ieee80211_local *local, 2378 struct sk_buff_head *skbs); 2379 void ieee80211_flush_queues(struct ieee80211_local *local, 2380 struct ieee80211_sub_if_data *sdata, bool drop); 2381 void __ieee80211_flush_queues(struct ieee80211_local *local, 2382 struct ieee80211_sub_if_data *sdata, 2383 unsigned int queues, bool drop); 2384 2385 static inline bool ieee80211_can_run_worker(struct ieee80211_local *local) 2386 { 2387 /* 2388 * It's unsafe to try to do any work during reconfigure flow. 2389 * When the flow ends the work will be requeued. 2390 */ 2391 if (local->in_reconfig) 2392 return false; 2393 2394 /* 2395 * If quiescing is set, we are racing with __ieee80211_suspend. 2396 * __ieee80211_suspend flushes the workers after setting quiescing, 2397 * and we check quiescing / suspended before enqueing new workers. 2398 * We should abort the worker to avoid the races below. 2399 */ 2400 if (local->quiescing) 2401 return false; 2402 2403 /* 2404 * We might already be suspended if the following scenario occurs: 2405 * __ieee80211_suspend Control path 2406 * 2407 * if (local->quiescing) 2408 * return; 2409 * local->quiescing = true; 2410 * flush_workqueue(); 2411 * queue_work(...); 2412 * local->suspended = true; 2413 * local->quiescing = false; 2414 * worker starts running... 2415 */ 2416 if (local->suspended) 2417 return false; 2418 2419 return true; 2420 } 2421 2422 int ieee80211_txq_setup_flows(struct ieee80211_local *local); 2423 void ieee80211_txq_set_params(struct ieee80211_local *local); 2424 void ieee80211_txq_teardown_flows(struct ieee80211_local *local); 2425 void ieee80211_txq_init(struct ieee80211_sub_if_data *sdata, 2426 struct sta_info *sta, 2427 struct txq_info *txq, int tid); 2428 void ieee80211_txq_purge(struct ieee80211_local *local, 2429 struct txq_info *txqi); 2430 void ieee80211_purge_sta_txqs(struct sta_info *sta); 2431 void ieee80211_txq_remove_vlan(struct ieee80211_local *local, 2432 struct ieee80211_sub_if_data *sdata); 2433 void ieee80211_fill_txq_stats(struct cfg80211_txq_stats *txqstats, 2434 struct txq_info *txqi); 2435 void ieee80211_wake_txqs(struct tasklet_struct *t); 2436 void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata, 2437 u16 transaction, u16 auth_alg, u16 status, 2438 const u8 *extra, size_t extra_len, const u8 *bssid, 2439 const u8 *da, const u8 *key, u8 key_len, u8 key_idx, 2440 u32 tx_flags); 2441 void ieee80211_send_deauth_disassoc(struct ieee80211_sub_if_data *sdata, 2442 const u8 *da, const u8 *bssid, 2443 u16 stype, u16 reason, 2444 bool send_frame, u8 *frame_buf); 2445 2446 enum { 2447 IEEE80211_PROBE_FLAG_DIRECTED = BIT(0), 2448 IEEE80211_PROBE_FLAG_MIN_CONTENT = BIT(1), 2449 IEEE80211_PROBE_FLAG_RANDOM_SN = BIT(2), 2450 }; 2451 2452 int ieee80211_build_preq_ies(struct ieee80211_sub_if_data *sdata, u8 *buffer, 2453 size_t buffer_len, 2454 struct ieee80211_scan_ies *ie_desc, 2455 const u8 *ie, size_t ie_len, 2456 u8 bands_used, u32 *rate_masks, 2457 struct cfg80211_chan_def *chandef, 2458 u32 flags); 2459 struct sk_buff *ieee80211_build_probe_req(struct ieee80211_sub_if_data *sdata, 2460 const u8 *src, const u8 *dst, 2461 u32 ratemask, 2462 struct ieee80211_channel *chan, 2463 const u8 *ssid, size_t ssid_len, 2464 const u8 *ie, size_t ie_len, 2465 u32 flags); 2466 u32 ieee80211_sta_get_rates(struct ieee80211_sub_if_data *sdata, 2467 struct ieee802_11_elems *elems, 2468 enum nl80211_band band, u32 *basic_rates); 2469 int __ieee80211_request_smps_mgd(struct ieee80211_sub_if_data *sdata, 2470 struct ieee80211_link_data *link, 2471 enum ieee80211_smps_mode smps_mode); 2472 void ieee80211_recalc_smps(struct ieee80211_sub_if_data *sdata, 2473 struct ieee80211_link_data *link); 2474 void ieee80211_recalc_min_chandef(struct ieee80211_sub_if_data *sdata, 2475 int link_id); 2476 2477 size_t ieee80211_ie_split_vendor(const u8 *ies, size_t ielen, size_t offset); 2478 u8 *ieee80211_ie_build_ht_cap(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap, 2479 u16 cap); 2480 u8 *ieee80211_ie_build_ht_oper(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap, 2481 const struct cfg80211_chan_def *chandef, 2482 u16 prot_mode, bool rifs_mode); 2483 void ieee80211_ie_build_wide_bw_cs(u8 *pos, 2484 const struct cfg80211_chan_def *chandef); 2485 u8 *ieee80211_ie_build_vht_cap(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap, 2486 u32 cap); 2487 u8 *ieee80211_ie_build_vht_oper(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap, 2488 const struct cfg80211_chan_def *chandef); 2489 u8 ieee80211_ie_len_he_cap(struct ieee80211_sub_if_data *sdata); 2490 u8 *ieee80211_ie_build_he_oper(u8 *pos, struct cfg80211_chan_def *chandef); 2491 u8 *ieee80211_ie_build_eht_oper(u8 *pos, struct cfg80211_chan_def *chandef, 2492 const struct ieee80211_sta_eht_cap *eht_cap); 2493 int ieee80211_parse_bitrates(enum nl80211_chan_width width, 2494 const struct ieee80211_supported_band *sband, 2495 const u8 *srates, int srates_len, u32 *rates); 2496 u8 *ieee80211_add_wmm_info_ie(u8 *buf, u8 qosinfo); 2497 void ieee80211_add_s1g_capab_ie(struct ieee80211_sub_if_data *sdata, 2498 struct ieee80211_sta_s1g_cap *caps, 2499 struct sk_buff *skb); 2500 void ieee80211_add_aid_request_ie(struct ieee80211_sub_if_data *sdata, 2501 struct sk_buff *skb); 2502 2503 /* element building in SKBs */ 2504 int ieee80211_put_srates_elem(struct sk_buff *skb, 2505 const struct ieee80211_supported_band *sband, 2506 u32 basic_rates, u32 rate_flags, u32 masked_rates, 2507 u8 element_id); 2508 int ieee80211_put_he_cap(struct sk_buff *skb, 2509 struct ieee80211_sub_if_data *sdata, 2510 const struct ieee80211_supported_band *sband, 2511 const struct ieee80211_conn_settings *conn); 2512 int ieee80211_put_he_6ghz_cap(struct sk_buff *skb, 2513 struct ieee80211_sub_if_data *sdata, 2514 enum ieee80211_smps_mode smps_mode); 2515 int ieee80211_put_eht_cap(struct sk_buff *skb, 2516 struct ieee80211_sub_if_data *sdata, 2517 const struct ieee80211_supported_band *sband, 2518 const struct ieee80211_conn_settings *conn); 2519 2520 /* channel management */ 2521 bool ieee80211_chandef_ht_oper(const struct ieee80211_ht_operation *ht_oper, 2522 struct cfg80211_chan_def *chandef); 2523 bool ieee80211_chandef_vht_oper(struct ieee80211_hw *hw, u32 vht_cap_info, 2524 const struct ieee80211_vht_operation *oper, 2525 const struct ieee80211_ht_operation *htop, 2526 struct cfg80211_chan_def *chandef); 2527 void ieee80211_chandef_eht_oper(const struct ieee80211_eht_operation_info *info, 2528 struct cfg80211_chan_def *chandef); 2529 bool ieee80211_chandef_he_6ghz_oper(struct ieee80211_local *local, 2530 const struct ieee80211_he_operation *he_oper, 2531 const struct ieee80211_eht_operation *eht_oper, 2532 struct cfg80211_chan_def *chandef); 2533 bool ieee80211_chandef_s1g_oper(const struct ieee80211_s1g_oper_ie *oper, 2534 struct cfg80211_chan_def *chandef); 2535 void ieee80211_chandef_downgrade(struct cfg80211_chan_def *chandef, 2536 struct ieee80211_conn_settings *conn); 2537 static inline void 2538 ieee80211_chanreq_downgrade(struct ieee80211_chan_req *chanreq, 2539 struct ieee80211_conn_settings *conn) 2540 { 2541 ieee80211_chandef_downgrade(&chanreq->oper, conn); 2542 if (WARN_ON(!conn)) 2543 return; 2544 if (conn->mode < IEEE80211_CONN_MODE_EHT) 2545 chanreq->ap.chan = NULL; 2546 } 2547 2548 bool ieee80211_chanreq_identical(const struct ieee80211_chan_req *a, 2549 const struct ieee80211_chan_req *b); 2550 2551 int __must_check 2552 ieee80211_link_use_channel(struct ieee80211_link_data *link, 2553 const struct ieee80211_chan_req *req, 2554 enum ieee80211_chanctx_mode mode); 2555 int __must_check 2556 ieee80211_link_reserve_chanctx(struct ieee80211_link_data *link, 2557 const struct ieee80211_chan_req *req, 2558 enum ieee80211_chanctx_mode mode, 2559 bool radar_required); 2560 int __must_check 2561 ieee80211_link_use_reserved_context(struct ieee80211_link_data *link); 2562 int ieee80211_link_unreserve_chanctx(struct ieee80211_link_data *link); 2563 2564 int __must_check 2565 ieee80211_link_change_chanreq(struct ieee80211_link_data *link, 2566 const struct ieee80211_chan_req *req, 2567 u64 *changed); 2568 void ieee80211_link_release_channel(struct ieee80211_link_data *link); 2569 void ieee80211_link_vlan_copy_chanctx(struct ieee80211_link_data *link); 2570 void ieee80211_link_copy_chanctx_to_vlans(struct ieee80211_link_data *link, 2571 bool clear); 2572 int ieee80211_chanctx_refcount(struct ieee80211_local *local, 2573 struct ieee80211_chanctx *ctx); 2574 2575 void ieee80211_recalc_smps_chanctx(struct ieee80211_local *local, 2576 struct ieee80211_chanctx *chanctx); 2577 void ieee80211_recalc_chanctx_min_def(struct ieee80211_local *local, 2578 struct ieee80211_chanctx *ctx, 2579 struct ieee80211_link_data *rsvd_for); 2580 bool ieee80211_is_radar_required(struct ieee80211_local *local); 2581 2582 void ieee80211_dfs_cac_timer_work(struct wiphy *wiphy, struct wiphy_work *work); 2583 void ieee80211_dfs_cac_cancel(struct ieee80211_local *local); 2584 void ieee80211_dfs_radar_detected_work(struct wiphy *wiphy, 2585 struct wiphy_work *work); 2586 int ieee80211_send_action_csa(struct ieee80211_sub_if_data *sdata, 2587 struct cfg80211_csa_settings *csa_settings); 2588 2589 void ieee80211_recalc_dtim(struct ieee80211_local *local, 2590 struct ieee80211_sub_if_data *sdata); 2591 int ieee80211_check_combinations(struct ieee80211_sub_if_data *sdata, 2592 const struct cfg80211_chan_def *chandef, 2593 enum ieee80211_chanctx_mode chanmode, 2594 u8 radar_detect); 2595 int ieee80211_max_num_channels(struct ieee80211_local *local); 2596 void ieee80211_recalc_chanctx_chantype(struct ieee80211_local *local, 2597 struct ieee80211_chanctx *ctx); 2598 2599 /* TDLS */ 2600 int ieee80211_tdls_mgmt(struct wiphy *wiphy, struct net_device *dev, 2601 const u8 *peer, int link_id, 2602 u8 action_code, u8 dialog_token, u16 status_code, 2603 u32 peer_capability, bool initiator, 2604 const u8 *extra_ies, size_t extra_ies_len); 2605 int ieee80211_tdls_oper(struct wiphy *wiphy, struct net_device *dev, 2606 const u8 *peer, enum nl80211_tdls_operation oper); 2607 void ieee80211_tdls_peer_del_work(struct wiphy *wiphy, struct wiphy_work *wk); 2608 int ieee80211_tdls_channel_switch(struct wiphy *wiphy, struct net_device *dev, 2609 const u8 *addr, u8 oper_class, 2610 struct cfg80211_chan_def *chandef); 2611 void ieee80211_tdls_cancel_channel_switch(struct wiphy *wiphy, 2612 struct net_device *dev, 2613 const u8 *addr); 2614 void ieee80211_teardown_tdls_peers(struct ieee80211_link_data *link); 2615 void ieee80211_tdls_handle_disconnect(struct ieee80211_sub_if_data *sdata, 2616 const u8 *peer, u16 reason); 2617 void 2618 ieee80211_process_tdls_channel_switch(struct ieee80211_sub_if_data *sdata, 2619 struct sk_buff *skb); 2620 2621 2622 const char *ieee80211_get_reason_code_string(u16 reason_code); 2623 u16 ieee80211_encode_usf(int val); 2624 u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len, 2625 enum nl80211_iftype type); 2626 2627 extern const struct ethtool_ops ieee80211_ethtool_ops; 2628 2629 u32 ieee80211_calc_expected_tx_airtime(struct ieee80211_hw *hw, 2630 struct ieee80211_vif *vif, 2631 struct ieee80211_sta *pubsta, 2632 int len, bool ampdu); 2633 #ifdef CONFIG_MAC80211_NOINLINE 2634 #define debug_noinline noinline 2635 #else 2636 #define debug_noinline 2637 #endif 2638 2639 void ieee80211_init_frag_cache(struct ieee80211_fragment_cache *cache); 2640 void ieee80211_destroy_frag_cache(struct ieee80211_fragment_cache *cache); 2641 2642 u8 ieee80211_ie_len_eht_cap(struct ieee80211_sub_if_data *sdata); 2643 2644 void 2645 ieee80211_eht_cap_ie_to_sta_eht_cap(struct ieee80211_sub_if_data *sdata, 2646 struct ieee80211_supported_band *sband, 2647 const u8 *he_cap_ie, u8 he_cap_len, 2648 const struct ieee80211_eht_cap_elem *eht_cap_ie_elem, 2649 u8 eht_cap_len, 2650 struct link_sta_info *link_sta); 2651 void ieee80211_process_neg_ttlm_req(struct ieee80211_sub_if_data *sdata, 2652 struct ieee80211_mgmt *mgmt, size_t len); 2653 void ieee80211_process_neg_ttlm_res(struct ieee80211_sub_if_data *sdata, 2654 struct ieee80211_mgmt *mgmt, size_t len); 2655 int ieee80211_req_neg_ttlm(struct ieee80211_sub_if_data *sdata, 2656 struct cfg80211_ttlm_params *params); 2657 2658 void ieee80211_check_wbrf_support(struct ieee80211_local *local); 2659 void ieee80211_add_wbrf(struct ieee80211_local *local, struct cfg80211_chan_def *chandef); 2660 void ieee80211_remove_wbrf(struct ieee80211_local *local, struct cfg80211_chan_def *chandef); 2661 2662 #if IS_ENABLED(CONFIG_MAC80211_KUNIT_TEST) 2663 #define EXPORT_SYMBOL_IF_MAC80211_KUNIT(sym) EXPORT_SYMBOL_IF_KUNIT(sym) 2664 #define VISIBLE_IF_MAC80211_KUNIT 2665 ieee80211_rx_result 2666 ieee80211_drop_unencrypted_mgmt(struct ieee80211_rx_data *rx); 2667 #else 2668 #define EXPORT_SYMBOL_IF_MAC80211_KUNIT(sym) 2669 #define VISIBLE_IF_MAC80211_KUNIT static 2670 #endif 2671 2672 #endif /* IEEE80211_I_H */ 2673