2. EL 7
  3. kernel-doc
  4. struct_wireless_dev(9)

Scroll to navigation

STRUCT WIRELESS_DEV(9) Device registration STRUCT WIRELESS_DEV(9)

NAME

struct_wireless_dev - wireless device state

SYNOPSIS

struct wireless_dev {


  struct wiphy * wiphy;


  enum nl80211_iftype iftype;


  struct list_head list;


  struct net_device * netdev;


  u32 identifier;


  struct list_head mgmt_registrations;


  spinlock_t mgmt_registrations_lock;


  struct mutex mtx;


  bool use_4addr;


  bool is_running;


  u8 address[ETH_ALEN];


  u8 ssid[IEEE80211_MAX_SSID_LEN];


  u8 ssid_len;


  u8 mesh_id_len;


  u8 mesh_id_up_len;


  struct cfg80211_conn * conn;


  struct cfg80211_cached_keys * connect_keys;


  enum ieee80211_bss_type conn_bss_type;


  u32 conn_owner_nlportid;


  struct work_struct disconnect_wk;


  u8 disconnect_bssid[ETH_ALEN];


  struct list_head event_list;


  spinlock_t event_lock;


  struct cfg80211_internal_bss * current_bss;


  struct cfg80211_chan_def preset_chandef;


  struct cfg80211_chan_def chandef;


  bool ibss_fixed;


  bool ibss_dfs_possible;


  bool ps;


  int ps_timeout;


  int beacon_interval;


  u32 ap_unexpected_nlportid;


  u32 owner_nlportid;


  bool nl_owner_dead;


  bool cac_started;


  unsigned long cac_start_time;


  unsigned int cac_time_ms;
#ifdef CONFIG_CFG80211_WEXT


  struct wext;
#endif


  struct cfg80211_cqm_config * cqm_config;


  struct list_head pmsr_list;


  spinlock_t pmsr_lock;


  struct work_struct pmsr_free_wk;
};

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, may be NULL

identifier

(private) Identifier used in nl80211 to identify this wireless device if it has no 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, may be used by drivers and some API functions require it held

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

is_running

true if this is a non-netdev device that has been started, e.g. the P2P Device.

address[ETH_ALEN]

The address for this device, valid only if netdev is NULL

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

conn

(private) cfg80211 software SME connection state machine data

connect_keys

(private) keys to set after connection is established

conn_bss_type

connecting/connected BSS type

conn_owner_nlportid

(private) connection owner socket port ID

disconnect_wk

(private) auto-disconnect work

disconnect_bssid[ETH_ALEN]

(private) the BSSID to use for auto-disconnect

event_list

(private) list for internal event processing

event_lock

(private) lock for event list

current_bss

(private) Used by the internal configuration code

preset_chandef

(private) Used by the internal configuration code to track the channel to be used for AP later

chandef

(private) Used by the internal configuration code to track the user-set channel definition.

ibss_fixed

(private) IBSS is using fixed BSSID

ibss_dfs_possible

(private) IBSS may change to a DFS channel

ps

powersave mode is enabled

ps_timeout

dynamic powersave timeout

beacon_interval

beacon interval used on this device for transmitting beacons, 0 when not valid

ap_unexpected_nlportid

(private) netlink port ID of application registered for unexpected class 3 frames (AP mode)

owner_nlportid

(private) owner socket port ID

nl_owner_dead

(private) owner socket went away

cac_started

true if DFS channel availability check has been started

cac_start_time

timestamp (jiffies) when the dfs state was entered.

cac_time_ms

CAC time in ms

wext

(private) Used by the internal wireless extensions compat code wext.ibss: (private) IBSS data part of wext handling wext.connect: (private) connection handling data wext.keys: (private) (WEP) key data wext.ie: (private) extra elements for association wext.ie_len: (private) length of extra elements wext.bssid: (private) selected network BSSID wext.ssid: (private) selected network SSID wext.default_key: (private) selected default key index wext.default_mgmt_key: (private) selected default management key index wext.prev_bssid: (private) previous BSSID for reassociation wext.prev_bssid_valid: (private) previous BSSID validity

cqm_config

(private) nl80211 RSSI monitor state

pmsr_list

(private) peer measurement requests

pmsr_lock

(private) peer measurements requests/results lock

pmsr_free_wk

(private) peer measurements cleanup work

DESCRIPTION

For netdevs, this structure must be allocated by the driver that uses the ieee80211_ptr field in struct net_device (this is intentional so it can be allocated along with the netdev.) It need not be registered then as netdev registration will be intercepted by cfg80211 to see the new wireless device.

For non-netdev uses, it must also be allocated by the driver in response to the cfg80211 callbacks that require it, as there's no netdev registration in that case it may not be allocated outside of callback operations that return it.

AUTHOR

Johannes Berg <johannes@sipsolutions.net>

Author.

COPYRIGHT

June 2023 Kernel Hackers Manual 3.10