1 /* SPDX-License-Identifier: GPL-2.0-only */
7  * Copyright 2006-2010	Johannes Berg <johannes@sipsolutions.net>
8  * Copyright 2013-2014 Intel Mobile Communications GmbH
9  * Copyright 2015-2017	Intel Deutschland GmbH
10  * Copyright (C) 2018-2020 Intel Corporation
69  * enum ieee80211_channel_flags - channel flags
140  * struct ieee80211_channel - channel definition
147  * @hw_value: hardware-specific value for the channel
183  * enum ieee80211_rate_flags - rate flags
216  * enum ieee80211_bss_type - BSS type filter
233  * enum ieee80211_privacy - BSS privacy filter
249  * struct ieee80211_rate - bitrate definition
256  * @flags: rate-specific flags
269  * struct ieee80211_he_obss_pd - AP settings for spatial reuse
273  * @non_srg_max_offset: non-SRG maximum tx power offset
292  * struct cfg80211_he_bss_color - AP settings for BSS coloring
305  * struct ieee80211_he_bss_color - AP settings for BSS coloring
318  * struct ieee80211_sta_ht_cap - STA's HT capabilities
325  * @ampdu_factor: Maximum A-MPDU length factor
326  * @ampdu_density: Minimum A-MPDU spacing
338  * struct ieee80211_sta_vht_cap - STA's VHT capabilities
356  * struct ieee80211_sta_he_cap - STA's HE capabilities
392  * enum ieee80211_edmg_bw_config - allowed channel bandwidth configurations
428  * struct ieee80211_edmg - EDMG configuration
446  * struct ieee80211_sta_s1g_cap - STA's S1G capabilities
462  * struct ieee80211_supported_band - frequency band definition
501  * ieee80211_get_sband_iftype_data - return sband data for a given iftype
516 	for (i = 0; i < sband->n_iftype_data; i++)  {  in ieee80211_get_sband_iftype_data()
518 			&sband->iftype_data[i];  in ieee80211_get_sband_iftype_data()
520 		if (data->types_mask & BIT(iftype))  in ieee80211_get_sband_iftype_data()
528  * ieee80211_get_he_iftype_cap - return HE capabilities for an sband's iftype
541 	if (data && data->he_cap.has_he)  in ieee80211_get_he_iftype_cap()
542 		return &data->he_cap;  in ieee80211_get_he_iftype_cap()
548  * ieee80211_get_he_sta_cap - return HE capabilities for an sband's STA
560  * ieee80211_get_he_6ghz_capa - return HE 6 GHz capabilities
573 	if (WARN_ON(!data || !data->he_cap.has_he))  in ieee80211_get_he_6ghz_capa()
576 	return data->he_6ghz_capa.capa;  in ieee80211_get_he_6ghz_capa()
580  * wiphy_read_of_freq_limits - read frequency limits from device tree
630  * struct vif_params - describes virtual interface parameters
633  * @use_4addr: use 4-address frames
640  * @vht_mumimo_groups: MU-MIMO groupID, used for monitoring MU-MIMO packets
641  *	belonging to that MU-MIMO groupID; %NULL if not changed
642  * @vht_mumimo_follow_addr: MU-MIMO follow address, used for monitoring
643  *	MU-MIMO packets going to the specified station; %NULL if not changed
654  * struct key_params - key information
679  * struct cfg80211_chan_def - channel definition
686  *	If edmg is requested (i.e. the .channels member is non-zero),
701  * cfg80211_bitrate_mask - masks for bitrate control
717  * struct cfg80211_tid_cfg - TID specific configuration
746  * struct cfg80211_tid_config - TID configuration
758  * cfg80211_get_chandef_type - return old channel type from chandef
761  * Return: The old channel type (NOHT, HT20, HT40+/-) from a given
767 	switch (chandef->width) {  in cfg80211_get_chandef_type()
773 		if (chandef->center_freq1 > chandef->chan->center_freq)  in cfg80211_get_chandef_type()
783  * cfg80211_chandef_create - create channel definition using channel type
795  * cfg80211_chandef_identical - check if two channel definitions are identical
806 	return (chandef1->chan == chandef2->chan &&  in cfg80211_chandef_identical()
807 		chandef1->width == chandef2->width &&  in cfg80211_chandef_identical()
808 		chandef1->center_freq1 == chandef2->center_freq1 &&  in cfg80211_chandef_identical()
809 		chandef1->freq1_offset == chandef2->freq1_offset &&  in cfg80211_chandef_identical()
810 		chandef1->center_freq2 == chandef2->center_freq2);  in cfg80211_chandef_identical()
814  * cfg80211_chandef_is_edmg - check if chandef represents an EDMG channel
823 	return chandef->edmg.channels || chandef->edmg.bw_config;  in cfg80211_chandef_is_edmg()
827  * cfg80211_chandef_compatible - check if two channel definitions are compatible
839  * cfg80211_chandef_valid - check if a channel definition is valid
846  * cfg80211_chandef_usable - check if secondary channels can be used
857  * cfg80211_chandef_dfs_required - checks if radar detection is required
869  * ieee80211_chandef_rate_flags - returns rate flags for a channel
871  * In some channel types, not all rates may be used - for example CCK
881 	switch (chandef->width) {  in ieee80211_chandef_rate_flags()
893  * ieee80211_chandef_max_power - maximum transmission power for the chandef
897  * max_power for non-standard (20 MHz) channels.
906 	switch (chandef->width) {  in ieee80211_chandef_max_power()
908 		return min(chandef->chan->max_reg_power - 6,  in ieee80211_chandef_max_power()
909 			   chandef->chan->max_power);  in ieee80211_chandef_max_power()
911 		return min(chandef->chan->max_reg_power - 3,  in ieee80211_chandef_max_power()
912 			   chandef->chan->max_power);  in ieee80211_chandef_max_power()
916 	return chandef->chan->max_power;  in ieee80211_chandef_max_power()
920  * enum survey_info_flags - survey information flags
948  * struct survey_info - channel survey response
963  * Used by dump_survey() to report back per-channel survey information.
984  * struct cfg80211_crypto_settings - Crypto settings
1002  * @control_port_no_preauth: disables pre-auth rx over the nl80211 control
1007  * @psk: PSK (for devices supporting 4-way-handshake offload)
1032  * struct cfg80211_beacon_data - beacon data
1049  * @ftm_responder: enable FTM responder functionality; -1 for no change
1082  * struct cfg80211_acl_data - Access control list data
1098  * struct cfg80211_fils_discovery - FILS discovery parameters from
1099  * IEEE Std 802.11ai-2016, Annex C.3 MIB detail.
1101  * @min_interval: Minimum packet interval in TUs (0 - 10000)
1102  * @max_interval: Maximum packet interval in TUs (0 - 10000)
1115  * struct cfg80211_unsol_bcast_probe_resp - Unsolicited broadcast probe
1119  *	in IEEE P802.11ax/D6.0 26.17.2.3.2 - AP behavior for fast passive
1131  * enum cfg80211_ap_settings_flags - AP settings flags
1142  * struct cfg80211_ap_settings - AP configuration
1214  * struct cfg80211_csa_settings - channel switch settings
1245  * struct iface_combination_params - input parameters for interface combinations
1269  * enum station_parameters_apply_mask - station parameter values to apply
1274  * Not all station parameters have in-band "no change" signalling,
1285  * struct sta_txpwr - station txpower configuration
1290  *	is not provided, the default per-interface tx power setting will be
1292  *	power per-interface or per-station.
1305  * struct station_parameters - station parameters
1317  * @listen_interval: listen interval or -1 for no change
1332  * @local_pm: local link-specific mesh power save mode (no change when set
1385  * struct station_del_parameters - station deletion parameters
1401  * enum cfg80211_station_type - the type of station being modified
1431  * cfg80211_check_station_change - validate parameter changes
1447  * enum rate_info_flags - bitrate info flags
1469  * enum rate_info_bw - rate bandwidth information
1492  * struct rate_info - bitrate information
1505  * @n_bonded_ch: In case of EDMG the number of bonded channels (1-4)
1520  * enum bss_param_flags - bitrate info flags
1536  * struct sta_bss_parameters - BSS parameters for the attached station
1551  * struct cfg80211_txq_stats - TXQ statistics for this TID
1582  * struct cfg80211_tid_stats - per-TID statistics
1604  * struct station_info - station information
1623  * @chain_signal: per-chain signal strength of last received packet in dBm
1624  * @chain_signal_avg: per-chain signal strength average in dBm
1631  * @rx_dropped_misc:  Dropped for un-specified reason.
1647  * @nonpeer_pm: non-peer mesh STA power save mode
1657  * @pertid: per-TID statistics, see &struct cfg80211_tid_stats, using the last
1658  *	(IEEE80211_NUM_TIDS) index for MSDUs not encapsulated in QoS-MPDUs.
1659  *	Note that this doesn't use the @filled bit, but is used if non-NULL.
1732  * cfg80211_get_station - retrieve information about a given station
1748 	return -ENOENT;  in cfg80211_get_station()
1753  * enum monitor_flags - monitor flags
1777  * enum mpath_info_flags -  mesh path information flags
1805  * struct mpath_info - mesh path information
1840  * struct bss_parameters - BSS parameters
1845  *	(0 = no, 1 = yes, -1 = do not change)
1847  *	(0 = no, 1 = yes, -1 = do not change)
1849  *	(0 = no, 1 = yes, -1 = do not change)
1854  *	(0 = no, 1 = yes, -1 = do not change)
1856  *	(u16 = opmode, -1 = do not change)
1857  * @p2p_ctwindow: P2P CT Window (-1 = no change)
1858  * @p2p_opp_ps: P2P opportunistic PS (-1 = no change)
1872  * struct mesh_config - 802.11s mesh configuration
1918  * @dot11MeshForwarding: whether the Mesh STA is forwarding or non-forwarding
1919  *	entity (default is TRUE - forwarding entity)
1944  * @dot11MeshNolearn: Try to avoid multi-hop path discovery (e.g. PREQ/PREP
1946  *      not be the optimal decision as a multi-hop route might be better. So
1985  * struct mesh_setup - 802.11s mesh setup configuration
2034  * struct ocb_setup - 802.11p OCB mode setup configuration
2044  * struct ieee80211_txq_params - TX queue parameters
2047  * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
2049  * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
2071  * well-formed, and will not exceed the maximum length the driver advertised
2085  * struct cfg80211_ssid - SSID description
2095  * struct cfg80211_scan_info - information about completed scan
2110  * struct cfg80211_scan_6ghz_params - relevant for 6 GHz only
2131  * struct cfg80211_scan_request - scan request description
2208  * struct cfg80211_match_set - sets of attributes to match
2210  * @ssid: SSID to be matched; may be zero-length in case of BSSID match
2212  * @bssid: BSSID to be matched; may be all-zero BSSID in case of SSID match
2231  * struct cfg80211_sched_scan_plan - scan plan for scheduled scan
2245  * struct cfg80211_bss_select_adjust - BSS selection with RSSI adjustment.
2256  * struct cfg80211_sched_scan_request - scheduled scan request description
2288  * @nl_owner_dead: netlink owner socket was closed - this request be freed
2343  * enum cfg80211_signal_type - signal type
2356  * struct cfg80211_inform_bss - BSS inform data
2373  * @chain_signal: per-chain signal strength of last received BSS in dBm.
2387  * struct cfg80211_bss_ies - BSS entry IE data
2403  * struct cfg80211_bss - BSS description
2414  *	are well-formed!); this is a pointer to either the beacon_ies or
2416  *	received. It is always non-%NULL.
2425  *	points to the same data as hidden_beacon_bss->beacon_ies in that case.
2427  *	non-transmitted one (multi-BSSID support)
2428  * @nontrans_list: list of non-transmitted BSS, if this is a transmitted one
2429  *	(multi-BSSID support)
2432  * @chain_signal: per-chain signal strength of last received BSS in dBm.
2435  * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
2465  * ieee80211_bss_get_elem - find element with given ID
2469  * Note that the return value is an RCU-protected pointer, so
2476  * ieee80211_bss_get_ie - find IE with given ID
2480  * Note that the return value is an RCU-protected pointer, so
2491  * struct cfg80211_auth_request - Authentication request data
2505  *	the authentication frame body (non-IE and IE data), excluding the
2522  * enum cfg80211_assoc_req_flags - Over-ride default behaviour in association.
2540  * struct cfg80211_assoc_request - (Re)Association request data
2559  * @ht_capa:  HT Capabilities over-rides.  Values set in ht_capa_mask
2560  *	will be used in ht_capa.  Un-supported values will be ignored.
2590  * struct cfg80211_deauth_request - Deauthentication request data
2611  * struct cfg80211_disassoc_request - Disassociation request data
2632  * struct cfg80211_ibss_params - IBSS parameters
2637  * @ssid: The SSID, will always be non-null.
2638  * @ssid_len: The length of the SSID, will always be non-zero.
2642  * @channel_fixed: The channel should be fixed -- do not search for
2659  * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
2660  * @ht_capa:  HT Capabilities over-rides.  Values set in ht_capa_mask
2661  *	will be used in ht_capa.  Un-supported values will be ignored.
2688  * struct cfg80211_bss_selection - connection parameters for BSS selection.
2704  * struct cfg80211_connect_params - Connection parameters
2709  * @channel: The channel to use or %NULL if not specified (auto-select based
2713  * @bssid: The AP BSSID or %NULL if not specified (auto-select based on scan
2724  * @privacy: indicates whether privacy-enabled APs should be used
2732  *	or -1 to indicate that default value is to be used.
2733  * @ht_capa:  HT Capabilities over-rides.  Values set in ht_capa_mask
2734  *	will be used in ht_capa.  Un-supported values will be ignored.
2747  * @fils_erp_username: EAP re-authentication protocol (ERP) username part of the
2751  * @fils_erp_realm: EAP re-authentication protocol (ERP) realm part of NAI or
2757  * @fils_erp_rrk: ERP re-authentication Root Key (rRK) used to derive additional
2760  * @want_1x: indicates user-space supports and wants to use 802.1X driver
2761  *	offload of 4-way handshake.
2802  * enum cfg80211_connect_params_changed - Connection parameters being updated
2819  * enum wiphy_params_flags - set_wiphy_params bitfield values
2820  * @WIPHY_PARAM_RETRY_SHORT: wiphy->retry_short has changed
2821  * @WIPHY_PARAM_RETRY_LONG: wiphy->retry_long has changed
2822  * @WIPHY_PARAM_FRAG_THRESHOLD: wiphy->frag_threshold has changed
2823  * @WIPHY_PARAM_RTS_THRESHOLD: wiphy->rts_threshold has changed
2852  * struct cfg80211_pmksa - PMK Security Association
2866  * @cache_id: 2-octet cache identifier advertized by a FILS AP identifying the
2867  *	scope of PMKSA. This is valid only if @ssid_len is non-zero (may be
2894  * struct cfg80211_pkt_pattern - packet pattern
2911  * struct cfg80211_wowlan_tcp - TCP connection parameters
2946  * struct cfg80211_wowlan - Wake on Wireless-LAN support info
2949  * @any: wake up on any activity -- special trigger if device continues
2957  * @four_way_handshake: wake up on 4-way handshake
2974  * struct cfg80211_coalesce_rules - Coalesce rule parameters
2991  * struct cfg80211_coalesce - Packet coalescing settings
3003  * struct cfg80211_wowlan_nd_match - information about the match
3018  * struct cfg80211_wowlan_nd_info - net detect wake up information
3032  * struct cfg80211_wowlan_wakeup - wakeup report
3037  * @four_way_handshake: woke up by 4-way handshake
3039  * @pattern_idx: pattern that caused wakeup, -1 if not due to pattern
3064  * struct cfg80211_gtk_rekey_data - rekey data
3079  * struct cfg80211_update_ft_ies_params - FT IE Information
3094  * struct cfg80211_mgmt_tx_params - mgmt tx parameters
3121  * struct cfg80211_dscp_exception - DSCP exception
3132  * struct cfg80211_dscp_range - DSCP range definition for user priority
3142 /* QoS Map Set element length defined in IEEE Std 802.11-2012, 8.4.2.97 */
3149  * struct cfg80211_qos_map - QoS Map Information
3165  * struct cfg80211_nan_conf - NAN configuration
3169  * @master_pref: master preference (1 - 255)
3180  * enum cfg80211_nan_conf_changes - indicates changed fields in NAN
3192  * struct cfg80211_nan_func_filter - a NAN function Rx / Tx filter
3203  * struct cfg80211_nan_func - a NAN function
3259  * struct cfg80211_pmk_conf - PMK configuration
3264  * @pmk_r0_name: PMK-R0 Name. NULL if not applicable (i.e., the PMK
3265  *	is not PMK-R0). When pmk_r0_name is not NULL, the pmk field
3266  *	holds PMK-R0.
3276  * struct cfg80211_external_auth_params - Trigger External authentication.
3305  * struct cfg80211_ftm_responder_stats - FTM responder statistics
3315  * @non_asap_num: number of  non-ASAP FTM sessions
3316  * @total_duration_ms: total sessions durations - gives an indication
3318  * @unknown_triggers_num: number of unknown FTM triggers - triggers from
3321  * @reschedule_requests_num: number of FTM reschedule requests - initiator asks
3339  * struct cfg80211_pmsr_ftm_result - FTM result
3344  *	in [0 .. num_bursts-1] of the burst that's being reported
3419  * struct cfg80211_pmsr_result - peer measurement result
3449  * struct cfg80211_pmsr_ftm_request_peer - FTM request data
3485  * struct cfg80211_pmsr_request_peer - peer data for a peer measurement request
3499  * struct cfg80211_pmsr_request - peer measurement request
3501  * @nl_portid: netlink portid - used by cfg80211
3512  * @peers: per-peer measurement request data
3531  * struct cfg80211_update_owe_info - OWE Information
3557  * struct mgmt_frame_regs - management frame registrations data
3572  * struct cfg80211_ops - backend description for wireless configuration
3585  *	be %NULL or contain the enabled Wake-on-Wireless triggers that are
3610  *	not possible to retrieve the key, -ENOENT if it doesn't exist.
3613  *	and @key_index, return -ENOENT if the key doesn't exist.
3631  *	validated in cfg80211, in particular the auth/assoc/authorized flags
3632  *	might come to the driver in invalid combinations -- make sure to check
3636  * @dump_station: dump station callback -- resume dump at index @idx
3642  * @dump_mpath: dump mesh path callback -- resume dump at index @idx
3644  * @dump_mpp: dump mesh proxy path callback -- resume dump at index @idx
3678  * @assoc: Request to (re)associate with the specified peer
3700  *	In both the driver-initiated and new connect() call initiated roaming
3734  *	always be %NULL unless the driver supports per-vif TX power
3747  *	channel for the specified duration to complete an off-channel
3751  * @cancel_remain_on_channel: Cancel an on-going remain-on-channel operation.
3759  * @testmode_dump: Implement a test mode dump. The cb->args[2] and up may be
3761  *	return error codes other than -ENOBUFS and -ENOENT will terminate the
3773  * @set_power_mgmt: Configure WLAN power management. A timeout value of -1
3800  *	reject TX/RX mask combinations they cannot support by returning -EINVAL
3806  * @tdls_oper: Perform a high-level TDLS operation (e.g. TDLS link setup).
3843  * @channel_switch: initiate channel-switch procedure (with CSA). Driver is
3872  * @tdls_channel_switch: Start channel-switching with a TDLS peer. The driver
3873  *	is responsible for continually initiating channel-switching operations
3875  * @tdls_cancel_channel_switch: Stop channel-switching with a TDLS peer. Both
3896  * @set_pmk: configure the PMK to be used for offloaded 802.1X 4-Way handshake.
4031 	int	(*assoc)(struct wiphy *wiphy, struct net_device *dev,  member
4260  * enum wiphy_flags - wiphy capability flags
4267  *	by default -- this flag will be set depending on the kernel's default
4294  *	responds to probe-requests in hardware.
4295  * @WIPHY_FLAG_OFFCHAN_TX: Device supports direct off-channel TX.
4296  * @WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL: Device supports remain-on-channel call.
4332  * struct ieee80211_iface_limit - limit on certain interface types
4342  * struct ieee80211_iface_combination - possible interface combination
4351  *    .. code-block:: c
4365  * 2. Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:
4367  *    .. code-block:: c
4381  * 3. Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total.
4385  *    .. code-block:: c
4463  * enum wiphy_wowlan_support_flags - WoWLAN support flags
4465  *	trigger that keeps the device operating as-is and
4475  * @WIPHY_WOWLAN_4WAY_HANDSHAKE: supports wakeup on 4-way handshake failure
4476  * @WIPHY_WOWLAN_RFKILL_RELEASE: supports wakeup on RF-kill release
4500  * struct wiphy_wowlan_support - WoWLAN support data
4507  * @max_nd_match_sets: maximum number of matchsets for net-detect,
4525  * struct wiphy_coalesce_support - coalesce support data
4544  * enum wiphy_vendor_command_flags - validation flags for vendor commands
4557  * enum wiphy_opmode_flag - Station's ht/vht operation mode information flags
4571  * struct sta_opmode_info - Station's ht/vht operation mode information
4585 #define VENDOR_CMD_RAW_DATA ((const struct nla_policy *)(long)(-ENODATA))
4588  * struct wiphy_vendor_command - vendor command definition
4592  *	flags didn't ask for a wdev and non-%NULL otherwise; the data
4595  *	@storage points to cb->args[5], ie. is preserved over the multiple
4618  * struct wiphy_iftype_ext_capab - extended capabilities per interface type
4624  *	802.11-2012 8.4.2.29 for the defined fields.
4636  * struct cfg80211_pmsr_capabilities - cfg80211 peer measurement capabilities
4638  * @report_ap_tsf: can report assoc AP's TSF for radio resource measurement
4641  * @ftm.asap: ASAP-mode is supported
4642  * @ftm.non_asap: non-ASAP-mode is supported
4648  *	(set to -1 if not limited; note that setting this will necessarily
4676  * struct wiphy_iftype_akm_suites - This structure encapsulates supported akm
4691  * struct wiphy - wireless hardware description
4715  *	-1 = fragmentation disabled, only odd values >= 256 used
4716  * @rts_threshold: RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
4721  *	four bits are variable then set it to 00-00-00-00-00-0f. The actual
4728  *	all-zeroes. In this case it is assumed that the device can handle
4730  * @registered: protects ->resume and ->suspend sysfs callbacks against
4763  * @max_scan_ie_len: maximum length of user-controlled IEs device can
4799  * @max_remain_on_channel_duration: Maximum time a remain-on-channel operation
4808  * @ht_capa_mod_mask:  Specify what ht_cap values can be over-ridden.
4809  *	If null, then none can be over-ridden.
4810  * @vht_capa_mod_mask:  Specify what VHT capabilities can be over-ridden.
4811  *	If null, then none can be over-ridden.
4823  *	802.11-2012 8.4.2.29 for the defined fields. These are the default
4870  * @tid_config_support: describes the per-TID config support that the
4967 	/* fields below are read-only, assigned by cfg80211 */
5025 	return read_pnet(&wiphy->_net);  in wiphy_net()
5030 	write_pnet(&wiphy->_net, net);  in wiphy_net_set()
5034  * wiphy_priv - return priv from wiphy
5042 	return &wiphy->priv;  in wiphy_priv()
5046  * priv_to_wiphy - return the wiphy containing the priv
5058  * set_wiphy_dev - set device pointer for wiphy
5065 	wiphy->dev.parent = dev;  in set_wiphy_dev()
5069  * wiphy_dev - get wiphy dev pointer
5076 	return wiphy->dev.parent;  in wiphy_dev()
5080  * wiphy_name - get wiphy name
5087 	return dev_name(&wiphy->dev);  in wiphy_name()
5091  * wiphy_new_nm - create a new wiphy for use with cfg80211
5108  * wiphy_new - create a new wiphy for use with cfg80211
5126  * wiphy_register - register a wiphy with cfg80211
5130  * Return: A non-negative wiphy index or a negative error code.
5135  * wiphy_unregister - deregister a wiphy from cfg80211
5146  * wiphy_free - free wiphy
5159  * struct wireless_dev - wireless device state
5167  * For non-netdev uses, it must also be allocated by the driver
5180  *	the user-set channel definition.
5202  *	netdev and may otherwise be used by driver read-only, will be update
5213  * @is_running: true if this is a non-netdev device that has been started, e.g.
5226  * @disconnect_wk: (private) auto-disconnect work
5227  * @disconnect_bssid: (private) the BSSID to use for auto-disconnect
5261 	/* currently used for IBSS and SME - might be rearranged later */
5323 	if (wdev->netdev)  in wdev_address()
5324 		return wdev->netdev->dev_addr;  in wdev_address()
5325 	return wdev->address;  in wdev_address()
5330 	if (wdev->netdev)  in wdev_running()
5331 		return netif_running(wdev->netdev);  in wdev_running()
5332 	return wdev->is_running;  in wdev_running()
5336  * wdev_priv - return wiphy priv from wireless_dev
5344 	return wiphy_priv(wdev->wiphy);  in wdev_priv()
5354  * ieee80211_channel_equal - compare two struct ieee80211_channel
5364 	return (a->center_freq == b->center_freq &&  in ieee80211_channel_equal()
5365 		a->freq_offset == b->freq_offset);  in ieee80211_channel_equal()
5369  * ieee80211_channel_to_khz - convert ieee80211_channel to frequency in KHz
5376 	return MHZ_TO_KHZ(chan->center_freq) + chan->freq_offset;  in ieee80211_channel_to_khz()
5380  * ieee80211_s1g_channel_width - get allowed channel width from @chan
5390  * ieee80211_channel_to_freq_khz - convert channel number to frequency
5398  * ieee80211_channel_to_frequency - convert channel number to frequency
5410  * ieee80211_freq_khz_to_channel - convert frequency to channel number
5417  * ieee80211_frequency_to_channel - convert frequency to channel number
5428  * ieee80211_get_channel_khz - get channel struct from wiphy for specified
5438  * ieee80211_get_channel - get channel struct from wiphy for specified frequency
5451  * cfg80211_channel_is_psc - Check if the channel is a 6 GHz PSC
5459 	if (chan->band != NL80211_BAND_6GHZ)  in cfg80211_channel_is_psc()
5462 	return ieee80211_frequency_to_channel(chan->center_freq) % 16 == 5;  in cfg80211_channel_is_psc()
5466  * ieee80211_get_response_rate - get basic rate for a given rate
5482  * ieee80211_mandatory_rates - get mandatory rates for a given band
5493  * Radiotap parsing functions -- for controlled injection support
5496  * Documentation in Documentation/networking/radiotap-headers.rst
5516  * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
5578  * ieee80211_get_hdrlen_from_skb - get header length from data
5592  * ieee80211_hdrlen - get header length in bytes from frame control
5593  * @fc: frame control field in little-endian format
5599  * ieee80211_get_mesh_hdrlen - get mesh extension header length
5616  * ieee80211_data_to_8023_exthdr - convert an 802.11 data frame to 802.3
5623  * Return: 0 on success. Non-zero on error.
5630  * ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3
5634  * Return: 0 on success. Non-zero on error.
5643  * ieee80211_amsdu_to_8023s - decode an IEEE 802.11n A-MSDU frame
5645  * Decode an IEEE 802.11 A-MSDU and convert it to a list of 802.3 frames.
5647  * header-less before being passed in here; it is freed in this function.
5649  * @skb: The input A-MSDU frame without any headers.
5664  * cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame
5673  * cfg80211_find_elem_match - match information element and byte array in data
5700  * cfg80211_find_ie_match - match information element and byte array in data
5738 							match_offset - 2 : 0);  in cfg80211_find_ie_match()
5742  * cfg80211_find_elem - find information element in data
5763  * cfg80211_find_ie - find information element in data
5783  * cfg80211_find_ext_elem - find information element with EID Extension in data
5805  * cfg80211_find_ext_ie - find information element with EID Extension in data
5826  * cfg80211_find_vendor_elem - find vendor specific information element in data
5829  * @oui_type: vendor-specific OUI type (must be < 0xff), negative means any
5845  * cfg80211_find_vendor_ie - find vendor specific information element in data
5848  * @oui_type: vendor-specific OUI type (must be < 0xff), negative means any
5868  * cfg80211_send_layer2_update - send layer 2 update frame
5885  * regulatory_hint - driver hint to the wireless core a regulatory domain
5890  *	set this to NULL you should still set rd->alpha2 to some accepted
5905  * an -ENOMEM.
5907  * Return: 0 on success. -ENOMEM.
5912  * regulatory_set_wiphy_regd - set regdom info for self managed drivers
5916  * Set the regulatory domain information for self-managed wiphys, only they
5920  * Return: 0 on success. -EINVAL, -EPERM
5926  * regulatory_set_wiphy_regd_sync_rtnl - set regdom for self-managed drivers
5934  * Return: 0 on success. -EINVAL, -EPERM
5940  * wiphy_apply_custom_regulatory - apply a custom driver regulatory domain
5958  * freq_reg_info - get regulatory information for the given frequency
5970  * value will be -ERANGE if we determine the given center_freq does not even
5972  * See freq_in_rule_band() for our current definition of a band -- this is
5979  * reg_initiator_name - map regulatory request initiator enum to name
5988  * regulatory_pre_cac_allowed - check if pre-CAC allowed in the current regdom
5989  * @wiphy: wiphy for which pre-CAC capability is checked.
5991  * Pre-CAC is allowed only in some regdomains (notable ETSI).
6001  * reg_query_regdb_wmm -  Query internal regulatory db for wmm rule
6002  * Regulatory self-managed driver can use it to proactively
6008  * Self-managed wireless drivers can use this function to  query
6013  * an -ENODATA.
6015  * Return: 0 on success. -ENODATA.
6026  * cfg80211_scan_done - notify that scan finished
6035  * cfg80211_sched_scan_results - notify that new scan results are available
6043  * cfg80211_sched_scan_stopped - notify that the scheduled scan has stopped
6055  * cfg80211_sched_scan_stopped_rtnl - notify that the scheduled scan has stopped
6068  * cfg80211_inform_bss_frame_data - inform cfg80211 of a received BSS frame
6119  * cfg80211_gen_new_bssid - generate a nontransmitted BSSID for multi-BSSID
6129 	u64 mask = GENMASK_ULL(max_bssid - 1, 0);  in cfg80211_gen_new_bssid()
6140  * cfg80211_is_element_inherited - returns if element ID should be inherited
6148  * cfg80211_merge_profile - merges a MBSSID profile if it is split between IEs
6162  * enum cfg80211_bss_frame_type - frame type that the BSS data came from
6175  * cfg80211_inform_bss_data - inform cfg80211 of a new BSS
6242  * cfg80211_get_bss - get a BSS reference
6268  * cfg80211_ref_bss - reference BSS struct
6277  * cfg80211_put_bss - unref BSS struct
6286  * cfg80211_unlink_bss - unlink BSS from internal data structures
6298  * cfg80211_bss_iter - iterate all BSS entries
6320 	switch (chandef->width) {  in cfg80211_chandef_to_scan_width()
6331  * cfg80211_rx_mlme_mgmt - notification of processed MLME management frame
6340  * After being asked to associate via cfg80211_ops::assoc() the driver must
6352  * cfg80211_auth_timeout - notification of timed out authentication
6362  * cfg80211_rx_assoc_resp - notification of processed association response
6373  * After being asked to associate via cfg80211_ops::assoc() the driver must
6385  * cfg80211_assoc_timeout - notification of timed out association
6394  * cfg80211_abandon_assoc - notify cfg80211 of abandoned association attempt
6398  * Call this whenever - for reasons reported through other API, like deauth RX,
6405  * cfg80211_tx_mlme_mgmt - notification of transmitted deauth/disassoc frame
6418  * cfg80211_rx_unprot_mlme_mgmt - notification of unprotected mlme mgmt frame
6435  * cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)
6439  * @key_id: Key identifier (0..3). Can be -1 if missing.
6444  * received frame. This matches with MLME-MICHAELMICFAILURE.indication()
6452  * cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS
6463  * with the locally generated beacon -- this guarantees that there is
6470  * cfg80211_notify_new_peer_candidate - notify cfg80211 of a new mesh peer
6502  * wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state
6509  * wiphy_rfkill_start_polling - start polling rfkill
6515  * wiphy_rfkill_stop_polling - stop polling rfkill
6526  * (typically closed-source) userspace and firmware, using nl80211 as
6536  * "normal" functionality that higher-level userspace like connection
6556  * cfg80211_vendor_cmd_alloc_reply_skb - allocate vendor command reply
6561  * This function allocates and pre-fills an skb for a reply to
6565  * The returned skb is pre-filled with some identifying data in
6576  * Return: An allocated and pre-filled skb. %NULL if any errors happen.
6586  * cfg80211_vendor_cmd_reply - send the reply skb
6609  * cfg80211_vendor_event_alloc - allocate vendor-specific event skb
6617  * This function allocates and pre-fills an skb for an event on the
6618  * vendor-specific multicast group.
6627  * Return: An allocated and pre-filled skb. %NULL if any errors happen.
6639  * cfg80211_vendor_event_alloc_ucast - alloc unicast vendor-specific event skb
6648  * This function allocates and pre-fills an skb for an event to send to
6660  * Return: An allocated and pre-filled skb. %NULL if any errors happen.
6674  * cfg80211_vendor_event - send the event
6691  * interact with driver-specific tools to aid, for instance,
6699  * cfg80211_testmode_alloc_reply_skb - allocate testmode reply
6704  * This function allocates and pre-fills an skb for a reply to
6708  * The returned skb is pre-filled with the wiphy index and set up in
6719  * Return: An allocated and pre-filled skb. %NULL if any errors happen.
6729  * cfg80211_testmode_reply - send the reply skb
6746  * cfg80211_testmode_alloc_event_skb - allocate testmode event
6752  * This function allocates and pre-fills an skb for an event on the
6764  * Return: An allocated and pre-filled skb. %NULL if any errors happen.
6770 					  NL80211_ATTR_TESTDATA, 0, -1,  in cfg80211_testmode_alloc_event_skb()
6775  * cfg80211_testmode_event - send the event
6797  * struct cfg80211_fils_resp_params - FILS connection response params
6821  * struct cfg80211_connect_resp_params - Connection response params
6826  *	from the AP) instead of an explicit rejection by the AP, -1 is used to
6862  * cfg80211_connect_done - notify cfg80211 of connection result
6880  * cfg80211_connect_bss - notify cfg80211 of connection result
6893  * @resp_ie_len: assoc response IEs length
6898  *	from the AP) instead of an explicit rejection by the AP, -1 is used to
6940  * cfg80211_connect_result - notify cfg80211 of connection result
6947  * @resp_ie_len: assoc response IEs length
6971  * cfg80211_connect_timeout - notify cfg80211 of connection timeout
6993 	cfg80211_connect_bss(dev, bssid, NULL, req_ie, req_ie_len, NULL, 0, -1,  in cfg80211_connect_timeout()
6998  * struct cfg80211_roam_info - driver initiated roaming information
7006  * @resp_ie_len: assoc response IEs length
7021  * cfg80211_roamed - notify cfg80211 of roaming
7034  * rdev->event_work. In case of any failures, the reference is released
7042  * cfg80211_port_authorized - notify cfg80211 of successful security association
7059  * cfg80211_disconnected - notify cfg80211 that connection was dropped
7076  * cfg80211_ready_on_channel - notification of remain_on_channel start
7089  * cfg80211_remain_on_channel_expired - remain_on_channel duration expired
7100  * cfg80211_tx_mgmt_expired - tx_mgmt duration expired
7110  * cfg80211_sinfo_alloc_tid_stats - allocate per-tid statistics.
7118  * cfg80211_sinfo_release_content - release contents of station info
7121  * Releases any potentially allocated sub-information of the station
7127 	kfree(sinfo->pertid);  in cfg80211_sinfo_release_content()
7131  * cfg80211_new_sta - notify userspace about station
7142  * cfg80211_del_sta_sinfo - notify userspace about deletion of a station
7152  * cfg80211_del_sta - notify userspace about deletion of a station
7165  * cfg80211_conn_failed - connection request failed notification
7184  * cfg80211_rx_mgmt_khz - notification of received, unprocessed management frame
7204  * cfg80211_rx_mgmt - notification of received, unprocessed management frame
7229  * cfg80211_mgmt_tx_status - notification of TX status for management frame
7245  * cfg80211_control_port_tx_status - notification of TX status for control
7263  * cfg80211_rx_control_port - notification about a received control port frame
7266  *	is 802.3 formatted (with 802.3 header).  The skb can be non-linear.
7269  *	skb->protocol is set appropriately.
7285  * cfg80211_cqm_rssi_notify - connection quality monitoring rssi event
7299  * cfg80211_cqm_pktloss_notify - notify userspace about packetloss to peer
7302  * @num_packets: how many packets were lost -- should be a fixed threshold
7311  * cfg80211_cqm_txe_notify - TX error rate event
7326  * cfg80211_cqm_beacon_loss_notify - beacon loss event
7335  * cfg80211_radar_event - radar detection event
7346  * cfg80211_sta_opmode_change_notify - STA's ht/vht operation mode change event
7360  * cfg80211_cac_event - Channel availability check (CAC) event
7368  * also by full-MAC drivers.
7376  * cfg80211_gtk_rekey_notify - notify userspace about driver rekeying
7386  * cfg80211_pmksa_candidate_notify - notify about PMKSA caching candidate
7390  * @preauth: Whether AP advertises support for RSN pre-authentication
7397  * cfg80211_rx_spurious_frame - inform userspace about a spurious frame
7412  * cfg80211_rx_unexpected_4addr_frame - inform about unexpected WDS frame
7428  * cfg80211_probe_status - notify userspace about probe status
7442  * cfg80211_report_obss_beacon_khz - report beacon from other APs
7457  * cfg80211_report_obss_beacon - report beacon from other APs
7477  * cfg80211_reg_can_beacon - check if beaconing is allowed
7490  * cfg80211_reg_can_beacon_relax - check if beaconing is allowed with relaxation
7497  * also checks if IR-relaxation conditions apply, to allow beaconing under
7507  * cfg80211_ch_switch_notify - update wdev channel and notify userspace
7518  * cfg80211_ch_switch_started_notify - notify channel switch start
7532  * ieee80211_operating_class_to_band - convert operating class to band
7543  * ieee80211_chandef_to_operating_class - convert chandef to operation class
7554  * ieee80211_chandef_to_khz - convert chandef to frequency in KHz
7563 	return MHZ_TO_KHZ(chandef->center_freq1) + chandef->freq1_offset;  in ieee80211_chandef_to_khz()
7567  * cfg80211_tdls_oper_request - request userspace to perform TDLS operation
7586  * cfg80211_calculate_bitrate - calculate actual bitrate (in 100Kbps units)
7594  * cfg80211_unregister_wdev - remove the given wdev
7610  * struct cfg80211_ft_event_params - FT Information Elements
7626  * cfg80211_ft_event - notify userspace about FT IE and RIC IE
7634  * cfg80211_get_p2p_attr - find and copy a P2P attribute from IE buffer
7645  * Return: A negative error code (-%EILSEQ or -%ENOENT) if the data is
7654  * ieee80211_ie_split_ric - split an IE buffer according to ordering (with RIC)
7659  *	EID in the list is a sub-element of the EXTENSION IE.
7669  * It assumes that the given IE buffer is well-formed, this
7686  * ieee80211_ie_split - split an IE buffer according to ordering
7691  *	EID in the list is a sub-element of the EXTENSION IE.
7699  * It assumes that the given IE buffer is well-formed, this
7717  * cfg80211_report_wowlan_wakeup - report wakeup from WoWLAN
7732  * cfg80211_crit_proto_stopped() - indicate critical protocol stopped by driver.
7744  * ieee80211_get_num_supported_channels - get number of channels device has
7752  * cfg80211_check_combinations - check interface combinations
7765  * cfg80211_iter_combinations - iterate over matching combinations
7783  * cfg80211_stop_iface - trigger interface disconnection
7798  * cfg80211_shutdown_all_interfaces - shut down all interfaces for a wiphy
7802  * calling dev_close() (and treating non-netdev interfaces as needed).
7812  * wiphy_ext_feature_set - set the extended feature flag
7825 	ft_byte = &wiphy->ext_features[ftidx / 8];  in wiphy_ext_feature_set()
7830  * wiphy_ext_feature_isset - check the extended feature flag
7844 	ft_byte = wiphy->ext_features[ftidx / 8];  in wiphy_ext_feature_isset()
7849  * cfg80211_free_nan_func - free NAN function
7857  * struct cfg80211_nan_match_params - NAN match parameters
7881  * cfg80211_nan_match - report a match for a NAN function.
7894  * cfg80211_nan_func_terminated - notify about NAN function termination.
7913  * cfg80211_external_auth_request - userspace request for authentication
7924  * cfg80211_pmsr_report - report peer measurement result data
7936  * cfg80211_pmsr_complete - report peer measurement completed
7949  * cfg80211_iftype_allowed - check whether the interface can be allowed
7968 	dev_printk(level, &(wiphy)->dev, format, ##args)
7970 	dev_emerg(&(wiphy)->dev, format, ##args)
7972 	dev_alert(&(wiphy)->dev, format, ##args)
7974 	dev_crit(&(wiphy)->dev, format, ##args)
7976 	dev_err(&(wiphy)->dev, format, ##args)
7978 	dev_warn(&(wiphy)->dev, format, ##args)
7980 	dev_notice(&(wiphy)->dev, format, ##args)
7982 	dev_info(&(wiphy)->dev, format, ##args)
7985 	dev_err_ratelimited(&(wiphy)->dev, format, ##args)
7987 	dev_warn_ratelimited(&(wiphy)->dev, format, ##args)
7993 	dev_dbg(&(wiphy)->dev, format, ##args)
8015  * cfg80211_update_owe_info_event - Notify the peer's OWE info to user space
8025  * cfg80211_bss_flush - resets all the scan entries