Introduction

    cfg80211 is the configuration API for 802.11 devices in Linux. It bridges userspace and drivers, and offers some utility functionality associated with 802.11. cfg80211 must, directly or indirectly via mac80211, be used by all modern wireless drivers in Linux, so that they offer a consistent API through nl80211. For backward compatibility, cfg80211 also offers wireless extensions to userspace, but hides them from drivers completely.

    Additionally, cfg80211 contains code to help enforce regulatory spectrum use restrictions.


Device registration

    In order for a driver to use cfg80211, it must register the hardware device with cfg80211. This happens through a number of hardware capability structs described below.

    The fundamental structure for each device is the 'wiphy', of which each instance describes a physical wireless device connected to the system. Each such wiphy can have zero, one, or many virtual interfaces associated with it, which need to be identified as such by pointing the network interface's ieee80211_ptr pointer to a struct wireless_dev which further describes the wireless part of the interface, normally this struct is embedded in the network interface's private data area. Drivers can optionally allow creating or destroying virtual interfaces on the fly, but without at least one or the ability to create some the wireless device isn't useful.

    Each wiphy structure contains device capability information, and also has a pointer to the various operations the driver offers. The definitions and structures here describe these capabilities in detail.


enum ieee80211_band

enum ieee80211_band {
IEEE80211_BAND_2GHZ,
IEEE80211_BAND_5GHZ,
IEEE80211_NUM_BANDS
};

Constants

IEEE80211_BAND_2GHZ
2.4GHz ISM band
IEEE80211_BAND_5GHZ
around 5GHz band (4.9-5.7)
IEEE80211_NUM_BANDS
number of defined bands

Device registration

The bands are assigned this way because the supported bitrates differ in these bands.


enum ieee80211_channel_flags

enum ieee80211_channel_flags {
IEEE80211_CHAN_DISABLED,
IEEE80211_CHAN_PASSIVE_SCAN,
IEEE80211_CHAN_NO_IBSS,
IEEE80211_CHAN_RADAR,
IEEE80211_CHAN_NO_HT40PLUS,
IEEE80211_CHAN_NO_HT40MINUS
};

Constants

IEEE80211_CHAN_DISABLED
This channel is disabled.
IEEE80211_CHAN_PASSIVE_SCAN
Only passive scanning is permitted on this channel.
IEEE80211_CHAN_NO_IBSS
IBSS is not allowed on this channel.
IEEE80211_CHAN_RADAR
Radar detection is required on this channel.
IEEE80211_CHAN_NO_HT40PLUS
extension channel above this channel is not permitted.
IEEE80211_CHAN_NO_HT40MINUS
extension channel below this channel is not permitted.

Description

Channel flags set by the regulatory control code.


struct ieee80211_channel - channel definition

struct ieee80211_channel {
    enum ieee80211_band band;
    u16 center_freq;
    u16 hw_value;
    u32 flags;
    int max_antenna_gain;
    int max_power;
    int max_reg_power;
    bool beacon_found;
    u32 orig_flags;
    int orig_mag;
    int orig_mpwr;
};

Members

band
band this channel belongs to.
center_freq
center frequency in MHz
hw_value
hardware-specific value for the channel
flags
channel flags from enum ieee80211_channel_flags.
max_antenna_gain
maximum antenna gain in dBi
max_power
maximum transmission power (in dBm)
max_reg_power
maximum regulatory transmission power (in dBm)
beacon_found
helper to regulatory code to indicate when a beacon has been found on this channel. Use regulatory_hint_found_beacon to enable this, this is useful only on 5 GHz band.
orig_flags
channel flags at registration time, used by regulatory code to support devices with additional restrictions
orig_mag
internal use
orig_mpwr
internal use

Description

This structure describes a single channel for use with cfg80211.


enum ieee80211_rate_flags

enum ieee80211_rate_flags {
IEEE80211_RATE_SHORT_PREAMBLE,
IEEE80211_RATE_MANDATORY_A,
IEEE80211_RATE_MANDATORY_B,
IEEE80211_RATE_MANDATORY_G,
IEEE80211_RATE_ERP_G
};

Constants

IEEE80211_RATE_SHORT_PREAMBLE
Hardware can send with short preamble on this bitrate; only relevant in 2.4GHz band and with CCK rates.
IEEE80211_RATE_MANDATORY_A
This bitrate is a mandatory rate when used with 802.11a (on the 5 GHz band); filled by the core code when registering the wiphy.
IEEE80211_RATE_MANDATORY_B
This bitrate is a mandatory rate when used with 802.11b (on the 2.4 GHz band); filled by the core code when registering the wiphy.
IEEE80211_RATE_MANDATORY_G
This bitrate is a mandatory rate when used with 802.11g (on the 2.4 GHz band); filled by the core code when registering the wiphy.
IEEE80211_RATE_ERP_G
This is an ERP rate in 802.11g mode.

Description

Hardware/specification flags for rates. These are structured in a way that allows using the same bitrate structure for different bands/PHY modes.


struct ieee80211_rate - bitrate definition

struct ieee80211_rate {
    u32 flags;
    u16 bitrate;
    u16 hw_value;
    u16 hw_value_short;
};

Members

flags
rate-specific flags
bitrate
bitrate in units of 100 Kbps
hw_value
driver/hardware value for this rate
hw_value_short
driver/hardware value for this rate when short preamble is used

Description

This structure describes a bitrate that an 802.11 PHY can operate with. The two values hw_value and hw_value_short are only for driver use when pointers to this structure are passed around.


struct ieee80211_sta_ht_cap - STA's HT capabilities

struct ieee80211_sta_ht_cap {
    u16 cap;
    bool ht_supported;
    u8 ampdu_factor;
    u8 ampdu_density;
    struct ieee80211_mcs_info mcs;
};

Members

cap
HT capabilities map as described in 802.11n spec
ht_supported
is HT supported by the STA
ampdu_factor
Maximum A-MPDU length factor
ampdu_density
Minimum A-MPDU spacing
mcs
Supported MCS rates

Description

This structure describes most essential parameters needed to describe 802.11n HT capabilities for an STA.


struct ieee80211_supported_band - frequency band definition

struct ieee80211_supported_band {
    struct ieee80211_channel * channels;
    struct ieee80211_rate * bitrates;
    enum ieee80211_band band;
    int n_channels;
    int n_bitrates;
    struct ieee80211_sta_ht_cap ht_cap;
};

Members

channels
Array of channels the hardware can operate in in this band.
bitrates
Array of bitrates the hardware can operate with in this band. Must be sorted to give a valid "supported rates" IE, i.e. CCK rates first, then OFDM.
band
the band this structure represents
n_channels
Number of channels in channels
n_bitrates
Number of bitrates in bitrates
ht_cap
HT capabilities in this band

Description

This structure describes a frequency band a wiphy is able to operate in.


Actions and configuration

    Each wireless device and each virtual interface offer a set of configuration operations and other actions that are invoked by userspace. Each of these actions is described in the operations structure, and the parameters these operations use are described separately.

    Additionally, some operations are asynchronous and expect to get status information via some functions that drivers need to call.

    Scanning and BSS list handling with its associated functionality is described in a separate chapter.


struct vif_params - describes virtual interface parameters

struct vif_params {
    int use_4addr;
};

Members

use_4addr
use 4-address frames

struct key_params - key information

struct key_params {
    u8 * key;
    u8 * seq;
    int key_len;
    int seq_len;
    u32 cipher;
};

Members

key
key material
seq
sequence counter (IV/PN) for TKIP and CCMP keys, only used with the get_key callback, must be in little endian, length given by seq_len.
key_len
length of key material
seq_len
length of seq.
cipher
cipher suite selector

Description

Information about a key


enum survey_info_flags

enum survey_info_flags {
SURVEY_INFO_NOISE_DBM,
SURVEY_INFO_IN_USE,
SURVEY_INFO_CHANNEL_TIME,
SURVEY_INFO_CHANNEL_TIME_BUSY,
SURVEY_INFO_CHANNEL_TIME_EXT_BUSY,
SURVEY_INFO_CHANNEL_TIME_RX,
SURVEY_INFO_CHANNEL_TIME_TX
};

Constants

SURVEY_INFO_NOISE_DBM
noise (in dBm) was filled in
SURVEY_INFO_IN_USE
channel is currently being used
SURVEY_INFO_CHANNEL_TIME
channel active time (in ms) was filled in
SURVEY_INFO_CHANNEL_TIME_BUSY
channel busy time was filled in
SURVEY_INFO_CHANNEL_TIME_EXT_BUSY
extension channel busy time was filled in
SURVEY_INFO_CHANNEL_TIME_RX
channel receive time was filled in
SURVEY_INFO_CHANNEL_TIME_TX
channel transmit time was filled in

Description

Used by the driver to indicate which info in struct survey_info it has filled in during the get_survey.

struct survey_info - channel survey response

struct survey_info {
    struct ieee80211_channel * channel;
    u64 channel_time;
    u64 channel_time_busy;
    u64 channel_time_ext_busy;
    u64 channel_time_rx;
    u64 channel_time_tx;
    u32 filled;
    s8 noise;
};

Members

channel
the channel this survey record reports, mandatory
channel_time
amount of time in ms the radio spent on the channel
channel_time_busy
amount of time the primary channel was sensed busy
channel_time_ext_busy
amount of time the extension channel was sensed busy
channel_time_rx
amount of time the radio spent receiving data
channel_time_tx
amount of time the radio spent transmitting data
filled
bitflag of flags from enum survey_info_flags
noise
channel noise in dBm. This and all following fields are optional

Description

Used by dump_survey to report back per-channel survey information.

This structure can later be expanded with things like channel duty cycle etc.


struct cfg80211_crypto_settings - Crypto settings

struct cfg80211_crypto_settings {
    u32 wpa_versions;
    u32 cipher_group;
    int n_ciphers_pairwise;
    u32 ciphers_pairwise[NL80211_MAX_NR_CIPHER_SUITES];
    int n_akm_suites;
    u32 akm_suites[NL80211_MAX_NR_AKM_SUITES];
    bool control_port;
    __be16 control_port_ethertype;
    bool control_port_no_encrypt;
};

Members

wpa_versions
indicates which, if any, WPA versions are enabled (from enum nl80211_wpa_versions)
cipher_group
group key cipher suite (or 0 if unset)
n_ciphers_pairwise
number of AP supported unicast ciphers
ciphers_pairwise[NL80211_MAX_NR_CIPHER_SUITES]
unicast key cipher suites
n_akm_suites
number of AKM suites
akm_suites[NL80211_MAX_NR_AKM_SUITES]
AKM suites
control_port
Whether user space controls IEEE 802.1X port, i.e., sets/clears NL80211_STA_FLAG_AUTHORIZED. If true, the driver is required to assume that the port is unauthorized until authorized by user space. Otherwise, port is marked authorized by default.
control_port_ethertype
the control port protocol that should be allowed through even on unauthorized ports
control_port_no_encrypt
TRUE to prevent encryption of control port protocol frames.

struct beacon_parameters - beacon parameters

struct beacon_parameters {
    u8 * head;
    u8 * tail;
    int interval;
    int dtim_period;
    int head_len;
    int tail_len;
    const u8 * ssid;
    size_t ssid_len;
    enum nl80211_hidden_ssid hidden_ssid;
    struct cfg80211_crypto_settings crypto;
    bool privacy;
    enum nl80211_auth_type auth_type;
    const u8 * beacon_ies;
    size_t beacon_ies_len;
    const u8 * proberesp_ies;
    size_t proberesp_ies_len;
    const u8 * assocresp_ies;
    size_t assocresp_ies_len;
    int probe_resp_len;
    u8 * probe_resp;
};

Members

head
head portion of beacon (before TIM IE) or NULL if not changed
tail
tail portion of beacon (after TIM IE) or NULL if not changed
interval
beacon interval or zero if not changed
dtim_period
DTIM period or zero if not changed
head_len
length of head
tail_len
length of tail
ssid
SSID to be used in the BSS (note: may be NULL if not provided from user space)
ssid_len
length of ssid
hidden_ssid
whether to hide the SSID in Beacon/Probe Response frames
crypto
crypto settings
privacy
the BSS uses privacy
auth_type
Authentication type (algorithm)
beacon_ies
extra information element(s) to add into Beacon frames or NULL
beacon_ies_len
length of beacon_ies in octets
proberesp_ies
extra information element(s) to add into Probe Response frames or NULL
proberesp_ies_len
length of proberesp_ies in octets
assocresp_ies
extra information element(s) to add into (Re)Association Response frames or NULL
assocresp_ies_len
length of assocresp_ies in octets
probe_resp_len
length of probe response template (probe_resp)
probe_resp
probe response template (AP mode only)

Description

Used to configure the beacon for an interface.


enum plink_actions

enum plink_actions {
PLINK_ACTION_INVALID,
PLINK_ACTION_OPEN,
PLINK_ACTION_BLOCK
};

Constants

PLINK_ACTION_INVALID
action 0 is reserved
PLINK_ACTION_OPEN
start mesh peer link establishment
PLINK_ACTION_BLOCK
block traffic from this mesh peer

enum station_parameters_apply_mask

enum station_parameters_apply_mask {
STATION_PARAM_APPLY_UAPSD
};

Constants

STATION_PARAM_APPLY_UAPSD
apply new uAPSD parameters (uapsd_queues, max_sp)

Description

Not all station parameters have in-band "no change" signalling, for those that don't these flags will are used.

struct station_parameters - station parameters

struct station_parameters {
    u8 * supported_rates;
    struct net_device * vlan;
    u32 sta_flags_mask;
    u32 sta_flags_set;
    u32 sta_modify_mask;
    int listen_interval;
    u16 aid;
    u8 supported_rates_len;
    u8 plink_action;
    u8 plink_state;
    struct ieee80211_ht_cap * ht_capa;
    u8 uapsd_queues;
    u8 max_sp;
};

Members

supported_rates
supported rates in IEEE 802.11 format (or NULL for no change)
vlan
vlan interface station should belong to
sta_flags_mask
station flags that changed (bitmask of BIT(NL80211_STA_FLAG_...))
sta_flags_set
station flags values (bitmask of BIT(NL80211_STA_FLAG_...))
sta_modify_mask
bitmap indicating which parameters changed (for those that don't have a natural "no change" value), see enum station_parameters_apply_mask
listen_interval
listen interval or -1 for no change
aid
AID or zero for no change
supported_rates_len
number of supported rates
plink_action
plink action to take
plink_state
set the peer link state for a station
ht_capa
HT capabilities of station
uapsd_queues
bitmap of queues configured for uapsd. same format as the AC bitmap in the QoS info field
max_sp
max Service Period. same format as the MAX_SP in the QoS info field (but already shifted down)

Description

Used to change and create a new station.


enum station_info_flags

enum station_info_flags {
STATION_INFO_INACTIVE_TIME,
STATION_INFO_RX_BYTES,
STATION_INFO_TX_BYTES,
STATION_INFO_LLID,
STATION_INFO_PLID,
STATION_INFO_PLINK_STATE,
STATION_INFO_SIGNAL,
STATION_INFO_TX_BITRATE,
STATION_INFO_RX_PACKETS,
STATION_INFO_TX_PACKETS,
STATION_INFO_TX_RETRIES,
STATION_INFO_TX_FAILED,
STATION_INFO_RX_DROP_MISC,
STATION_INFO_SIGNAL_AVG,
STATION_INFO_RX_BITRATE,
STATION_INFO_BSS_PARAM,
STATION_INFO_CONNECTED_TIME,
STATION_INFO_ASSOC_REQ_IES,
STATION_INFO_STA_FLAGS,
STATION_INFO_BEACON_LOSS_COUNT
};

Constants

STATION_INFO_INACTIVE_TIME
inactive_time filled
STATION_INFO_RX_BYTES
rx_bytes filled
STATION_INFO_TX_BYTES
tx_bytes filled
STATION_INFO_LLID
llid filled
STATION_INFO_PLID
plid filled
STATION_INFO_PLINK_STATE
plink_state filled
STATION_INFO_SIGNAL
signal filled
STATION_INFO_TX_BITRATE
txrate fields are filled (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
STATION_INFO_RX_PACKETS
rx_packets filled
STATION_INFO_TX_PACKETS
tx_packets filled
STATION_INFO_TX_RETRIES
tx_retries filled
STATION_INFO_TX_FAILED
tx_failed filled
STATION_INFO_RX_DROP_MISC
rx_dropped_misc filled
STATION_INFO_SIGNAL_AVG
signal_avg filled
STATION_INFO_RX_BITRATE
rxrate fields are filled
STATION_INFO_BSS_PARAM
bss_param filled
STATION_INFO_CONNECTED_TIME
connected_time filled
STATION_INFO_ASSOC_REQ_IES
assoc_req_ies filled
STATION_INFO_STA_FLAGS
sta_flags filled
STATION_INFO_BEACON_LOSS_COUNT
beacon_loss_count filled

Description

Used by the driver to indicate which info in struct station_info it has filled in during get_station or dump_station.


enum rate_info_flags

enum rate_info_flags {
RATE_INFO_FLAGS_MCS,
RATE_INFO_FLAGS_40_MHZ_WIDTH,
RATE_INFO_FLAGS_SHORT_GI
};

Constants

RATE_INFO_FLAGS_MCS
tx_bitrate_mcs filled
RATE_INFO_FLAGS_40_MHZ_WIDTH
40 Mhz width transmission
RATE_INFO_FLAGS_SHORT_GI
400ns guard interval

Description

Used by the driver to indicate the specific rate transmission type for 802.11n transmissions.


struct rate_info - bitrate information

struct rate_info {
    u8 flags;
    u8 mcs;
    u16 legacy;
};

Members

flags
bitflag of flags from enum rate_info_flags
mcs
mcs index if struct describes a 802.11n bitrate
legacy
bitrate in 100kbit/s for 802.11abg

Description

Information about a receiving or transmitting bitrate


enum bss_param_flags

enum bss_param_flags {
BSS_PARAM_FLAGS_CTS_PROT,
BSS_PARAM_FLAGS_SHORT_PREAMBLE,
BSS_PARAM_FLAGS_SHORT_SLOT_TIME
};

Constants

BSS_PARAM_FLAGS_CTS_PROT
whether CTS protection is enabled
BSS_PARAM_FLAGS_SHORT_PREAMBLE
whether short preamble is enabled
BSS_PARAM_FLAGS_SHORT_SLOT_TIME
whether short slot time is enabled

Description

Used by the driver to indicate the specific rate transmission type for 802.11n transmissions.


struct sta_bss_parameters - BSS parameters for the attached station

struct sta_bss_parameters {
    u8 flags;
    u8 dtim_period;
    u16 beacon_interval;
};

Members

flags
bitflag of flags from enum bss_param_flags
dtim_period
DTIM period for the BSS
beacon_interval
beacon interval

Description

Information about the currently associated BSS


struct station_info - station information

struct station_info {
    u32 filled;
    u32 connected_time;
    u32 inactive_time;
    u32 rx_bytes;
    u32 tx_bytes;
    u16 llid;
    u16 plid;
    u8 plink_state;
    s8 signal;
    s8 signal_avg;
    struct rate_info txrate;
    struct rate_info rxrate;
    u32 rx_packets;
    u32 tx_packets;
    u32 tx_retries;
    u32 tx_failed;
    u32 rx_dropped_misc;
    struct sta_bss_parameters bss_param;
    struct nl80211_sta_flag_update sta_flags;
    int generation;
    const u8 * assoc_req_ies;
    size_t assoc_req_ies_len;
    u32 beacon_loss_count;
};

Members

filled
bitflag of flags from enum station_info_flags
connected_time
time(in secs) since a station is last connected
inactive_time
time since last station activity (tx/rx) in milliseconds
rx_bytes
bytes received from this station
tx_bytes
bytes transmitted to this station
llid
mesh local link id
plid
mesh peer link id
plink_state
mesh peer link state
signal
signal strength of last received packet in dBm
signal_avg
signal strength average in dBm
txrate
current unicast bitrate from this station
rxrate
current unicast bitrate to this station
rx_packets
packets received from this station
tx_packets
packets transmitted to this station
tx_retries
cumulative retry counts
tx_failed
number of failed transmissions (retries exceeded, no ACK)
rx_dropped_misc
Dropped for un-specified reason.
bss_param
current BSS parameters
sta_flags
station flags mask & values
generation
generation number for nl80211 dumps. This number should increase every time the list of stations changes, i.e. when a station is added or removed, so that userspace can tell whether it got a consistent snapshot.
assoc_req_ies
IEs from (Re)Association Request. This is used only when in AP mode with drivers that do not use user space MLME/SME implementation. The information is provided for the cfg80211_new_sta calls to notify user space of the IEs.
assoc_req_ies_len
Length of assoc_req_ies buffer in octets.
beacon_loss_count
Number of times beacon loss event has triggered.

Description

Station information filled by driver for get_station and dump_station.


enum monitor_flags

enum monitor_flags {
MONITOR_FLAG_FCSFAIL,
MONITOR_FLAG_PLCPFAIL,
MONITOR_FLAG_CONTROL,
MONITOR_FLAG_OTHER_BSS,
MONITOR_FLAG_COOK_FRAMES
};

Constants

MONITOR_FLAG_FCSFAIL
pass frames with bad FCS
MONITOR_FLAG_PLCPFAIL
pass frames with bad PLCP
MONITOR_FLAG_CONTROL
pass control frames
MONITOR_FLAG_OTHER_BSS
disable BSSID filtering
MONITOR_FLAG_COOK_FRAMES
report frames after processing

Description

Monitor interface configuration flags. Note that these must be the bits according to the nl80211 flags.


enum mpath_info_flags

enum mpath_info_flags {
MPATH_INFO_FRAME_QLEN,
MPATH_INFO_SN,
MPATH_INFO_METRIC,
MPATH_INFO_EXPTIME,
MPATH_INFO_DISCOVERY_TIMEOUT,
MPATH_INFO_DISCOVERY_RETRIES,
MPATH_INFO_FLAGS
};

Constants

MPATH_INFO_FRAME_QLEN
frame_qlen filled
MPATH_INFO_SN
sn filled
MPATH_INFO_METRIC
metric filled
MPATH_INFO_EXPTIME
exptime filled
MPATH_INFO_DISCOVERY_TIMEOUT
discovery_timeout filled
MPATH_INFO_DISCOVERY_RETRIES
discovery_retries filled
MPATH_INFO_FLAGS
flags filled

Description

Used by the driver to indicate which info in struct mpath_info it has filled in during get_station or dump_station.


struct mpath_info - mesh path information

struct mpath_info {
    u32 filled;
    u32 frame_qlen;
    u32 sn;
    u32 metric;
    u32 exptime;
    u32 discovery_timeout;
    u8 discovery_retries;
    u8 flags;
    int generation;
};

Members

filled
bitfield of flags from enum mpath_info_flags
frame_qlen
number of queued frames for this destination
sn
target sequence number
metric
metric (cost) of this mesh path
exptime
expiration time for the mesh path from now, in msecs
discovery_timeout
total mesh path discovery timeout, in msecs
discovery_retries
mesh path discovery retries
flags
mesh path flags
generation
generation number for nl80211 dumps. This number should increase every time the list of mesh paths changes, i.e. when a station is added or removed, so that userspace can tell whether it got a consistent snapshot.

Description

Mesh path information filled by driver for get_mpath and dump_mpath.


struct bss_parameters - BSS parameters

struct bss_parameters {
    int use_cts_prot;
    int use_short_preamble;
    int use_short_slot_time;
    u8 * basic_rates;
    u8 basic_rates_len;
    int ap_isolate;
    int ht_opmode;
};

Members

use_cts_prot
Whether to use CTS protection (0 = no, 1 = yes, -1 = do not change)
use_short_preamble
Whether the use of short preambles is allowed (0 = no, 1 = yes, -1 = do not change)
use_short_slot_time
Whether the use of short slot time is allowed (0 = no, 1 = yes, -1 = do not change)
basic_rates
basic rates in IEEE 802.11 format (or NULL for no change)
basic_rates_len
number of basic rates
ap_isolate
do not forward packets between connected stations
ht_opmode
HT Operation mode (u16 = opmode, -1 = do not change)

Description

Used to change BSS parameters (mainly for AP mode).


struct mesh_setup - 802.11s mesh setup configuration

struct mesh_setup {
    const u8 * mesh_id;
    u8 mesh_id_len;
    u8 path_sel_proto;
    u8 path_metric;
    const u8 * ie;
    u8 ie_len;
    bool is_authenticated;
    bool is_secure;
    int mcast_rate[IEEE80211_NUM_BANDS];
};

Members

mesh_id
the mesh ID
mesh_id_len
length of the mesh ID, at least 1 and at most 32 bytes
path_sel_proto
which path selection protocol to use
path_metric
which metric to use
ie
vendor information elements (optional)
ie_len
length of vendor information elements
is_authenticated
this mesh requires authentication
is_secure
this mesh uses security
mcast_rate[IEEE80211_NUM_BANDS]
multicat rate for Mesh Node [6Mbps is the default for 802.11a]

Description

These parameters are fixed when the mesh is created.

struct ieee80211_txq_params - TX queue parameters

struct ieee80211_txq_params {
    enum nl80211_txq_q queue;
    u16 txop;
    u16 cwmin;
    u16 cwmax;
    u8 aifs;
};

Members

queue
TX queue identifier (NL80211_TXQ_Q_*)
txop
Maximum burst time in units of 32 usecs, 0 meaning disabled
cwmin
Minimum contention window [a value of the form 2^n-1 in the range 1..32767]
cwmax
Maximum contention window [a value of the form 2^n-1 in the range 1..32767]
aifs
Arbitration interframe space [0..255]

Scanning and BSS list handling

    The scanning process itself is fairly simple, but cfg80211 offers quite a bit of helper functionality. To start a scan, the scan operation will be invoked with a scan definition. This scan definition contains the channels to scan, and the SSIDs to send probe requests for (including the wildcard, if desired). A passive scan is indicated by having no SSIDs to probe. Additionally, a scan request may contain extra information elements that should be added to the probe request. The IEs are guaranteed to be well-formed, and will not exceed the maximum length the driver advertised in the wiphy structure.

    When scanning finds a BSS, cfg80211 needs to be notified of that, because it is responsible for maintaining the BSS list; the driver should not maintain a list itself. For this notification, various functions exist.

    Since drivers do not maintain a BSS list, there are also a number of functions to search for a BSS and obtain information about it from the BSS structure cfg80211 maintains. The BSS list is also made available to userspace.


struct cfg80211_ssid - SSID description

struct cfg80211_ssid {
    u8 ssid[IEEE80211_MAX_SSID_LEN];
    u8 ssid_len;
};

Members

ssid[IEEE80211_MAX_SSID_LEN]
the SSID
ssid_len
length of the ssid

struct cfg80211_scan_request - scan request description

struct cfg80211_scan_request {
    struct cfg80211_ssid * ssids;
    int n_ssids;
    u32 n_channels;
    const u8 * ie;
    size_t ie_len;
    u32 rates[IEEE80211_NUM_BANDS];
    struct wiphy * wiphy;
    struct net_device * dev;
    bool aborted;
    bool no_cck;
    struct ieee80211_channel * channels[0];
};

Members

ssids
SSIDs to scan for (active scan only)
n_ssids
number of SSIDs
n_channels
total number of channels to scan
ie
optional information element(s) to add into Probe Request or NULL
ie_len
length of ie in octets
rates[IEEE80211_NUM_BANDS]
bitmap of rates to advertise for each band
wiphy
the wiphy this was for
dev
the interface
aborted
(internal) scan request was notified as aborted
no_cck
used to send probe requests at non CCK rate in 2GHz band
channels[0]
channels to scan on.

struct cfg80211_match_set - sets of attributes to match

struct cfg80211_match_set {
    struct cfg80211_ssid ssid;
};

Members

ssid
SSID to be matched

struct cfg80211_sched_scan_request - scheduled scan request description

struct cfg80211_sched_scan_request {
    struct cfg80211_ssid * ssids;
    int n_ssids;
    u32 n_channels;
    u32 interval;
    const u8 * ie;
    size_t ie_len;
    struct cfg80211_match_set * match_sets;
    int n_match_sets;
    struct wiphy * wiphy;
    struct net_device * dev;
    struct ieee80211_channel * channels[0];
};

Members

ssids
SSIDs to scan for (passed in the probe_reqs in active scans)
n_ssids
number of SSIDs
n_channels
total number of channels to scan
interval
interval between each scheduled scan cycle
ie
optional information element(s) to add into Probe Request or NULL
ie_len
length of ie in octets
match_sets
sets of parameters to be matched for a scan result entry to be considered valid and to be passed to the host (others are filtered out). If ommited, all results are passed.
n_match_sets
number of match sets
wiphy
the wiphy this was for
dev
the interface
channels[0]
channels to scan

enum cfg80211_signal_type

enum cfg80211_signal_type {
CFG80211_SIGNAL_TYPE_NONE,
CFG80211_SIGNAL_TYPE_MBM,
CFG80211_SIGNAL_TYPE_UNSPEC
};

Constants

CFG80211_SIGNAL_TYPE_NONE
no signal strength information available
CFG80211_SIGNAL_TYPE_MBM
signal strength in mBm (100*dBm)
CFG80211_SIGNAL_TYPE_UNSPEC
signal strength, increasing from 0 through 100

struct cfg80211_bss - BSS description

struct cfg80211_bss {
    struct ieee80211_channel * channel;
    u8 bssid[ETH_ALEN];
    u64 tsf;
    u16 beacon_interval;
    u16 capability;
    u8 * information_elements;
    size_t len_information_elements;
    u8 * beacon_ies;
    size_t len_beacon_ies;
    u8 * proberesp_ies;
    size_t len_proberesp_ies;
    s32 signal;
    void (*free_priv) (struct cfg80211_bss *bss);
    u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
};

Members

channel
channel this BSS is on
bssid[ETH_ALEN]
BSSID of the BSS
tsf
timestamp of last received update
beacon_interval
the beacon interval as from the frame
capability
the capability field in host byte order
information_elements
the information elements (Note that there is no guarantee that these are well-formed!); this is a pointer to either the beacon_ies or proberesp_ies depending on whether Probe Response frame has been received
len_information_elements
total length of the information elements
beacon_ies
the information elements from the last Beacon frame
len_beacon_ies
total length of the beacon_ies
proberesp_ies
the information elements from the last Probe Response frame
len_proberesp_ies
total length of the proberesp_ies
signal
signal strength value (type depends on the wiphy's signal_type)
free_priv
function pointer to free private data
priv[0] __attribute__((__aligned__(sizeof(void *))))
private area for driver use, has at least wiphy->bss_priv_size bytes

Description

This structure describes a BSS (which may also be a mesh network) for use in scan results and similar.


ieee80211_bss_get_ie - find IE with given ID

const u8 * ieee80211_bss_get_ie (struct cfg80211_bss * bss, u8 ie)

Arguments

bss
the bss to search
ie
the IE ID Returns NULL if not found.

struct cfg80211_auth_request - Authentication request data

struct cfg80211_auth_request {
    struct cfg80211_bss * bss;
    const u8 * ie;
    size_t ie_len;
    enum nl80211_auth_type auth_type;
    const u8 * key;
    u8 key_len;
    u8 key_idx;
};

Members

bss
The BSS to authenticate with.
ie
Extra IEs to add to Authentication frame or NULL
ie_len
Length of ie buffer in octets
auth_type
Authentication type (algorithm)
key
WEP key for shared key authentication
key_len
length of WEP key for shared key authentication
key_idx
index of WEP key for shared key authentication

Description

This structure provides information needed to complete IEEE 802.11 authentication.


enum cfg80211_assoc_req_flags

enum cfg80211_assoc_req_flags {
ASSOC_REQ_DISABLE_HT
};

Constants

ASSOC_REQ_DISABLE_HT
Disable HT (802.11n)

struct cfg80211_assoc_request - (Re)Association request data

struct cfg80211_assoc_request {
    struct cfg80211_bss * bss;
    const u8 * ie;
    const u8 * prev_bssid;
    size_t ie_len;
    struct cfg80211_crypto_settings crypto;
    bool use_mfp;
    u32 flags;
    struct ieee80211_ht_cap ht_capa;
    struct ieee80211_ht_cap ht_capa_mask;
};

Members

bss
The BSS to associate with. If the call is successful the driver is given a reference that it must release, normally via a call to cfg80211_send_rx_assoc, or, if association timed out, with a call to cfg80211_put_bss (in addition to calling cfg80211_send_assoc_timeout)
ie
Extra IEs to add to (Re)Association Request frame or NULL
prev_bssid
previous BSSID, if not NULL use reassociate frame
ie_len
Length of ie buffer in octets
crypto
crypto settings
use_mfp
Use management frame protection (IEEE 802.11w) in this association
flags
See enum cfg80211_assoc_req_flags
ht_capa
HT Capabilities over-rides. Values set in ht_capa_mask will be used in ht_capa. Un-supported values will be ignored.
ht_capa_mask
The bits of ht_capa which are to be used.

Description

This structure provides information needed to complete IEEE 802.11 (re)association.


struct cfg80211_deauth_request - Deauthentication request data

struct cfg80211_deauth_request {
    const u8 * bssid;
    const u8 * ie;
    size_t ie_len;
    u16 reason_code;
};

Members

bssid
the BSSID of the BSS to deauthenticate from
ie
Extra IEs to add to Deauthentication frame or NULL
ie_len
Length of ie buffer in octets
reason_code
The reason code for the deauthentication

Description

This structure provides information needed to complete IEEE 802.11 deauthentication.


struct cfg80211_disassoc_request - Disassociation request data

struct cfg80211_disassoc_request {
    struct cfg80211_bss * bss;
    const u8 * ie;
    size_t ie_len;
    u16 reason_code;
    bool local_state_change;
};

Members

bss
the BSS to disassociate from
ie
Extra IEs to add to Disassociation frame or NULL
ie_len
Length of ie buffer in octets
reason_code
The reason code for the disassociation
local_state_change
This is a request for a local state only, i.e., no Disassociation frame is to be transmitted.

Description

This structure provides information needed to complete IEEE 802.11 disassocation.


struct cfg80211_ibss_params - IBSS parameters

struct cfg80211_ibss_params {
    u8 * ssid;
    u8 * bssid;
    struct ieee80211_channel * channel;
    enum nl80211_channel_type channel_type;
    u8 * ie;
    u8 ssid_len;
    u8 ie_len;
    u16 beacon_interval;
    u32 basic_rates;
    bool channel_fixed;
    bool privacy;
    bool control_port;
    int mcast_rate[IEEE80211_NUM_BANDS];
};

Members

ssid
The SSID, will always be non-null.
bssid
Fixed BSSID requested, maybe be NULL, if set do not search for IBSSs with a different BSSID.
channel
The channel to use if no IBSS can be found to join.
channel_type
channel type (HT mode)
ie
information element(s) to include in the beacon
ssid_len
The length of the SSID, will always be non-zero.
ie_len
length of that
beacon_interval
beacon interval to use
basic_rates
bitmap of basic rates to use when creating the IBSS
channel_fixed
The channel should be fixed -- do not search for IBSSs to join on other channels.
privacy
this is a protected network, keys will be configured after joining
control_port
whether user space controls IEEE 802.1X port, i.e., sets/clears NL80211_STA_FLAG_AUTHORIZED. If true, the driver is required to assume that the port is unauthorized until authorized by user space. Otherwise, port is marked authorized by default.
mcast_rate[IEEE80211_NUM_BANDS]
per-band multicast rate index + 1 (0: disabled)

Description

This structure defines the IBSS parameters for the join_ibss method.


struct cfg80211_connect_params - Connection parameters

struct cfg80211_connect_params {
    struct ieee80211_channel * channel;
    u8 * bssid;
    u8 * ssid;
    size_t ssid_len;
    enum nl80211_auth_type auth_type;
    u8 * ie;
    size_t ie_len;
    bool privacy;
    struct cfg80211_crypto_settings crypto;
    const u8 * key;
    u8 key_len;
    u8 key_idx;
    u32 flags;
    struct ieee80211_ht_cap ht_capa;
    struct ieee80211_ht_cap ht_capa_mask;
};

Members

channel
The channel to use or NULL if not specified (auto-select based on scan results)
bssid
The AP BSSID or NULL if not specified (auto-select based on scan results)
ssid
SSID
ssid_len
Length of ssid in octets
auth_type
Authentication type (algorithm)
ie
IEs for association request
ie_len
Length of assoc_ie in octets
privacy
indicates whether privacy-enabled APs should be used
crypto
crypto settings
key
WEP key for shared key authentication
key_len
length of WEP key for shared key authentication
key_idx
index of WEP key for shared key authentication
flags
See enum cfg80211_assoc_req_flags
ht_capa
HT Capabilities over-rides. Values set in ht_capa_mask will be used in ht_capa. Un-supported values will be ignored.
ht_capa_mask
The bits of ht_capa which are to be used.

Description

This structure provides information needed to complete IEEE 802.11 authentication and association.


enum wiphy_params_flags

enum wiphy_params_flags {
WIPHY_PARAM_RETRY_SHORT,
WIPHY_PARAM_RETRY_LONG,
WIPHY_PARAM_FRAG_THRESHOLD,
WIPHY_PARAM_RTS_THRESHOLD,
WIPHY_PARAM_COVERAGE_CLASS
};

Constants

WIPHY_PARAM_RETRY_SHORT
wiphy->retry_short has changed
WIPHY_PARAM_RETRY_LONG
wiphy->retry_long has changed
WIPHY_PARAM_FRAG_THRESHOLD
wiphy->frag_threshold has changed
WIPHY_PARAM_RTS_THRESHOLD
wiphy->rts_threshold has changed
WIPHY_PARAM_COVERAGE_CLASS
coverage class changed

struct cfg80211_pmksa - PMK Security Association

struct cfg80211_pmksa {
    u8 * bssid;
    u8 * pmkid;
};

Members

bssid
The AP's BSSID.
pmkid
The PMK material itself.

Description

This structure is passed to the set/del_pmksa method for PMKSA caching.


struct cfg80211_wowlan_trig_pkt_pattern - packet pattern

struct cfg80211_wowlan_trig_pkt_pattern {
    u8 * mask;
    u8 * pattern;
    int pattern_len;
};

Members

mask
bitmask where to match pattern and where to ignore bytes, one bit per byte, in same format as nl80211
pattern
bytes to match where bitmask is 1
pattern_len
length of pattern (in bytes)

Internal note

mask and pattern are allocated in one chunk of memory, free mask only!

struct cfg80211_wowlan - Wake on Wireless-LAN support info

struct cfg80211_wowlan {
    bool any;
    bool disconnect;
    bool magic_pkt;
    bool gtk_rekey_failure;
    bool eap_identity_req;
    bool four_way_handshake;
    bool rfkill_release;
    struct cfg80211_wowlan_trig_pkt_pattern * patterns;
    int n_patterns;
};

Members

any
wake up on any activity -- special trigger if device continues operating as normal during suspend
disconnect
wake up if getting disconnected
magic_pkt
wake up on receiving magic packet
gtk_rekey_failure
wake up on GTK rekey failure
eap_identity_req
wake up on EAP identity request packet
four_way_handshake
wake up on 4-way handshake
rfkill_release
wake up when rfkill is released
patterns
wake up on receiving packet matching a pattern
n_patterns
number of patterns

Description

This structure defines the enabled WoWLAN triggers for the device.


struct cfg80211_gtk_rekey_data - rekey data

struct cfg80211_gtk_rekey_data {
    u8 kek[NL80211_KEK_LEN];
    u8 kck[NL80211_KCK_LEN];
    u8 replay_ctr[NL80211_REPLAY_CTR_LEN];
};

Members

kek[NL80211_KEK_LEN]
key encryption key
kck[NL80211_KCK_LEN]
key confirmation key
replay_ctr[NL80211_REPLAY_CTR_LEN]
replay counter

struct cfg80211_ops - backend description for wireless configuration

struct cfg80211_ops {
    int (*suspend) (struct wiphy *wiphy, struct cfg80211_wowlan *wow);
    int (*resume) (struct wiphy *wiphy);
    struct net_device * (*add_virtual_intf) (struct wiphy *wiphy,char *name,enum nl80211_iftype type,u32 *flags,struct vif_params *params);
    int (*del_virtual_intf) (struct wiphy *wiphy, struct net_device *dev);
    int (*change_virtual_intf) (struct wiphy *wiphy,struct net_device *dev,enum nl80211_iftype type, u32 *flags,struct vif_params *params);
    int (*add_key) (struct wiphy *wiphy, struct net_device *netdev,u8 key_index, bool pairwise, const u8 *mac_addr,struct key_params *params);
    int (*get_key) (struct wiphy *wiphy, struct net_device *netdev,u8 key_index, bool pairwise, const u8 *mac_addr,void *cookie,void (*callback);
    int (*del_key) (struct wiphy *wiphy, struct net_device *netdev,u8 key_index, bool pairwise, const u8 *mac_addr);
    int (*set_default_key) (struct wiphy *wiphy,struct net_device *netdev,u8 key_index, bool unicast, bool multicast);
    int (*set_default_mgmt_key) (struct wiphy *wiphy,struct net_device *netdev,u8 key_index);
    int (*add_beacon) (struct wiphy *wiphy, struct net_device *dev,struct beacon_parameters *info);
    int (*set_beacon) (struct wiphy *wiphy, struct net_device *dev,struct beacon_parameters *info);
    int (*del_beacon) (struct wiphy *wiphy, struct net_device *dev);
    int (*add_station) (struct wiphy *wiphy, struct net_device *dev,u8 *mac, struct station_parameters *params);
    int (*del_station) (struct wiphy *wiphy, struct net_device *dev,u8 *mac);
    int (*change_station) (struct wiphy *wiphy, struct net_device *dev,u8 *mac, struct station_parameters *params);
    int (*get_station) (struct wiphy *wiphy, struct net_device *dev,u8 *mac, struct station_info *sinfo);
    int (*dump_station) (struct wiphy *wiphy, struct net_device *dev,int idx, u8 *mac, struct station_info *sinfo);
    int (*add_mpath) (struct wiphy *wiphy, struct net_device *dev,u8 *dst, u8 *next_hop);
    int (*del_mpath) (struct wiphy *wiphy, struct net_device *dev,u8 *dst);
    int (*change_mpath) (struct wiphy *wiphy, struct net_device *dev,u8 *dst, u8 *next_hop);
    int (*get_mpath) (struct wiphy *wiphy, struct net_device *dev,u8 *dst, u8 *next_hop,struct mpath_info *pinfo);
    int (*dump_mpath) (struct wiphy *wiphy, struct net_device *dev,int idx, u8 *dst, u8 *next_hop,struct mpath_info *pinfo);
    int (*get_mesh_config) (struct wiphy *wiphy,struct net_device *dev,struct mesh_config *conf);
    int (*update_mesh_config) (struct wiphy *wiphy,struct net_device *dev, u32 mask,const struct mesh_config *nconf);
    int (*join_mesh) (struct wiphy *wiphy, struct net_device *dev,const struct mesh_config *conf,const struct mesh_setup *setup);
    int (*leave_mesh) (struct wiphy *wiphy, struct net_device *dev);
    int (*change_bss) (struct wiphy *wiphy, struct net_device *dev,struct bss_parameters *params);
    int (*set_txq_params) (struct wiphy *wiphy, struct net_device *dev,struct ieee80211_txq_params *params);
    int (*set_channel) (struct wiphy *wiphy, struct net_device *dev,struct ieee80211_channel *chan,enum nl80211_channel_type channel_type);
    int (*scan) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_scan_request *request);
    int (*auth) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_auth_request *req);
    int (*assoc) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_assoc_request *req);
    int (*deauth) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_deauth_request *req,void *cookie);
    int (*disassoc) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_disassoc_request *req,void *cookie);
    int (*connect) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_connect_params *sme);
    int (*disconnect) (struct wiphy *wiphy, struct net_device *dev,u16 reason_code);
    int (*join_ibss) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_ibss_params *params);
    int (*leave_ibss) (struct wiphy *wiphy, struct net_device *dev);
    int (*set_wiphy_params) (struct wiphy *wiphy, u32 changed);
    int (*set_tx_power) (struct wiphy *wiphy,enum nl80211_tx_power_setting type, int mbm);
    int (*get_tx_power) (struct wiphy *wiphy, int *dbm);
    int (*set_wds_peer) (struct wiphy *wiphy, struct net_device *dev,const u8 *addr);
    void (*rfkill_poll) (struct wiphy *wiphy);
#ifdef CONFIG_NL80211_TESTMODE
    int (*testmode_cmd) (struct wiphy *wiphy, void *data, int len);
    int (*testmode_dump) (struct wiphy *wiphy, struct sk_buff *skb,struct netlink_callback *cb,void *data, int len);
#endif
    int (*set_bitrate_mask) (struct wiphy *wiphy,struct net_device *dev,const u8 *peer,const struct cfg80211_bitrate_mask *mask);
    int (*dump_survey) (struct wiphy *wiphy, struct net_device *netdev,int idx, struct survey_info *info);
    int (*set_pmksa) (struct wiphy *wiphy, struct net_device *netdev,struct cfg80211_pmksa *pmksa);
    int (*del_pmksa) (struct wiphy *wiphy, struct net_device *netdev,struct cfg80211_pmksa *pmksa);
    int (*flush_pmksa) (struct wiphy *wiphy, struct net_device *netdev);
    int (*remain_on_channel) (struct wiphy *wiphy,struct net_device *dev,struct ieee80211_channel *chan,enum nl80211_channel_type channel_type,unsigned int duration,u64 *cookie);
    int (*cancel_remain_on_channel) (struct wiphy *wiphy,struct net_device *dev,u64 cookie);
    int (*mgmt_tx) (struct wiphy *wiphy, struct net_device *dev,struct ieee80211_channel *chan, bool offchan,enum nl80211_channel_type channel_type,bool channel_type_valid, unsigned int wait,const u8 *buf, size_t len, bool no_cck,bool dont_wait_for_ack, u64 *cookie);
    int (*mgmt_tx_cancel_wait) (struct wiphy *wiphy,struct net_device *dev,u64 cookie);
    int (*set_power_mgmt) (struct wiphy *wiphy, struct net_device *dev,bool enabled, int timeout);
    int (*set_cqm_rssi_config) (struct wiphy *wiphy,struct net_device *dev,s32 rssi_thold, u32 rssi_hyst);
    void (*mgmt_frame_register) (struct wiphy *wiphy,struct net_device *dev,u16 frame_type, bool reg);
    int (*set_antenna) (struct wiphy *wiphy, u32 tx_ant, u32 rx_ant);
    int (*get_antenna) (struct wiphy *wiphy, u32 *tx_ant, u32 *rx_ant);
    int (*set_ringparam) (struct wiphy *wiphy, u32 tx, u32 rx);
    void (*get_ringparam) (struct wiphy *wiphy,u32 *tx, u32 *tx_max, u32 *rx, u32 *rx_max);
    int (*sched_scan_start) (struct wiphy *wiphy,struct net_device *dev,struct cfg80211_sched_scan_request *request);
    int (*sched_scan_stop) (struct wiphy *wiphy, struct net_device *dev);
    int (*set_rekey_data) (struct wiphy *wiphy, struct net_device *dev,struct cfg80211_gtk_rekey_data *data);
    int (*tdls_mgmt) (struct wiphy *wiphy, struct net_device *dev,u8 *peer, u8 action_code, u8 dialog_token,u16 status_code, const u8 *buf, size_t len);
    int (*tdls_oper) (struct wiphy *wiphy, struct net_device *dev,u8 *peer, enum nl80211_tdls_operation oper);
    int (*probe_client) (struct wiphy *wiphy, struct net_device *dev,const u8 *peer, u64 *cookie);
    int (*set_noack_map) (struct wiphy *wiphy,struct net_device *dev,u16 noack_map);
    struct ieee80211_channel *(*get_channel) (struct wiphy *wiphy);
};

Members

suspend
wiphy device needs to be suspended. The variable wow will be NULL or contain the enabled Wake-on-Wireless triggers that are configured for the device.
resume
wiphy device needs to be resumed
add_virtual_intf
create a new virtual interface with the given name, must set the struct wireless_dev's iftype. Beware: You must create the new netdev in the wiphy's network namespace! Returns the netdev, or an ERR_PTR.
del_virtual_intf
remove the virtual interface determined by ifindex.
change_virtual_intf
change type/configuration of virtual interface, keep the struct wireless_dev's iftype updated.
add_key
add a key with the given parameters. mac_addr will be NULL when adding a group key.
get_key
get information about the key with the given parameters. mac_addr will be NULL when requesting information for a group key. All pointers given to the callback function need not be valid after it returns. This function should return an error if it is not possible to retrieve the key, -ENOENT if it doesn't exist.
del_key
remove a key given the mac_addr (NULL for a group key) and key_index, return -ENOENT if the key doesn't exist.
set_default_key
set the default key on an interface
set_default_mgmt_key
set the default management frame key on an interface
add_beacon
Add a beacon with given parameters, head, interval and dtim_period will be valid, tail is optional.
set_beacon
Change the beacon parameters for an access point mode interface. This should reject the call when no beacon has been configured.
del_beacon
Remove beacon configuration and stop sending the beacon.
add_station
Add a new station.
del_station
Remove a station; mac may be NULL to remove all stations.
change_station
Modify a given station. Note that flags changes are not much validated in cfg80211, in particular the auth/assoc/authorized flags might come to the driver in invalid combinations -- make sure to check them, also against the existing state! Also, supported_rates changes are not checked in station mode -- drivers need to reject (or ignore) them for anything but TDLS peers.
get_station
get station information for the station identified by mac
dump_station
dump station callback -- resume dump at index idx
add_mpath
add a fixed mesh path
del_mpath
delete a given mesh path
change_mpath
change a given mesh path
get_mpath
get a mesh path for the given parameters
dump_mpath
dump mesh path callback -- resume dump at index idx
get_mesh_config
Get the current mesh configuration
update_mesh_config
Update mesh parameters on a running mesh. The mask is a bitfield which tells us which parameters to set, and which to leave alone.
join_mesh
join the mesh network with the specified parameters
leave_mesh
leave the current mesh network
change_bss
Modify parameters for a given BSS.
set_txq_params
Set TX queue parameters
set_channel
Set channel for a given wireless interface. Some devices may support multi-channel operation (by channel hopping) so cfg80211 doesn't verify much. Note, however, that the passed netdev may be NULL as well if the user requested changing the channel for the device itself, or for a monitor interface.
scan
Request to do a scan. If returning zero, the scan request is given the driver, and will be valid until passed to cfg80211_scan_done. For scan results, call cfg80211_inform_bss; you can call this outside the scan/scan_done bracket too.
auth
Request to authenticate with the specified peer
assoc
Request to (re)associate with the specified peer
deauth
Request to deauthenticate from the specified peer
disassoc
Request to disassociate from the specified peer
connect
Connect to the ESS with the specified parameters. When connected, call cfg80211_connect_result with status code WLAN_STATUS_SUCCESS. If the connection fails for some reason, call cfg80211_connect_result with the status from the AP.
disconnect
Disconnect from the BSS/ESS.
join_ibss
Join the specified IBSS (or create if necessary). Once done, call cfg80211_ibss_joined, also call that function when changing BSSID due to a merge.
leave_ibss
Leave the IBSS.
set_wiphy_params
Notify that wiphy parameters have changed; changed bitfield (see enum wiphy_params_flags) describes which values have changed. The actual parameter values are available in struct wiphy. If returning an error, no value should be changed.
set_tx_power
set the transmit power according to the parameters, the power passed is in mBm, to get dBm use MBM_TO_DBM.
get_tx_power
store the current TX power into the dbm variable; return 0 if successful
set_wds_peer
set the WDS peer for a WDS interface
rfkill_poll
polls the hw rfkill line, use cfg80211 reporting functions to adjust rfkill hw state
testmode_cmd
run a test mode command
testmode_dump
Implement a test mode dump. The cb->args[2] and up may be used by the function, but 0 and 1 must not be touched. Additionally, return error codes other than -ENOBUFS and -ENOENT will terminate the dump and return to userspace with an error, so be careful. If any data was passed in from userspace then the data/len arguments will be present and point to the data contained in NL80211_ATTR_TESTDATA.
set_bitrate_mask
set the bitrate mask configuration
dump_survey
get site survey information.
set_pmksa
Cache a PMKID for a BSSID. This is mostly useful for fullmac devices running firmwares capable of generating the (re) association RSN IE. It allows for faster roaming between WPA2 BSSIDs.
del_pmksa
Delete a cached PMKID.
flush_pmksa
Flush all cached PMKIDs.
remain_on_channel
Request the driver to remain awake on the specified channel for the specified duration to complete an off-channel operation (e.g., public action frame exchange). When the driver is ready on the requested channel, it must indicate this with an event notification by calling cfg80211_ready_on_channel.
cancel_remain_on_channel
Cancel an on-going remain-on-channel operation. This allows the operation to be terminated prior to timeout based on the duration value.
mgmt_tx
Transmit a management frame.
mgmt_tx_cancel_wait
Cancel the wait time from transmitting a management frame on another channel
set_power_mgmt
Configure WLAN power management. A timeout value of -1 allows the driver to adjust the dynamic ps timeout value.
set_cqm_rssi_config
Configure connection quality monitor RSSI threshold.
mgmt_frame_register
Notify driver that a management frame type was registered. Note that this callback may not sleep, and cannot run concurrently with itself.
set_antenna
Set antenna configuration (tx_ant, rx_ant) on the device. Parameters are bitmaps of allowed antennas to use for TX/RX. Drivers may reject TX/RX mask combinations they cannot support by returning -EINVAL (also see nl80211.h NL80211_ATTR_WIPHY_ANTENNA_TX).
get_antenna
Get current antenna configuration from device (tx_ant, rx_ant).
set_ringparam
Set tx and rx ring sizes.
get_ringparam
Get tx and rx ring current and maximum sizes.
sched_scan_start
Tell the driver to start a scheduled scan.
sched_scan_stop
Tell the driver to stop an ongoing scheduled scan. The driver_initiated flag specifies whether the driver itself has informed that the scan has stopped.
set_rekey_data
give the data necessary for GTK rekeying to the driver
tdls_mgmt
Transmit a TDLS management frame.
tdls_oper
Perform a high-level TDLS operation (e.g. TDLS link setup).
probe_client
probe an associated client, must return a cookie that it later passes to cfg80211_probe_status.
set_noack_map
Set the NoAck Map for the TIDs.
get_channel
Get the current operating channel, should return NULL if there's no single defined operating channel if for example the device implements channel hopping for multi-channel virtual interfaces.

Description

This struct is registered by fullmac card drivers and/or wireless stacks in order to handle configuration requests on their interfaces.

All callbacks except where otherwise noted should return 0 on success or a negative error code.

All operations are currently invoked under rtnl for consistency with the wireless extensions but this is subject to reevaluation as soon as this code is used more widely and we have a first user without wext.


enum wiphy_flags

enum wiphy_flags {
WIPHY_FLAG_CUSTOM_REGULATORY,
WIPHY_FLAG_STRICT_REGULATORY,
WIPHY_FLAG_DISABLE_BEACON_HINTS,
WIPHY_FLAG_NETNS_OK,
WIPHY_FLAG_PS_ON_BY_DEFAULT,
WIPHY_FLAG_4ADDR_AP,
WIPHY_FLAG_4ADDR_STATION,
WIPHY_FLAG_CONTROL_PORT_PROTOCOL,
WIPHY_FLAG_IBSS_RSN,
WIPHY_FLAG_MESH_AUTH,
WIPHY_FLAG_SUPPORTS_SCHED_SCAN,
WIPHY_FLAG_ENFORCE_COMBINATIONS,
WIPHY_FLAG_SUPPORTS_FW_ROAM,
WIPHY_FLAG_AP_UAPSD,
WIPHY_FLAG_SUPPORTS_TDLS,
WIPHY_FLAG_TDLS_EXTERNAL_SETUP,
WIPHY_FLAG_HAVE_AP_SME,
WIPHY_FLAG_REPORTS_OBSS,
WIPHY_FLAG_AP_PROBE_RESP_OFFLOAD,
WIPHY_FLAG_OFFCHAN_TX,
WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL
};

Constants

WIPHY_FLAG_CUSTOM_REGULATORY
tells us the driver for this device has its own custom regulatory domain and cannot identify the ISO / IEC 3166 alpha2 it belongs to. When this is enabled we will disregard the first regulatory hint (when the initiator is REGDOM_SET_BY_CORE).
WIPHY_FLAG_STRICT_REGULATORY
tells us the driver for this device will ignore regulatory domain settings until it gets its own regulatory domain via its regulatory_hint unless the regulatory hint is from a country IE. After its gets its own regulatory domain it will only allow further regulatory domain settings to further enhance compliance. For example if channel 13 and 14 are disabled by this regulatory domain no user regulatory domain can enable these channels at a later time. This can be used for devices which do not have calibration information guaranteed for frequencies or settings outside of its regulatory domain. If used in combination with WIPHY_FLAG_CUSTOM_REGULATORY the inspected country IE power settings will be followed.
WIPHY_FLAG_DISABLE_BEACON_HINTS
enable this if your driver needs to ensure that passive scan flags and beaconing flags may not be lifted by cfg80211 due to regulatory beacon hints. For more information on beacon hints read the documenation for regulatory_hint_found_beacon
WIPHY_FLAG_NETNS_OK
if not set, do not allow changing the netns of this wiphy at all
WIPHY_FLAG_PS_ON_BY_DEFAULT
if set to true, powersave will be enabled by default -- this flag will be set depending on the kernel's default on wiphy_new, but can be changed by the driver if it has a good reason to override the default
WIPHY_FLAG_4ADDR_AP
supports 4addr mode even on AP (with a single station on a VLAN interface)
WIPHY_FLAG_4ADDR_STATION
supports 4addr mode even as a station
WIPHY_FLAG_CONTROL_PORT_PROTOCOL
This device supports setting the control port protocol ethertype. The device also honours the control_port_no_encrypt flag.
WIPHY_FLAG_IBSS_RSN
The device supports IBSS RSN.
WIPHY_FLAG_MESH_AUTH
The device supports mesh authentication by routing auth frames to userspace. See NL80211_MESH_SETUP_USERSPACE_AUTH.
WIPHY_FLAG_SUPPORTS_SCHED_SCAN
The device supports scheduled scans.
WIPHY_FLAG_ENFORCE_COMBINATIONS
Set this flag to enforce interface combinations for this device. This flag is used for backward compatibility only until all drivers advertise combinations and they will always be enforced.
WIPHY_FLAG_SUPPORTS_FW_ROAM
The device supports roaming feature in the firmware.
WIPHY_FLAG_AP_UAPSD
The device supports uapsd on AP.
WIPHY_FLAG_SUPPORTS_TDLS
The device supports TDLS (802.11z) operation.
WIPHY_FLAG_TDLS_EXTERNAL_SETUP
The device does not handle TDLS (802.11z) link setup/discovery operations internally. Setup, discovery and teardown packets should be sent through the NL80211_CMD_TDLS_MGMT command. When this flag is not set, NL80211_CMD_TDLS_OPER should be used for asking the driver/firmware to perform a TDLS operation.
WIPHY_FLAG_HAVE_AP_SME
device integrates AP SME
WIPHY_FLAG_REPORTS_OBSS
the device will report beacons from other BSSes when there are virtual interfaces in AP mode by calling cfg80211_report_obss_beacon.
WIPHY_FLAG_AP_PROBE_RESP_OFFLOAD
When operating as an AP, the device responds to probe-requests in hardware.
WIPHY_FLAG_OFFCHAN_TX
Device supports direct off-channel TX.
WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL
Device supports remain-on-channel call.

struct ieee80211_iface_limit - limit on certain interface types

struct ieee80211_iface_limit {
    u16 max;
    u16 types;
};

Members

max
maximum number of interfaces of these types
types
interface types (bits)

struct ieee80211_iface_combination - possible interface combination

struct ieee80211_iface_combination {
    const struct ieee80211_iface_limit * limits;
    u32 num_different_channels;
    u16 max_interfaces;
    u8 n_limits;
    bool beacon_int_infra_match;
};

Members

limits
limits for the given interface types
num_different_channels
can use up to this many different channels
max_interfaces
maximum number of interfaces in total allowed in this group
n_limits
number of limitations
beacon_int_infra_match
In this combination, the beacon intervals between infrastructure and AP types must match. This is required only in special cases.

These examples can be expressed as follows

Allow #STA <= 1, #AP <= 1, matching BI, channels = 1, 2 total:

struct ieee80211_iface_limit limits1[] = { { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), }, { .max = 1, .types = BIT(NL80211_IFTYPE_AP}, }, }; struct ieee80211_iface_combination combination1 = { .limits = limits1, .n_limits = ARRAY_SIZE(limits1), .max_interfaces = 2, .beacon_int_infra_match = true, };

Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:

struct ieee80211_iface_limit limits2[] = { { .max = 8, .types = BIT(NL80211_IFTYPE_AP) | BIT(NL80211_IFTYPE_P2P_GO), }, }; struct ieee80211_iface_combination combination2 = { .limits = limits2, .n_limits = ARRAY_SIZE(limits2), .max_interfaces = 8, .num_different_channels = 1, };

Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total. This allows for an infrastructure connection and three P2P connections.

struct ieee80211_iface_limit limits3[] = { { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), }, { .max = 3, .types = BIT(NL80211_IFTYPE_P2P_GO) | BIT(NL80211_IFTYPE_P2P_CLIENT), }, }; struct ieee80211_iface_combination combination3 = { .limits = limits3, .n_limits = ARRAY_SIZE(limits3), .max_interfaces = 4, .num_different_channels = 2, };


enum wiphy_wowlan_support_flags

enum wiphy_wowlan_support_flags {
WIPHY_WOWLAN_ANY,
WIPHY_WOWLAN_MAGIC_PKT,
WIPHY_WOWLAN_DISCONNECT,
WIPHY_WOWLAN_SUPPORTS_GTK_REKEY,
WIPHY_WOWLAN_GTK_REKEY_FAILURE,
WIPHY_WOWLAN_EAP_IDENTITY_REQ,
WIPHY_WOWLAN_4WAY_HANDSHAKE,
WIPHY_WOWLAN_RFKILL_RELEASE
};

Constants

WIPHY_WOWLAN_ANY
supports wakeup for the special "any" trigger that keeps the device operating as-is and wakes up the host on any activity, for example a received packet that passed filtering; note that the packet should be preserved in that case
WIPHY_WOWLAN_MAGIC_PKT
supports wakeup on magic packet (see nl80211.h)
WIPHY_WOWLAN_DISCONNECT
supports wakeup on disconnect
WIPHY_WOWLAN_SUPPORTS_GTK_REKEY
supports GTK rekeying while asleep
WIPHY_WOWLAN_GTK_REKEY_FAILURE
supports wakeup on GTK rekey failure
WIPHY_WOWLAN_EAP_IDENTITY_REQ
supports wakeup on EAP identity request
WIPHY_WOWLAN_4WAY_HANDSHAKE
supports wakeup on 4-way handshake failure
WIPHY_WOWLAN_RFKILL_RELEASE
supports wakeup on RF-kill release

struct wiphy_wowlan_support - WoWLAN support data

struct wiphy_wowlan_support {
    u32 flags;
    int n_patterns;
    int pattern_max_len;
    int pattern_min_len;
};

Members

flags
see enum wiphy_wowlan_support_flags
n_patterns
number of supported wakeup patterns (see nl80211.h for the pattern definition)
pattern_max_len
maximum length of each pattern
pattern_min_len
minimum length of each pattern

struct wiphy - wireless hardware description

struct wiphy {
    u8 perm_addr[ETH_ALEN];
    u8 addr_mask[ETH_ALEN];
    struct mac_address * addresses;
    const struct ieee80211_txrx_stypes * mgmt_stypes;
    const struct ieee80211_iface_combination * iface_combinations;
    int n_iface_combinations;
    u16 software_iftypes;
    u16 n_addresses;
    u16 interface_modes;
    u32 flags;
    u32 features;
    u32 ap_sme_capa;
    enum cfg80211_signal_type signal_type;
    int bss_priv_size;
    u8 max_scan_ssids;
    u8 max_sched_scan_ssids;
    u8 max_match_sets;
    u16 max_scan_ie_len;
    u16 max_sched_scan_ie_len;
    int n_cipher_suites;
    const u32 * cipher_suites;
    u8 retry_short;
    u8 retry_long;
    u32 frag_threshold;
    u32 rts_threshold;
    u8 coverage_class;
    char fw_version[ETHTOOL_BUSINFO_LEN];
    u32 hw_version;
    struct wiphy_wowlan_support wowlan;
    u16 max_remain_on_channel_duration;
    u8 max_num_pmkids;
    u32 available_antennas_tx;
    u32 available_antennas_rx;
    u32 probe_resp_offload;
    const void * privid;
    struct ieee80211_supported_band * bands[IEEE80211_NUM_BANDS];
    int (*reg_notifier) (struct wiphy *wiphy,struct regulatory_request *request);
    const struct ieee80211_regdomain * regd;
    struct device dev;
    bool registered;
    struct dentry * debugfsdir;
    const struct ieee80211_ht_cap * ht_capa_mod_mask;
#ifdef CONFIG_NET_NS
    struct net * _net;
#endif
#ifdef CONFIG_CFG80211_WEXT
    const struct iw_handler_def * wext;
#endif
    char priv[0] __attribute__((__aligned__(NETDEV_ALIGN)));
};

Members

perm_addr[ETH_ALEN]
permanent MAC address of this device
addr_mask[ETH_ALEN]
If the device supports multiple MAC addresses by masking, set this to a mask with variable bits set to 1, e.g. if the last
addresses
If the device has more than one address, set this pointer to a list of addresses (6 bytes each). The first one will be used by default for perm_addr. In this case, the mask should be set to all-zeroes. In this case it is assumed that the device can handle the same number of arbitrary MAC addresses.
mgmt_stypes
bitmasks of frame subtypes that can be subscribed to or transmitted through nl80211, points to an array indexed by interface type
iface_combinations
Valid interface combinations array, should not list single interface types.
n_iface_combinations
number of entries in iface_combinations array.
software_iftypes
bitmask of software interface types, these are not subject to any restrictions since they are purely managed in SW.
n_addresses
number of addresses in addresses.
interface_modes
bitmask of interfaces types valid for this wiphy, must be set by driver
flags
wiphy flags, see enum wiphy_flags
features
features advertised to nl80211, see enum nl80211_feature_flags.
ap_sme_capa
AP SME capabilities, flags from enum nl80211_ap_sme_features.
signal_type
signal type reported in struct cfg80211_bss.
bss_priv_size
each BSS struct has private data allocated with it, this variable determines its size
max_scan_ssids
maximum number of SSIDs the device can scan for in any given scan
max_sched_scan_ssids
maximum number of SSIDs the device can scan for in any given scheduled scan
max_match_sets
maximum number of match sets the device can handle when performing a scheduled scan, 0 if filtering is not supported.
max_scan_ie_len
maximum length of user-controlled IEs device can add to probe request frames transmitted during a scan, must not include fixed IEs like supported rates
max_sched_scan_ie_len
same as max_scan_ie_len, but for scheduled scans
n_cipher_suites
number of supported cipher suites
cipher_suites
supported cipher suites
retry_short
Retry limit for short frames (dot11ShortRetryLimit)
retry_long
Retry limit for long frames (dot11LongRetryLimit)
frag_threshold
Fragmentation threshold (dot11FragmentationThreshold); -1 = fragmentation disabled, only odd values >= 256 used
rts_threshold
RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
coverage_class
current coverage class
fw_version[ETHTOOL_BUSINFO_LEN]
firmware version for ethtool reporting
hw_version
hardware version for ethtool reporting
wowlan
WoWLAN support information
max_remain_on_channel_duration
Maximum time a remain-on-channel operation may request, if implemented.
max_num_pmkids
maximum number of PMKIDs supported by device
available_antennas_tx
bitmap of antennas which are available to be configured as TX antennas. Antenna configuration commands will be rejected unless this or available_antennas_rx is set.
available_antennas_rx
bitmap of antennas which are available to be configured as RX antennas. Antenna configuration commands will be rejected unless this or available_antennas_tx is set.
probe_resp_offload
Bitmap of supported protocols for probe response offloading. See enum nl80211_probe_resp_offload_support_attr. Only valid when the wiphy flag WIPHY_FLAG_AP_PROBE_RESP_OFFLOAD is set.
privid
a pointer that drivers can use to identify if an arbitrary wiphy is theirs, e.g. in global notifiers
bands[IEEE80211_NUM_BANDS]
information about bands/channels supported by this device
reg_notifier
the driver's regulatory notification callback, note that if your driver uses wiphy_apply_custom_regulatory the reg_notifier's request can be passed as NULL
regd
the driver's regulatory domain, if one was requested via the regulatory_hint API. This can be used by the driver on the reg_notifier if it chooses to ignore future regulatory domain changes caused by other drivers.
dev
(virtual) struct device for this wiphy
registered
helps synchronize suspend/resume with wiphy unregister
debugfsdir
debugfs directory used for this wiphy, will be renamed automatically on wiphy renames
ht_capa_mod_mask
Specify what ht_cap values can be over-ridden. If null, then none can be over-ridden.
_net
the network namespace this wiphy currently lives in
wext
wireless extension handlers
priv[0] __attribute__((__aligned__(NETDEV_ALIGN)))
driver private data (sized according to wiphy_new parameter)

four bits are variable then set it to 00

...:00:0f. The actual variable bits shall be determined by the interfaces added, with interfaces not matching the mask being rejected to be brought up.

wiphy_priv - return priv from wiphy

void * wiphy_priv (struct wiphy * wiphy)

Arguments

wiphy
the wiphy whose priv pointer to return

priv_to_wiphy - return the wiphy containing the priv

struct wiphy * priv_to_wiphy (void * priv)

Arguments

priv
a pointer previously returned by wiphy_priv

set_wiphy_dev - set device pointer for wiphy

void set_wiphy_dev (struct wiphy * wiphy, struct device * dev)

Arguments

wiphy
The wiphy whose device to bind
dev
The device to parent it to

wiphy_dev - get wiphy dev pointer

struct device * wiphy_dev (struct wiphy * wiphy)

Arguments

wiphy
The wiphy whose device struct to look up

wiphy_name - get wiphy name

const char * wiphy_name (const struct wiphy * wiphy)

Arguments

wiphy
The wiphy whose name to return

wiphy_new - create a new wiphy for use with cfg80211

struct wiphy * wiphy_new (const struct cfg80211_ops * ops, int sizeof_priv)

Arguments

ops
The configuration operations for this device
sizeof_priv
The size of the private area to allocate

Description

Create a new wiphy and associate the given operations with it. sizeof_priv bytes are allocated for private use.

The returned pointer must be assigned to each netdev's ieee80211_ptr for proper operation.


wiphy_register - register a wiphy with cfg80211

int wiphy_register (struct wiphy * wiphy)

Arguments

wiphy
The wiphy to register.

Description

Returns a non-negative wiphy index or a negative error code.

wiphy_unregister - deregister a wiphy from cfg80211

void wiphy_unregister (struct wiphy * wiphy)

Arguments

wiphy
The wiphy to unregister.

Description

After this call, no more requests can be made with this priv pointer, but the call may sleep to wait for an outstanding request that is being handled.

wiphy_free - free wiphy

void wiphy_free (struct wiphy * wiphy)

Arguments

wiphy
The wiphy to free

struct wireless_dev - wireless per-netdev state

struct wireless_dev {
    struct wiphy * wiphy;
    enum nl80211_iftype iftype;
    struct list_head list;
    struct net_device * netdev;
    struct list_head mgmt_registrations;
    spinlock_t mgmt_registrations_lock;
    struct mutex mtx;
    struct work_struct cleanup_work;
    bool use_4addr;
    u8 ssid[IEEE80211_MAX_SSID_LEN];
    u8 ssid_len;
    u8 mesh_id_len;
    u8 mesh_id_up_len;
    enum wext;
#endif
};

Members

wiphy
pointer to hardware description
iftype
interface type
list
(private) Used to collect the interfaces
netdev
(private) Used to reference back to the netdev
mgmt_registrations
list of registrations for management frames
mgmt_registrations_lock
lock for the list
mtx
mutex used to lock data in this struct
cleanup_work
work struct used for cleanup that can't be done directly
use_4addr
indicates 4addr mode is used on this interface, must be set by driver (if supported) on add_interface BEFORE registering the netdev and may otherwise be used by driver read-only, will be update by cfg80211 on change_interface
ssid[IEEE80211_MAX_SSID_LEN]
(private) Used by the internal configuration code
ssid_len
(private) Used by the internal configuration code
mesh_id_len
(private) Used by the internal configuration code
mesh_id_up_len
(private) Used by the internal configuration code
wext
(private) Used by the internal wireless extensions compat code

Description

This structure must be allocated by the driver/stack that uses the ieee80211_ptr field in struct net_device (this is intentional so it can be allocated along with the netdev.)


wdev_priv - return wiphy priv from wireless_dev

void * wdev_priv (struct wireless_dev * wdev)

Arguments

wdev
The wireless device whose wiphy's priv pointer to return

Utility functions

    cfg80211 offers a number of utility functions that can be useful.


ieee80211_channel_to_frequency - convert channel number to frequency

int ieee80211_channel_to_frequency (int chan, enum ieee80211_band band)

Arguments

chan
channel number
band
band, necessary due to channel number overlap

ieee80211_frequency_to_channel - convert frequency to channel number

int ieee80211_frequency_to_channel (int freq)

Arguments

freq
center frequency

ieee80211_get_channel - get channel struct from wiphy for specified frequency

struct ieee80211_channel * ieee80211_get_channel (struct wiphy * wiphy, int freq)

Arguments

wiphy
the struct wiphy to get the channel for
freq
the center frequency of the channel

ieee80211_get_response_rate - get basic rate for a given rate

struct ieee80211_rate * ieee80211_get_response_rate (struct ieee80211_supported_band * sband, u32 basic_rates, int bitrate)

Arguments

sband
the band to look for rates in
basic_rates
bitmap of basic rates
bitrate
the bitrate for which to find the basic rate

Description

This function returns the basic rate corresponding to a given bitrate, that is the next lower bitrate contained in the basic rate map, which is, for this function, given as a bitmap of indices of rates in the band's bitrate table.

struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args

struct ieee80211_radiotap_iterator {
    struct ieee80211_radiotap_header * _rtheader;
    const struct ieee80211_radiotap_vendor_namespaces * _vns;
    const struct ieee80211_radiotap_namespace * current_namespace;
    unsigned char * _arg;
    unsigned char * _next_ns_data;
    __le32 * _next_bitmap;
    unsigned char * this_arg;
    int this_arg_index;
    int this_arg_size;
    int is_radiotap_ns;
    int _max_length;
    int _arg_index;
    uint32_t _bitmap_shifter;
    int _reset_on_ext;
};

Members

_rtheader
pointer to the radiotap header we are walking through
_vns
vendor namespace definitions
current_namespace
pointer to the current namespace definition (or internally NULL if the current namespace is unknown)
_arg
next argument pointer
_next_ns_data
beginning of the next namespace's data
_next_bitmap
internal pointer to next present u32
this_arg
pointer to current radiotap arg; it is valid after each call to ieee80211_radiotap_iterator_next but also after ieee80211_radiotap_iterator_init where it will point to the beginning of the actual data portion
this_arg_index
index of current arg, valid after each successful call to ieee80211_radiotap_iterator_next
this_arg_size
length of the current arg, for convenience
is_radiotap_ns
indicates whether the current namespace is the default radiotap namespace or not
_max_length
length of radiotap header in cpu byte ordering
_arg_index
next argument index
_bitmap_shifter
internal shifter for curr u32 bitmap, b0 set == arg present
_reset_on_ext
internal; reset the arg index to 0 when going to the next bitmap word

Description

Describes the radiotap parser state. Fields prefixed with an underscore must not be used by users of the parser, only by the parser internally.

ieee80211_get_hdrlen_from_skb - get header length from data

unsigned int ieee80211_get_hdrlen_from_skb (const struct sk_buff * skb)

Arguments

skb
the frame

Description

Given an skb with a raw 802.11 header at the data pointer this function returns the 802.11 header length in bytes (not including encryption headers). If the data in the sk_buff is too short to contain a valid 802.11 header the function returns 0.


ieee80211_hdrlen - get header length in bytes from frame control

unsigned int __attribute_const__ ieee80211_hdrlen (__le16 fc)

Arguments

fc
frame control field in little-endian format

Data path helpers

    In addition to generic utilities, cfg80211 also offers functions that help implement the data path for devices that do not do the 802.11/802.3 conversion on the device.


ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3

int ieee80211_data_to_8023 (struct sk_buff * skb, const u8 * addr, enum nl80211_iftype iftype)

Arguments

skb
the 802.11 data frame
addr
the device MAC address
iftype
the virtual interface type

ieee80211_data_from_8023 - convert an 802.3 frame to 802.11

int ieee80211_data_from_8023 (struct sk_buff * skb, const u8 * addr, enum nl80211_iftype iftype, u8 * bssid, bool qos)

Arguments

skb
the 802.3 frame
addr
the device MAC address
iftype
the virtual interface type
bssid
the network bssid (used only for iftype STATION and ADHOC)
qos
build 802.11 QoS data frame

ieee80211_amsdu_to_8023s - decode an IEEE 802.11n A-MSDU frame

void ieee80211_amsdu_to_8023s (struct sk_buff * skb, struct sk_buff_head * list, const u8 * addr, enum nl80211_iftype iftype, const unsigned int extra_headroom, bool has_80211_header)

Arguments

skb
The input IEEE 802.11n A-MSDU frame.
list
The output list of 802.3 frames. It must be allocated and initialized by by the caller.
addr
The device MAC address.
iftype
The device interface type.
extra_headroom
The hardware extra headroom for SKBs in the list.
has_80211_header
Set it true if SKB is with IEEE 802.11 header.

Description

Decode an IEEE 802.11n A-MSDU frame and convert it to a list of 802.3 frames. The list will be empty if the decode fails. The skb is consumed after the function returns.


cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame

unsigned int cfg80211_classify8021d (struct sk_buff * skb)

Arguments

skb
the data frame

cfg80211_find_ie - find information element in data

const u8 * cfg80211_find_ie (u8 eid, const u8 * ies, int len)

Arguments

eid
element ID
ies
data consisting of IEs
len
length of data

Description

This function will return NULL if the element ID could not be found or if the element is invalid (claims to be longer than the given data), or a pointer to the first byte of the requested element, that is the byte containing the element ID. There are no checks on the element length other than having to fit into the given data.

cfg80211_find_vendor_ie - find vendor specific information element in data

const u8 * cfg80211_find_vendor_ie (unsigned int oui, u8 oui_type, const u8 * ies, int len)

Arguments

oui
vendor OUI
oui_type
vendor-specific OUI type
ies
data consisting of IEs
len
length of data

Description

This function will return NULL if the vendor specific element ID could not be found or if the element is invalid (claims to be longer than the given data), or a pointer to the first byte of the requested element, that is the byte containing the element ID. There are no checks on the element length other than having to fit into the given data.

Regulatory enforcement infrastructure

    TODO


regulatory_hint - driver hint to the wireless core a regulatory domain

int regulatory_hint (struct wiphy * wiphy, const char * alpha2)

Arguments

wiphy
the wireless device giving the hint (used only for reporting conflicts)
alpha2
the ISO/IEC 3166 alpha2 the driver claims its regulatory domain should be in. If rd is set this should be NULL. Note that if you set this to NULL you should still set rd->alpha2 to some accepted alpha2.

Description

Wireless drivers can use this function to hint to the wireless core what it believes should be the current regulatory domain by giving it an ISO/IEC 3166 alpha2 country code it knows its regulatory domain should be in or by providing a completely build regulatory domain. If the driver provides an ISO/IEC 3166 alpha2 userspace will be queried for a regulatory domain structure for the respective country.

The wiphy must have been registered to cfg80211 prior to this call. For cfg80211 drivers this means you must first use wiphy_register, for mac80211 drivers you must first use ieee80211_register_hw.

Drivers should check the return value, its possible you can get an -ENOMEM.


wiphy_apply_custom_regulatory - apply a custom driver regulatory domain

void wiphy_apply_custom_regulatory (struct wiphy * wiphy, const struct ieee80211_regdomain * regd)

Arguments

wiphy
the wireless device we want to process the regulatory domain on
regd
the custom regulatory domain to use for this wiphy

Description

Drivers can sometimes have custom regulatory domains which do not apply to a specific country. Drivers can use this to apply such custom regulatory domains. This routine must be called prior to wiphy registration. The custom regulatory domain will be trusted completely and as such previous default channel settings will be disregarded. If no rule is found for a channel on the regulatory domain the channel will be disabled.

freq_reg_info - get regulatory information for the given frequency

int freq_reg_info (struct wiphy * wiphy, u32 center_freq, u32 desired_bw_khz, const struct ieee80211_reg_rule ** reg_rule)

Arguments

wiphy
the wiphy for which we want to process this rule for
center_freq
Frequency in KHz for which we want regulatory information for
desired_bw_khz
the desired max bandwidth you want to use per channel. Note that this is still 20 MHz if you want to use HT40 as HT40 makes use of two channels for its 40 MHz width bandwidth. If set to 0 we'll assume you want the standard 20 MHz.
reg_rule
the regulatory rule which we have for this frequency

Description

Use this function to get the regulatory rule for a specific frequency on a given wireless device. If the device has a specific regulatory domain it wants to follow we respect that unless a country IE has been received and processed already.

Returns 0 if it was able to find a valid regulatory rule which does apply to the given center_freq otherwise it returns non-zero. It will also return -ERANGE if we determine the given center_freq does not even have a regulatory rule for a frequency range in the center_freq's band. See freq_in_rule_band for our current definition of a band -- this is purely subjective and right now its 802.11 specific.


cfg80211_scan_done - notify that scan finished

void cfg80211_scan_done (struct cfg80211_scan_request * request, bool aborted)

Arguments

request
the corresponding scan request
aborted
set to true if the scan was aborted for any reason, userspace will be notified of that

cfg80211_sched_scan_results - notify that new scan results are available

void cfg80211_sched_scan_results (struct wiphy * wiphy)

Arguments

wiphy
the wiphy which got scheduled scan results

cfg80211_sched_scan_stopped - notify that the scheduled scan has stopped

void cfg80211_sched_scan_stopped (struct wiphy * wiphy)

Arguments

wiphy
the wiphy on which the scheduled scan stopped

Description

The driver can call this function to inform cfg80211 that the scheduled scan had to be stopped, for whatever reason. The driver is then called back via the sched_scan_stop operation when done.

cfg80211_inform_bss_frame - inform cfg80211 of a received BSS frame

struct cfg80211_bss * cfg80211_inform_bss_frame (struct wiphy * wiphy, struct ieee80211_channel * channel, struct ieee80211_mgmt * mgmt, size_t len, s32 signal, gfp_t gfp)

Arguments

wiphy
the wiphy reporting the BSS
channel
The channel the frame was received on
mgmt
the management frame (probe response or beacon)
len
length of the management frame
signal
the signal strength, type depends on the wiphy's signal_type
gfp
context flags

Description

This informs cfg80211 that BSS information was found and the BSS should be updated/added.

NOTE

Returns a referenced struct, must be released with cfg80211_put_bss!

cfg80211_inform_bss - inform cfg80211 of a new BSS

struct cfg80211_bss * cfg80211_inform_bss (struct wiphy * wiphy, struct ieee80211_channel * channel, const u8 * bssid, u64 timestamp, u16 capability, u16 beacon_interval, const u8 * ie, size_t ielen, s32 signal, gfp_t gfp)

Arguments

wiphy
the wiphy reporting the BSS
channel
The channel the frame was received on
bssid
the BSSID of the BSS
timestamp
the TSF timestamp sent by the peer
capability
the capability field sent by the peer
beacon_interval
the beacon interval announced by the peer
ie
additional IEs sent by the peer
ielen
length of the additional IEs
signal
the signal strength, type depends on the wiphy's signal_type
gfp
context flags

Description

This informs cfg80211 that BSS information was found and the BSS should be updated/added.

NOTE

Returns a referenced struct, must be released with cfg80211_put_bss!

cfg80211_ref_bss - reference BSS struct

void cfg80211_ref_bss (struct cfg80211_bss * bss)

Arguments

bss
the BSS struct to reference

Description

Increments the refcount of the given BSS struct.

cfg80211_put_bss - unref BSS struct

void cfg80211_put_bss (struct cfg80211_bss * bss)

Arguments

bss
the BSS struct

Description

Decrements the refcount of the given BSS struct.

cfg80211_unlink_bss - unlink BSS from internal data structures

void cfg80211_unlink_bss (struct wiphy * wiphy, struct cfg80211_bss * bss)

Arguments

wiphy
the wiphy
bss
the bss to remove

Description

This function removes the given BSS from the internal data structures thereby making it no longer show up in scan results etc. Use this function when you detect a BSS is gone. Normally BSSes will also time out, so it is not necessary to use this function at all.

cfg80211_send_rx_auth - notification of processed authentication

void cfg80211_send_rx_auth (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
authentication frame (header + body)
len
length of the frame data

Description

This function is called whenever an authentication has been processed in station mode. The driver is required to call either this function or cfg80211_send_auth_timeout to indicate the result of cfg80211_ops::auth call. This function may sleep.

cfg80211_send_auth_timeout - notification of timed out authentication

void cfg80211_send_auth_timeout (struct net_device * dev, const u8 * addr)

Arguments

dev
network device
addr
The MAC address of the device with which the authentication timed out

Description

This function may sleep.

cfg80211_send_rx_assoc - notification of processed association

void cfg80211_send_rx_assoc (struct net_device * dev, struct cfg80211_bss * bss, const u8 * buf, size_t len)

Arguments

dev
network device
bss
the BSS struct association was requested for, the struct reference is owned by cfg80211 after this call
buf
(re)association response frame (header + body)
len
length of the frame data

Description

This function is called whenever a (re)association response has been processed in station mode. The driver is required to call either this function or cfg80211_send_assoc_timeout to indicate the result of

cfg80211_ops

:assoc call. This function may sleep.

cfg80211_send_assoc_timeout - notification of timed out association

void cfg80211_send_assoc_timeout (struct net_device * dev, const u8 * addr)

Arguments

dev
network device
addr
The MAC address of the device with which the association timed out

Description

This function may sleep.

cfg80211_send_deauth - notification of processed deauthentication

void cfg80211_send_deauth (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
deauthentication frame (header + body)
len
length of the frame data

Description

This function is called whenever deauthentication has been processed in station mode. This includes both received deauthentication frames and locally generated ones. This function may sleep.

__cfg80211_send_deauth - notification of processed deauthentication

void __cfg80211_send_deauth (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
deauthentication frame (header + body)
len
length of the frame data

Description

Like cfg80211_send_deauth, but doesn't take the wdev lock.

cfg80211_send_disassoc - notification of processed disassociation

void cfg80211_send_disassoc (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
disassociation response frame (header + body)
len
length of the frame data

Description

This function is called whenever disassociation has been processed in station mode. This includes both received disassociation frames and locally generated ones. This function may sleep.

__cfg80211_send_disassoc - notification of processed disassociation

void __cfg80211_send_disassoc (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
disassociation response frame (header + body)
len
length of the frame data

Description

Like cfg80211_send_disassoc, but doesn't take the wdev lock.

cfg80211_send_unprot_deauth - notification of unprotected deauthentication

void cfg80211_send_unprot_deauth (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
deauthentication frame (header + body)
len
length of the frame data

Description

This function is called whenever a received Deauthentication frame has been dropped in station mode because of MFP being used but the Deauthentication frame was not protected. This function may sleep.

cfg80211_send_unprot_disassoc - notification of unprotected disassociation

void cfg80211_send_unprot_disassoc (struct net_device * dev, const u8 * buf, size_t len)

Arguments

dev
network device
buf
disassociation frame (header + body)
len
length of the frame data

Description

This function is called whenever a received Disassociation frame has been dropped in station mode because of MFP being used but the Disassociation frame was not protected. This function may sleep.

cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)

void cfg80211_michael_mic_failure (struct net_device * dev, const u8 * addr, enum nl80211_key_type key_type, int key_id, const u8 * tsc, gfp_t gfp)

Arguments

dev
network device
addr
The source MAC address of the frame
key_type
The key type that the received frame used
key_id
Key identifier (0..3). Can be -1 if missing.
tsc
The TSC value of the frame that generated the MIC failure (6 octets)
gfp
allocation flags

Description

This function is called whenever the local MAC detects a MIC failure in a received frame. This matches with MLME-MICHAELMICFAILURE.indication primitive.

cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS

void cfg80211_ibss_joined (struct net_device * dev, const u8 * bssid, gfp_t gfp)

Arguments

dev
network device
bssid
the BSSID of the IBSS joined
gfp
allocation flags

Description

This function notifies cfg80211 that the device joined an IBSS or switched to a different BSSID. Before this function can be called, either a beacon has to have been received from the IBSS, or one of the cfg80211_inform_bss{,_frame} functions must have been called with the locally generated beacon -- this guarantees that there is always a scan result for this IBSS. cfg80211 will handle the rest.

cfg80211_notify_new_peer_candidate - notify cfg80211 of a new mesh peer candidate

void cfg80211_notify_new_peer_candidate (struct net_device * dev, const u8 * macaddr, const u8 * ie, u8 ie_len, gfp_t gfp)

Arguments

dev
network device
macaddr
the MAC address of the new candidate
ie
information elements advertised by the peer candidate
ie_len
lenght of the information elements buffer
gfp
allocation flags

Description

This function notifies cfg80211 that the mesh peer candidate has been detected, most likely via a beacon or, less likely, via a probe response. cfg80211 then sends a notification to userspace.

RFkill integration

    RFkill integration in cfg80211 is almost invisible to drivers, as cfg80211 automatically registers an rfkill instance for each wireless device it knows about. Soft kill is also translated into disconnecting and turning all interfaces off, drivers are expected to turn off the device when all interfaces are down.

    However, devices may have a hard RFkill line, in which case they also need to interact with the rfkill subsystem, via cfg80211. They can do this with a few helper functions documented here.


wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state

void wiphy_rfkill_set_hw_state (struct wiphy * wiphy, bool blocked)

Arguments

wiphy
the wiphy
blocked
block status

wiphy_rfkill_start_polling - start polling rfkill

void wiphy_rfkill_start_polling (struct wiphy * wiphy)

Arguments

wiphy
the wiphy

wiphy_rfkill_stop_polling - stop polling rfkill

void wiphy_rfkill_stop_polling (struct wiphy * wiphy)

Arguments

wiphy
the wiphy

Test mode

    Test mode is a set of utility functions to allow drivers to interact with driver-specific tools to aid, for instance, factory programming.

    This chapter describes how drivers interact with it, for more information see the nl80211 book's chapter on it.


cfg80211_testmode_alloc_reply_skb - allocate testmode reply

struct sk_buff * cfg80211_testmode_alloc_reply_skb (struct wiphy * wiphy, int approxlen)

Arguments

wiphy
the wiphy
approxlen
an upper bound of the length of the data that will be put into the skb

Description

This function allocates and pre-fills an skb for a reply to the testmode command. Since it is intended for a reply, calling it outside of the testmode_cmd operation is invalid.

The returned skb (or NULL if any errors happen) is pre-filled with the wiphy index and set up in a way that any data that is put into the skb (with skb_put, nla_put or similar) will end up being within the NL80211_ATTR_TESTDATA attribute, so all that needs to be done with the skb is adding data for the corresponding userspace tool which can then read that data out of the testdata attribute. You must not modify the skb in any other way.

When done, call cfg80211_testmode_reply with the skb and return its error code as the result of the testmode_cmd operation.


cfg80211_testmode_reply - send the reply skb

int cfg80211_testmode_reply (struct sk_buff * skb)

Arguments

skb
The skb, must have been allocated with cfg80211_testmode_alloc_reply_skb

Description

Returns an error code or 0 on success, since calling this function will usually be the last thing before returning from the testmode_cmd you should return the error code. Note that this function consumes the skb regardless of the return value.

cfg80211_testmode_alloc_event_skb - allocate testmode event

struct sk_buff * cfg80211_testmode_alloc_event_skb (struct wiphy * wiphy, int approxlen, gfp_t gfp)

Arguments

wiphy
the wiphy
approxlen
an upper bound of the length of the data that will be put into the skb
gfp
allocation flags

Description

This function allocates and pre-fills an skb for an event on the testmode multicast group.

The returned skb (or NULL if any errors happen) is set up in the same way as with cfg80211_testmode_alloc_reply_skb but prepared for an event. As there, you should simply add data to it that will then end up in the NL80211_ATTR_TESTDATA attribute. Again, you must not modify the skb in any other way.

When done filling the skb, call cfg80211_testmode_event with the skb to send the event.


cfg80211_testmode_event - send the event

void cfg80211_testmode_event (struct sk_buff * skb, gfp_t gfp)

Arguments

skb
The skb, must have been allocated with cfg80211_testmode_alloc_event_skb
gfp
allocation flags

Description

This function sends the given skb, which must have been allocated by cfg80211_testmode_alloc_event_skb, as an event. It always consumes it.

cfg80211_connect_result - notify cfg80211 of connection result

void cfg80211_connect_result (struct net_device * dev, const u8 * bssid, const u8 * req_ie, size_t req_ie_len, const u8 * resp_ie, size_t resp_ie_len, u16 status, gfp_t gfp)

Arguments

dev
network device
bssid
the BSSID of the AP
req_ie
association request IEs (maybe be NULL)
req_ie_len
association request IEs length
resp_ie
association response IEs (may be NULL)
resp_ie_len
assoc response IEs length
status
status code, 0 for successful connection, use WLAN_STATUS_UNSPECIFIED_FAILURE if your device cannot give you the real status code for failures.
gfp
allocation flags

Description

It should be called by the underlying driver whenever connect has succeeded.

cfg80211_roamed - notify cfg80211 of roaming

void cfg80211_roamed (struct net_device * dev, struct ieee80211_channel * channel, const u8 * bssid, const u8 * req_ie, size_t req_ie_len, const u8 * resp_ie, size_t resp_ie_len, gfp_t gfp)

Arguments

dev
network device
channel
the channel of the new AP
bssid
the BSSID of the new AP
req_ie
association request IEs (maybe be NULL)
req_ie_len
association request IEs length
resp_ie
association response IEs (may be NULL)
resp_ie_len
assoc response IEs length
gfp
allocation flags

Description

It should be called by the underlying driver whenever it roamed from one AP to another while connected.

cfg80211_roamed_bss - notify cfg80211 of roaming

void cfg80211_roamed_bss (struct net_device * dev, struct cfg80211_bss * bss, const u8 * req_ie, size_t req_ie_len, const u8 * resp_ie, size_t resp_ie_len, gfp_t gfp)

Arguments

dev
network device
bss
entry of bss to which STA got roamed
req_ie
association request IEs (maybe be NULL)
req_ie_len
association request IEs length
resp_ie
association response IEs (may be NULL)
resp_ie_len
assoc response IEs length
gfp
allocation flags

Description

This is just a wrapper to notify cfg80211 of roaming event with driver passing bss to avoid a race in timeout of the bss entry. It should be called by the underlying driver whenever it roamed from one AP to another while connected. Drivers which have roaming implemented in firmware may use this function to avoid a race in bss entry timeout where the bss entry of the new AP is seen in the driver, but gets timed out by the time it is accessed in __cfg80211_roamed due to delay in scheduling rdev->event_work. In case of any failures, the reference is released either in cfg80211_roamed_bss or in __cfg80211_romed, Otherwise, it will be released while diconneting from the current bss.

cfg80211_disconnected - notify cfg80211 that connection was dropped

void cfg80211_disconnected (struct net_device * dev, u16 reason, u8 * ie, size_t ie_len, gfp_t gfp)

Arguments

dev
network device
reason
reason code for the disconnection, set it to 0 if unknown
ie
information elements of the deauth/disassoc frame (may be NULL)
ie_len
length of IEs
gfp
allocation flags

Description

After it calls this function, the driver should enter an idle state and not try to connect to any AP any more.

cfg80211_ready_on_channel - notification of remain_on_channel start

void cfg80211_ready_on_channel (struct net_device * dev, u64 cookie, struct ieee80211_channel * chan, enum nl80211_channel_type channel_type, unsigned int duration, gfp_t gfp)

Arguments

dev
network device
cookie
the request cookie
chan
The current channel (from remain_on_channel request)
channel_type
Channel type
duration
Duration in milliseconds that the driver intents to remain on the channel
gfp
allocation flags

cfg80211_remain_on_channel_expired - remain_on_channel duration expired

void cfg80211_remain_on_channel_expired (struct net_device * dev, u64 cookie, struct ieee80211_channel * chan, enum nl80211_channel_type channel_type, gfp_t gfp)

Arguments

dev
network device
cookie
the request cookie
chan
The current channel (from remain_on_channel request)
channel_type
Channel type
gfp
allocation flags

cfg80211_new_sta - notify userspace about station

void cfg80211_new_sta (struct net_device * dev, const u8 * mac_addr, struct station_info * sinfo, gfp_t gfp)

Arguments

dev
the netdev
mac_addr
the station's address
sinfo
the station information
gfp
allocation flags

cfg80211_del_sta - notify userspace about deletion of a station

void cfg80211_del_sta (struct net_device * dev, const u8 * mac_addr, gfp_t gfp)

Arguments

dev
the netdev
mac_addr
the station's address
gfp
allocation flags

cfg80211_rx_mgmt - notification of received, unprocessed management frame

bool cfg80211_rx_mgmt (struct net_device * dev, int freq, const u8 * buf, size_t len, gfp_t gfp)

Arguments

dev
network device
freq
Frequency on which the frame was received in MHz
buf
Management frame (header + body)
len
length of the frame data
gfp
context flags

Description

Returns true if a user space application has registered for this frame. For action frames, that makes it responsible for rejecting unrecognized action frames; false otherwise, in which case for action frames the driver is responsible for rejecting the frame.

This function is called whenever an Action frame is received for a station mode interface, but is not processed in kernel.


cfg80211_mgmt_tx_status - notification of TX status for management frame

void cfg80211_mgmt_tx_status (struct net_device * dev, u64 cookie, const u8 * buf, size_t len, bool ack, gfp_t gfp)

Arguments

dev
network device
cookie
Cookie returned by cfg80211_ops::mgmt_tx
buf
Management frame (header + body)
len
length of the frame data
ack
Whether frame was acknowledged
gfp
context flags

Description

This function is called whenever a management frame was requested to be

transmitted with cfg80211_ops

:mgmt_tx to report the TX status of the transmission attempt.

cfg80211_cqm_rssi_notify - connection quality monitoring rssi event

void cfg80211_cqm_rssi_notify (struct net_device * dev, enum nl80211_cqm_rssi_threshold_event rssi_event, gfp_t gfp)

Arguments

dev
network device
rssi_event
the triggered RSSI event
gfp
context flags

Description

This function is called when a configured connection quality monitoring rssi threshold reached event occurs.

cfg80211_cqm_pktloss_notify - notify userspace about packetloss to peer

void cfg80211_cqm_pktloss_notify (struct net_device * dev, const u8 * peer, u32 num_packets, gfp_t gfp)

Arguments

dev
network device
peer
peer's MAC address
num_packets
how many packets were lost -- should be a fixed threshold but probably no less than maybe 50, or maybe a throughput dependent threshold (to account for temporary interference)
gfp
context flags

cfg80211_gtk_rekey_notify - notify userspace about driver rekeying

void cfg80211_gtk_rekey_notify (struct net_device * dev, const u8 * bssid, const u8 * replay_ctr, gfp_t gfp)

Arguments

dev
network device
bssid
BSSID of AP (to avoid races)
replay_ctr
new replay counter
gfp
allocation flags

cfg80211_pmksa_candidate_notify - notify about PMKSA caching candidate

void cfg80211_pmksa_candidate_notify (struct net_device * dev, int index, const u8 * bssid, bool preauth, gfp_t gfp)

Arguments

dev
network device
index
candidate index (the smaller the index, the higher the priority)
bssid
BSSID of AP
preauth
Whether AP advertises support for RSN pre-authentication
gfp
allocation flags

cfg80211_rx_spurious_frame - inform userspace about a spurious frame

bool cfg80211_rx_spurious_frame (struct net_device * dev, const u8 * addr, gfp_t gfp)

Arguments

dev
The device the frame matched to
addr
the transmitter address
gfp
context flags

Description

This function is used in AP mode (only!) to inform userspace that a spurious class 3 frame was received, to be able to deauth the sender. Returns true if the frame was passed to userspace (or this failed for a reason other than not having a subscription.)

cfg80211_rx_unexpected_4addr_frame - inform about unexpected WDS frame

bool cfg80211_rx_unexpected_4addr_frame (struct net_device * dev, const u8 * addr, gfp_t gfp)

Arguments

dev
The device the frame matched to
addr
the transmitter address
gfp
context flags

Description

This function is used in AP mode (only!) to inform userspace that an associated station sent a 4addr frame but that wasn't expected. It is allowed and desirable to send this event only once for each station to avoid event flooding. Returns true if the frame was passed to userspace (or this failed for a reason other than not having a subscription.)

cfg80211_probe_status - notify userspace about probe status

void cfg80211_probe_status (struct net_device * dev, const u8 * addr, u64 cookie, bool acked, gfp_t gfp)

Arguments

dev
the device the probe was sent on
addr
the address of the peer
cookie
the cookie filled in probe_client previously
acked
indicates whether probe was acked or not
gfp
allocation flags

cfg80211_report_obss_beacon - report beacon from other APs

void cfg80211_report_obss_beacon (struct wiphy * wiphy, const u8 * frame, size_t len, int freq, gfp_t gfp)

Arguments

wiphy
The wiphy that received the beacon
frame
the frame
len
length of the frame
freq
frequency the frame was received on
gfp
allocation flags

Description

Use this function to report to userspace when a beacon was received. It is not useful to call this when there is no netdev that is in AP/GO mode.