include/net/cfg80211.h

6  * Copyright 2006-2010	Johannes Berg <johannes@sipsolutions.net>
65  * enum ieee80211_band - supported frequency bands
71  * @IEEE80211_BAND_5GHZ: around 5GHz band (4.9-5.7)
83  * enum ieee80211_channel_flags - channel flags
110  * struct ieee80211_channel - channel definition
116  * @hw_value: hardware-specific value for the channel
142  * enum ieee80211_rate_flags - rate flags
152  *	when used with 802.11a (on the 5 GHz band); filled by the
155  *	when used with 802.11b (on the 2.4 GHz band); filled by the
158  *	when used with 802.11g (on the 2.4 GHz band); filled by the
171  * struct ieee80211_rate - bitrate definition
178  * @flags: rate-specific flags
191  * struct ieee80211_sta_ht_cap - STA's HT capabilities
198  * @ampdu_factor: Maximum A-MPDU length factor
199  * @ampdu_density: Minimum A-MPDU spacing
211  * struct ieee80211_supported_band - frequency band definition
255  * struct vif_params - describes virtual interface parameters
256  * @use_4addr: use 4-address frames
263  * struct key_params - key information
284  * enum survey_info_flags - survey information flags
286  * @SURVEY_INFO_NOISE_DBM: noise (in dBm) was filled in
288  * @SURVEY_INFO_CHANNEL_TIME: channel active time (in ms) was filled in
289  * @SURVEY_INFO_CHANNEL_TIME_BUSY: channel busy time was filled in
290  * @SURVEY_INFO_CHANNEL_TIME_EXT_BUSY: extension channel busy time was filled in
291  * @SURVEY_INFO_CHANNEL_TIME_RX: channel receive time was filled in
292  * @SURVEY_INFO_CHANNEL_TIME_TX: channel transmit time was filled in
295  * it has filled in during the get_survey().
308  * struct survey_info - channel survey response
311  * @filled: bitflag of flags from &enum survey_info_flags
320  * Used by dump_survey() to report back per-channel survey information.
332 	u32 filled;  member
337  * struct cfg80211_crypto_settings - Crypto settings
367  * struct beacon_parameters - beacon parameters
418  * enum plink_action - actions to perform in mesh peers
431  * enum station_parameters_apply_mask - station parameter values to apply
434  * Not all station parameters have in-band "no change" signalling,
442  * struct station_parameters - station parameters
454  * @listen_interval: listen interval or -1 for no change
483  * enum station_info_flags - station information flags
486  * it has filled in during get_station() or dump_station().
488  * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
489  * @STATION_INFO_RX_BYTES: @rx_bytes filled
490  * @STATION_INFO_TX_BYTES: @tx_bytes filled
491  * @STATION_INFO_LLID: @llid filled
492  * @STATION_INFO_PLID: @plid filled
493  * @STATION_INFO_PLINK_STATE: @plink_state filled
494  * @STATION_INFO_SIGNAL: @signal filled
495  * @STATION_INFO_TX_BITRATE: @txrate fields are filled
497  * @STATION_INFO_RX_PACKETS: @rx_packets filled
498  * @STATION_INFO_TX_PACKETS: @tx_packets filled
499  * @STATION_INFO_TX_RETRIES: @tx_retries filled
500  * @STATION_INFO_TX_FAILED: @tx_failed filled
501  * @STATION_INFO_RX_DROP_MISC: @rx_dropped_misc filled
502  * @STATION_INFO_SIGNAL_AVG: @signal_avg filled
503  * @STATION_INFO_RX_BITRATE: @rxrate fields are filled
504  * @STATION_INFO_BSS_PARAM: @bss_param filled
505  * @STATION_INFO_CONNECTED_TIME: @connected_time filled
506  * @STATION_INFO_ASSOC_REQ_IES: @assoc_req_ies filled
507  * @STATION_INFO_STA_FLAGS: @sta_flags filled
508  * @STATION_INFO_BEACON_LOSS_COUNT: @beacon_loss_count filled
534  * enum station_info_rate_flags - bitrate info flags
539  * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
550  * struct rate_info - bitrate information
565  * enum station_info_rate_flags - bitrate info flags
581  * struct sta_bss_parameters - BSS parameters for the attached station
596  * struct station_info - station information
598  * Station information filled by driver for get_station() and dump_station.
600  * @filled: bitflag of flags from &enum station_info_flags
616  * @rx_dropped_misc:  Dropped for un-specified reason.
631 	u32 filled;  member
665  * enum monitor_flags - monitor flags
685  * enum mpath_info_flags -  mesh path information flags
687  * Used by the driver to indicate which info in &struct mpath_info it has filled
690  * @MPATH_INFO_FRAME_QLEN: @frame_qlen filled
691  * @MPATH_INFO_SN: @sn filled
692  * @MPATH_INFO_METRIC: @metric filled
693  * @MPATH_INFO_EXPTIME: @exptime filled
694  * @MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
695  * @MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
696  * @MPATH_INFO_FLAGS: @flags filled
709  * struct mpath_info - mesh path information
711  * Mesh path information filled by driver for get_mpath() and dump_mpath().
713  * @filled: bitfield of flags from &enum mpath_info_flags
727 	u32 filled;  member
740  * struct bss_parameters - BSS parameters
745  *	(0 = no, 1 = yes, -1 = do not change)
747  *	(0 = no, 1 = yes, -1 = do not change)
749  *	(0 = no, 1 = yes, -1 = do not change)
755  * 	(u16 = opmode, -1 = do not change)
768  * struct mesh_config - 802.11s mesh configuration
802  * struct mesh_setup - 802.11s mesh setup configuration
828  * struct ieee80211_txq_params - TX queue parameters
831  * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
833  * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
858  * well-formed, and will not exceed the maximum length the driver advertised
872  * struct cfg80211_ssid - SSID description
882  * struct cfg80211_scan_request - scan request description
916  * struct cfg80211_match_set - sets of attributes to match
925  * struct cfg80211_sched_scan_request - scheduled scan request description
961  * enum cfg80211_signal_type - signal type
974  * struct cfg80211_bss - BSS description
985  *	is no guarantee that these are well-formed!); this is a pointer to
995  * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
1018  * ieee80211_bss_get_ie - find IE with given ID
1027  * struct cfg80211_auth_request - Authentication request data
1055  * enum cfg80211_assoc_req_flags - Over-ride default behaviour in association.
1064  * struct cfg80211_assoc_request - (Re)Association request data
1075  * @ht_capa:  HT Capabilities over-rides.  Values set in ht_capa_mask
1076  *   will be used in ht_capa.  Un-supported values will be ignored.
1091  * struct cfg80211_deauth_request - Deauthentication request data
1112  * struct cfg80211_disassoc_request - Disassociation request data
1133  * struct cfg80211_ibss_params - IBSS parameters
1138  * @ssid: The SSID, will always be non-null.
1139  * @ssid_len: The length of the SSID, will always be non-zero.
1144  * @channel_fixed: The channel should be fixed -- do not search for
1152  * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
1169  * struct cfg80211_connect_params - Connection parameters
1174  * @channel: The channel to use or %NULL if not specified (auto-select based
1176  * @bssid: The AP BSSID or %NULL if not specified (auto-select based on scan
1183  * @privacy: indicates whether privacy-enabled APs should be used
1189  * @ht_capa:  HT Capabilities over-rides.  Values set in ht_capa_mask
1190  *   will be used in ht_capa.  Un-supported values will be ignored.
1211  * enum wiphy_params_flags - set_wiphy_params bitfield values
1212  * @WIPHY_PARAM_RETRY_SHORT: wiphy->retry_short has changed
1213  * @WIPHY_PARAM_RETRY_LONG: wiphy->retry_long has changed
1214  * @WIPHY_PARAM_FRAG_THRESHOLD: wiphy->frag_threshold has changed
1215  * @WIPHY_PARAM_RTS_THRESHOLD: wiphy->rts_threshold has changed
1227  * cfg80211_bitrate_mask - masks for bitrate control
1237  * struct cfg80211_pmksa - PMK Security Association
1251  * struct cfg80211_wowlan_trig_pkt_pattern - packet pattern
1266  * struct cfg80211_wowlan - Wake on Wireless-LAN support info
1269  * @any: wake up on any activity -- special trigger if device continues
1277  * @four_way_handshake: wake up on 4-way handshake
1289  * struct cfg80211_gtk_rekey_data - rekey data
1301  * struct cfg80211_ops - backend description for wireless configuration
1314  *	be %NULL or contain the enabled Wake-on-Wireless triggers that are
1335  *	not possible to retrieve the key, -ENOENT if it doesn't exist.
1338  *	and @key_index, return -ENOENT if the key doesn't exist.
1357  *	might come to the driver in invalid combinations -- make sure to check
1359  *	not checked in station mode -- drivers need to reject (or ignore) them
1362  * @dump_station: dump station callback -- resume dump at index @idx
1368  * @dump_mpath: dump mesh path callback -- resume dump at index @idx
1383  *	may support multi-channel operation (by channel hopping) so cfg80211
1389  *	device implements channel hopping for multi-channel virtual interfaces.
1430  *	channel for the specified duration to complete an off-channel
1434  * @cancel_remain_on_channel: Cancel an on-going remain-on-channel operation.
1442  * @testmode_dump: Implement a test mode dump. The cb->args[2] and up may be
1444  *	return error codes other than -ENOBUFS and -ENOENT will terminate the
1456  * @set_power_mgmt: Configure WLAN power management. A timeout value of -1
1470  *	reject TX/RX mask combinations they cannot support by returning -EINVAL
1480  * @tdls_oper: Perform a high-level TDLS operation (e.g. TDLS link setup).
1692  * enum wiphy_flags - wiphy capability flags
1722  *	by default -- this flag will be set depending on the kernel's default
1749  *	responds to probe-requests in hardware.
1750  * @WIPHY_FLAG_OFFCHAN_TX: Device supports direct off-channel TX.
1751  * @WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL: Device supports remain-on-channel call.
1778  * struct ieee80211_iface_limit - limit on certain interface types
1788  * struct ieee80211_iface_combination - possible interface combination
1814  * Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:
1828  * Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total.
1860  * enum wiphy_wowlan_support_flags - WoWLAN support flags
1862  *	trigger that keeps the device operating as-is and
1872  * @WIPHY_WOWLAN_4WAY_HANDSHAKE: supports wakeup on 4-way handshake failure
1873  * @WIPHY_WOWLAN_RFKILL_RELEASE: supports wakeup on RF-kill release
1887  * struct wiphy_wowlan_support - WoWLAN support data
1902  * struct wiphy - wireless hardware description
1916  *	-1 = fragmentation disabled, only odd values >= 256 used
1917  * @rts_threshold: RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
1929  *	all-zeroes. In this case it is assumed that the device can handle
1931  * @registered: protects ->resume and ->suspend sysfs callbacks against
1957  * @max_scan_ie_len: maximum length of user-controlled IEs device can
1987  * @max_remain_on_channel_duration: Maximum time a remain-on-channel operation
1993  * @ht_capa_mod_mask:  Specify what ht_cap values can be over-ridden.
1994  *	If null, then none can be over-ridden.
2070 	/* fields below are read-only, assigned by cfg80211 */
2078 	/* protects ->resume, ->suspend sysfs callbacks against unregister hw */
2100 	return read_pnet(&wiphy->_net);  in wiphy_net()
2105 	write_pnet(&wiphy->_net, net);  in wiphy_net_set()
2109  * wiphy_priv - return priv from wiphy
2116 	return &wiphy->priv;  in wiphy_priv()
2120  * priv_to_wiphy - return the wiphy containing the priv
2131  * set_wiphy_dev - set device pointer for wiphy
2138 	wiphy->dev.parent = dev;  in set_wiphy_dev()
2142  * wiphy_dev - get wiphy dev pointer
2148 	return wiphy->dev.parent;  in wiphy_dev()
2152  * wiphy_name - get wiphy name
2158 	return dev_name(&wiphy->dev);  in wiphy_name()
2162  * wiphy_new - create a new wiphy for use with cfg80211
2176  * wiphy_register - register a wiphy with cfg80211
2180  * Returns a non-negative wiphy index or a negative error code.
2185  * wiphy_unregister - deregister a wiphy from cfg80211
2196  * wiphy_free - free wiphy
2210  * struct wireless_dev - wireless per-netdev state
2223  *	user-set AP, monitor and WDS channels for wireless extensions
2232  *	netdev and may otherwise be used by driver read-only, will be update
2258 	/* currently used for IBSS and SME - might be rearranged later */
2301  * wdev_priv - return wiphy priv from wireless_dev
2308 	return wiphy_priv(wdev->wiphy);  in wdev_priv()
2318  * ieee80211_channel_to_frequency - convert channel number to frequency
2325  * ieee80211_frequency_to_channel - convert frequency to channel number
2340  * ieee80211_get_channel - get channel struct from wiphy for specified frequency
2351  * ieee80211_get_response_rate - get basic rate for a given rate
2367  * Radiotap parsing functions -- for controlled injection support
2370  * Documentation in Documentation/networking/radiotap-headers.txt
2390  * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
2451  * ieee80211_get_hdrlen_from_skb - get header length from data
2463  * ieee80211_hdrlen - get header length in bytes from frame control
2464  * @fc: frame control field in little-endian format
2477  * ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3
2486  * ieee80211_data_from_8023 - convert an 802.3 frame to 802.11
2497  * ieee80211_amsdu_to_8023s - decode an IEEE 802.11n A-MSDU frame
2499  * Decode an IEEE 802.11n A-MSDU frame and convert it to a list of
2503  * @skb: The input IEEE 802.11n A-MSDU frame.
2517  * cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame
2523  * cfg80211_find_ie - find information element in data
2539  * cfg80211_find_vendor_ie - find vendor specific information element in data
2542  * @oui_type: vendor-specific OUI type
2563  * regulatory_hint - driver hint to the wireless core a regulatory domain
2568  * 	set this to NULL you should still set rd->alpha2 to some accepted
2583  * an -ENOMEM.
2588  * wiphy_apply_custom_regulatory - apply a custom driver regulatory domain
2604  * freq_reg_info - get regulatory information for the given frequency
2619  * apply to the given center_freq otherwise it returns non-zero. It will
2620  * also return -ERANGE if we determine the given center_freq does not even have
2622  * freq_in_rule_band() for our current definition of a band -- this is purely
2636  * cfg80211_scan_done - notify that scan finished
2645  * cfg80211_sched_scan_results - notify that new scan results are available
2652  * cfg80211_sched_scan_stopped - notify that the scheduled scan has stopped
2663  * cfg80211_inform_bss_frame - inform cfg80211 of a received BSS frame
2684  * cfg80211_inform_bss - inform cfg80211 of a new BSS
2731  * cfg80211_unlink_bss - unlink BSS from internal data structures
2743  * cfg80211_send_rx_auth - notification of processed authentication
2756  * cfg80211_send_auth_timeout - notification of timed out authentication
2765  * __cfg80211_auth_canceled - notify cfg80211 that authentication was canceled
2777  * cfg80211_send_rx_assoc - notification of processed association
2790  * cfg80211_send_assoc_timeout - notification of timed out association
2799  * cfg80211_send_deauth - notification of processed deauthentication
2811  * __cfg80211_send_deauth - notification of processed deauthentication
2821  * cfg80211_send_disassoc - notification of processed disassociation
2833  * __cfg80211_send_disassoc - notification of processed disassociation
2844  * cfg80211_send_unprot_deauth - notification of unprotected deauthentication
2857  * cfg80211_send_unprot_disassoc - notification of unprotected disassociation
2870  * cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)
2874  * @key_id: Key identifier (0..3). Can be -1 if missing.
2879  * received frame. This matches with MLME-MICHAELMICFAILURE.indication()
2887  * cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS
2897  * with the locally generated beacon -- this guarantees that there is
2903  * cfg80211_notify_new_candidate - notify cfg80211 of a new mesh peer candidate
2933  * wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state
2940  * wiphy_rfkill_start_polling - start polling rfkill
2946  * wiphy_rfkill_stop_polling - stop polling rfkill
2956  * interact with driver-specific tools to aid, for instance,
2964  * cfg80211_testmode_alloc_reply_skb - allocate testmode reply
2969  * This function allocates and pre-fills an skb for a reply to
2973  * The returned skb (or %NULL if any errors happen) is pre-filled
2988  * cfg80211_testmode_reply - send the reply skb
3001  * cfg80211_testmode_alloc_event_skb - allocate testmode event
3007  * This function allocates and pre-fills an skb for an event on the
3023  * cfg80211_testmode_event - send the event
3042  * cfg80211_connect_result - notify cfg80211 of connection result
3064  * cfg80211_roamed - notify cfg80211 of roaming
3085  * cfg80211_roamed_bss - notify cfg80211 of roaming
3102  * rdev->event_work. In case of any failures, the reference is released
3111  * cfg80211_disconnected - notify cfg80211 that connection was dropped
3126  * cfg80211_ready_on_channel - notification of remain_on_channel start
3141  * cfg80211_remain_on_channel_expired - remain_on_channel duration expired
3156  * cfg80211_new_sta - notify userspace about station
3167  * cfg80211_del_sta - notify userspace about deletion of a station
3176  * cfg80211_rx_mgmt - notification of received, unprocessed management frame
3195  * cfg80211_mgmt_tx_status - notification of TX status for management frame
3212  * cfg80211_cqm_rssi_notify - connection quality monitoring rssi event
3225  * cfg80211_cqm_pktloss_notify - notify userspace about packetloss to peer
3228  * @num_packets: how many packets were lost -- should be a fixed threshold
3237  * cfg80211_gtk_rekey_notify - notify userspace about driver rekeying
3247  * cfg80211_pmksa_candidate_notify - notify about PMKSA caching candidate
3251  * @preauth: Whether AP advertises support for RSN pre-authentication
3258  * cfg80211_rx_spurious_frame - inform userspace about a spurious frame
3273  * cfg80211_rx_unexpected_4addr_frame - inform about unexpected WDS frame
3289  * cfg80211_probe_status - notify userspace about probe status
3292  * @cookie: the cookie filled in @probe_client previously
3300  * cfg80211_report_obss_beacon - report beacon from other APs
3316  * cfg80211_can_beacon_sec_chan - test if ht40 on extension channel can be used
3330 	dev_printk(level, &(wiphy)->dev, format, ##args)
3332 	dev_emerg(&(wiphy)->dev, format, ##args)
3334 	dev_alert(&(wiphy)->dev, format, ##args)
3336 	dev_crit(&(wiphy)->dev, format, ##args)
3338 	dev_err(&(wiphy)->dev, format, ##args)
3340 	dev_warn(&(wiphy)->dev, format, ##args)
3342 	dev_notice(&(wiphy)->dev, format, ##args)
3344 	dev_info(&(wiphy)->dev, format, ##args)
3350 	dev_dbg(&(wiphy)->dev, format, ##args)