'\" t
.\"     Title: struct ieee80211_sta
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: January 2017
.\"    Manual: Advanced driver interface
.\"    Source: Kernel Hackers Manual 4.8.15
.\"  Language: English
.\"
.TH "STRUCT IEEE80211_STA" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Advanced driver interface"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
struct_ieee80211_sta \- station table entry
.SH "SYNOPSIS"
.sp
.nf
struct ieee80211_sta {
  u32 supp_rates[NUM_NL80211_BANDS];
  u8 addr[ETH_ALEN];
  u16 aid;
  struct ieee80211_sta_ht_cap ht_cap;
  struct ieee80211_sta_vht_cap vht_cap;
  bool wme;
  u8 uapsd_queues;
  u8 max_sp;
  u8 rx_nss;
  enum ieee80211_sta_rx_bandwidth bandwidth;
  enum ieee80211_smps_mode smps_mode;
  struct ieee80211_sta_rates __rcu * rates;
  bool tdls;
  bool tdls_initiator;
  bool mfp;
  u8 max_amsdu_subframes;
  u16 max_amsdu_len;
  bool support_p2p_ps;
  u16 max_rc_amsdu_len;
  struct ieee80211_txq * txq[IEEE80211_NUM_TIDS];
  u8 drv_priv[0];
};  
.fi
.SH "MEMBERS"
.PP
supp_rates[NUM_NL80211_BANDS]
.RS 4
Bitmap of supported rates (per band)
.RE
.PP
addr[ETH_ALEN]
.RS 4
MAC address
.RE
.PP
aid
.RS 4
AID we assigned to the station if we\*(Aqre an AP
.RE
.PP
ht_cap
.RS 4
HT capabilities of this STA; restricted to our own capabilities
.RE
.PP
vht_cap
.RS 4
VHT capabilities of this STA; restricted to our own capabilities
.RE
.PP
wme
.RS 4
indicates whether the STA supports QoS/WME (if local devices does, otherwise always false)
.RE
.PP
uapsd_queues
.RS 4
bitmap of queues configured for uapsd\&. Only valid if wme is supported\&.
.RE
.PP
max_sp
.RS 4
max Service Period\&. Only valid if wme is supported\&.
.RE
.PP
rx_nss
.RS 4
in HT/VHT, the maximum number of spatial streams the station can receive at the moment, changed by operating mode notifications and capabilities\&. The value is only valid after the station moves to associated state\&.
.RE
.PP
bandwidth
.RS 4
current bandwidth the station can receive with
.RE
.PP
smps_mode
.RS 4
current SMPS mode (off, static or dynamic)
.RE
.PP
rates
.RS 4
rate control selection table
.RE
.PP
tdls
.RS 4
indicates whether the STA is a TDLS peer
.RE
.PP
tdls_initiator
.RS 4
indicates the STA is an initiator of the TDLS link\&. Only valid if the STA is a TDLS peer in the first place\&.
.RE
.PP
mfp
.RS 4
indicates whether the STA uses management frame protection or not\&.
.RE
.PP
max_amsdu_subframes
.RS 4
indicates the maximal number of MSDUs in a single A\-MSDU\&. Taken from the Extended Capabilities element\&. 0 means unlimited\&.
.RE
.PP
max_amsdu_len
.RS 4
indicates the maximal length of an A\-MSDU in bytes\&. This field is always valid for packets with a VHT preamble\&. For packets with a HT preamble, additional limits apply: + If the skb is transmitted as part of a BA agreement, the A\-MSDU maximal size is min(max_amsdu_len, 4065) bytes\&. + If the skb is not part of a BA aggreement, the A\-MSDU maximal size is min(max_amsdu_len, 7935) bytes\&. Both additional HT limits must be enforced by the low level driver\&. This is defined by the spec (IEEE 802\&.11\-2012 section 8\&.3\&.2\&.2 NOTE 2)\&.
.RE
.PP
support_p2p_ps
.RS 4
indicates whether the STA supports P2P PS mechanism or not\&.
.RE
.PP
max_rc_amsdu_len
.RS 4
Maximum A\-MSDU size in bytes recommended by rate control\&.
.RE
.PP
txq[IEEE80211_NUM_TIDS]
.RS 4
per\-TID data TX queues (if driver uses the TXQ abstraction)
.RE
.PP
drv_priv[0]
.RS 4
data area for driver use, will always be aligned to sizeof(void *), size is determined in hw information\&.
.RE
.SH "DESCRIPTION"
.PP
.PP
A station table entry represents a station we are possibly communicating with\&. Since stations are RCU\-managed in mac80211, any ieee80211_sta pointer you get access to must either be protected by
\fBrcu_read_lock\fR
explicitly or implicitly, or you must take good care to not use such a pointer after a call to your sta_remove callback that removed it\&.
.SH "AUTHOR"
.PP
\fBJohannes Berg\fR <\&johannes@sipsolutions.net\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br