STRUCT STA_INFO(9) Internals STRUCT STA_INFO(9)NAMEstruct_sta_info - STA information
SYNOPSIS
struct sta_info {
struct list_head list;
struct rcu_head rcu_head;
struct sta_info __rcu * hnext;
struct ieee80211_local * local;
struct ieee80211_sub_if_data * sdata;
struct ieee80211_key __rcu * gtk[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS];
struct ieee80211_key __rcu * ptk;
struct rate_control_ref * rate_ctrl;
void * rate_ctrl_priv;
spinlock_t lock;
struct work_struct drv_unblock_wk;
u16 listen_interval;
bool dead;
bool uploaded;
enum ieee80211_sta_state sta_state;
unsigned long _flags;
struct sk_buff_head ps_tx_buf[IEEE80211_NUM_ACS];
struct sk_buff_head tx_filtered[IEEE80211_NUM_ACS];
unsigned long driver_buffered_tids;
unsigned long rx_packets;
u64 rx_bytes;
unsigned long wep_weak_iv_count;
unsigned long last_rx;
long last_connected;
unsigned long num_duplicates;
unsigned long rx_fragments;
unsigned long rx_dropped;
int last_signal;
struct ewma avg_signal;
int last_ack_signal;
__le16 last_seq_ctrl[IEEE80211_NUM_TIDS + 1];
unsigned long tx_filtered_count;
unsigned long tx_retry_failed;
unsigned long tx_retry_count;
unsigned int fail_avg;
u32 tx_fragments;
u64 tx_packets[IEEE80211_NUM_ACS];
u64 tx_bytes[IEEE80211_NUM_ACS];
struct ieee80211_tx_rate last_tx_rate;
int last_rx_rate_idx;
u32 last_rx_rate_flag;
u8 last_rx_rate_vht_nss;
u16 tid_seq[IEEE80211_QOS_CTL_TID_MASK + 1];
struct sta_ampdu_mlme ampdu_mlme;
u8 timer_to_tid[IEEE80211_NUM_TIDS];
#ifdef CONFIG_MAC80211_MESH
__le16 llid;
__le16 plid;
__le16 reason;
u8 plink_retries;
bool ignore_plink_timer;
enum nl80211_plink_state plink_state;
u32 plink_timeout;
struct timer_list plink_timer;
s64 t_offset;
s64 t_offset_setpoint;
enum nl80211_mesh_power_mode local_pm;
enum nl80211_mesh_power_mode peer_pm;
enum nl80211_mesh_power_mode nonpeer_pm;
#endif
#ifdef CONFIG_MAC80211_DEBUGFS
struct sta_info_debugfsdentries debugfs;
#endif
enum ieee80211_sta_rx_bandwidth cur_max_bandwidth;
unsigned int lost_packets;
unsigned int beacon_loss_count;
struct ieee80211_sta sta;
};
MEMBERS
list
global linked list entry
rcu_head
RCU head used for freeing this station struct
hnext
hash table linked list pointer
local
pointer to the global information
sdata
virtual interface this station belongs to
gtk[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS]
group keys negotiated with this station, if any
ptk
peer key negotiated with this station, if any
rate_ctrl
rate control algorithm reference
rate_ctrl_priv
rate control private per-STA pointer
lock
used for locking all fields that require locking, see comments in
the header file.
drv_unblock_wk
used for driver PS unblocking
listen_interval
listen interval of this station, when we´re acting as AP
dead
set to true when sta is unlinked
uploaded
set to true when sta is uploaded to the driver
sta_state
duplicates information about station state (for debug)
_flags
STA flags, see enum ieee80211_sta_info_flags, do not use directly
ps_tx_buf[IEEE80211_NUM_ACS]
buffers (per AC) of frames to transmit to this station when it
leaves power saving state or polls
tx_filtered[IEEE80211_NUM_ACS]
buffers (per AC) of frames we already tried to transmit but were
filtered by hardware due to STA having entered power saving state,
these are also delivered to the station when it leaves powersave or
polls for frames
driver_buffered_tids
bitmap of TIDs the driver has data buffered on
rx_packets
Number of MSDUs received from this STA
rx_bytes
Number of bytes received from this STA
wep_weak_iv_count
number of weak WEP IVs received from this station
last_rx
time (in jiffies) when last frame was received from this STA
last_connected
time (in seconds) when a station got connected
num_duplicates
number of duplicate frames received from this STA
rx_fragments
number of received MPDUs
rx_dropped
number of dropped MPDUs from this STA
last_signal
signal of last received frame from this STA
avg_signal
moving average of signal of received frames from this STA
last_ack_signal
signal of last received Ack frame from this STA
last_seq_ctrl[IEEE80211_NUM_TIDS + 1]
last received seq/frag number from this STA (per RX queue)
tx_filtered_count
number of frames the hardware filtered for this STA
tx_retry_failed
number of frames that failed retry
tx_retry_count
total number of retries for frames to this STA
fail_avg
moving percentage of failed MSDUs
tx_fragments
number of transmitted MPDUs
tx_packets[IEEE80211_NUM_ACS]
number of RX/TX MSDUs
tx_bytes[IEEE80211_NUM_ACS]
number of bytes transmitted to this STA
last_tx_rate
rate used for last transmit, to report to userspace as “the”
transmit rate
last_rx_rate_idx
rx status rate index of the last data packet
last_rx_rate_flag
rx status flag of the last data packet
last_rx_rate_vht_nss
rx status nss of last data packet
tid_seq[IEEE80211_QOS_CTL_TID_MASK + 1]
per-TID sequence numbers for sending to this STA
ampdu_mlme
A-MPDU state machine state
timer_to_tid[IEEE80211_NUM_TIDS]
identity mapping to ID timers
llid
Local link ID
plid
Peer link ID
reason
Cancel reason on PLINK_HOLDING state
plink_retries
Retries in establishment
ignore_plink_timer
ignore the peer-link timer (used internally)
plink_state
peer link state
plink_timeout
timeout of peer link
plink_timer
peer link watch timer
t_offset
timing offset relative to this host
t_offset_setpoint
reference timing offset of this sta to be used when calculating
clockdrift
local_pm
local link-specific power save mode
peer_pm
peer-specific power save mode towards local STA
nonpeer_pm
STA power save mode towards non-peer neighbors
debugfs
debug filesystem info
cur_max_bandwidth
maximum bandwidth to use for TX to the station, taken from HT/VHT
capabilities or VHT operating mode notification
lost_packets
number of consecutive lost packets
beacon_loss_count
number of times beacon loss has triggered
sta
station information we share with the driver
DESCRIPTION
This structure collects information about a station that mac80211 is
communicating with.
AUTHOR
Johannes Berg <johannes@sipsolutions.net>
Author.
COPYRIGHTKernel Hackers Manual 2.6. November 2013 STRUCT STA_INFO(9)
