Sophie

Sophie

distrib > Fedora > 18 > x86_64 > media > updates > by-pkgid > 1a595394b241504ff370a8d12ebfcea7 > files > 373

kernel-doc-3.11.10-100.fc18.noarch.rpm

<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>struct sta_info</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="The 802.11 subsystems &#8211; for kernel developers" /><link rel="up" href="sta-info.html#idm139754516369232" title="Programming information" /><link rel="prev" href="sta-info.html" title="Chapter&#160;22.&#160;Station info handling" /><link rel="next" href="API-enum-ieee80211-sta-info-flags.html" title="enum ieee80211_sta_info_flags" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">struct sta_info</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sta-info.html">Prev</a>&#160;</td><th width="60%" align="center">Programming information</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-enum-ieee80211-sta-info-flags.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-struct-sta-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>struct sta_info &#8212; 
  STA information
 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="programlisting">
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;
  u8 chains;
  s8 chain_signal_last[IEEE80211_MAX_CHAINS];
  struct ewma chain_signal_avg[IEEE80211_MAX_CHAINS];
  __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;
};  </pre></div><div class="refsect1"><a id="idm139754516359088"></a><h2>Members</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">list</span></dt><dd><p>
global linked list entry
      </p></dd><dt><span class="term">rcu_head</span></dt><dd><p>
RCU head used for freeing this station struct
      </p></dd><dt><span class="term">hnext</span></dt><dd><p>
hash table linked list pointer
      </p></dd><dt><span class="term">local</span></dt><dd><p>
pointer to the global information
      </p></dd><dt><span class="term">sdata</span></dt><dd><p>
virtual interface this station belongs to
      </p></dd><dt><span class="term">gtk[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS]</span></dt><dd><p>
group keys negotiated with this station, if any
      </p></dd><dt><span class="term">ptk</span></dt><dd><p>
peer key negotiated with this station, if any
      </p></dd><dt><span class="term">rate_ctrl</span></dt><dd><p>
rate control algorithm reference
      </p></dd><dt><span class="term">rate_ctrl_priv</span></dt><dd><p>
rate control private per-STA pointer
      </p></dd><dt><span class="term">lock</span></dt><dd><p>
used for locking all fields that require locking, see comments
in the header file.
      </p></dd><dt><span class="term">drv_unblock_wk</span></dt><dd><p>
used for driver PS unblocking
      </p></dd><dt><span class="term">listen_interval</span></dt><dd><p>
listen interval of this station, when we're acting as AP
      </p></dd><dt><span class="term">dead</span></dt><dd><p>
set to true when sta is unlinked
      </p></dd><dt><span class="term">uploaded</span></dt><dd><p>
set to true when sta is uploaded to the driver
      </p></dd><dt><span class="term">sta_state</span></dt><dd><p>
duplicates information about station state (for debug)
      </p></dd><dt><span class="term">_flags</span></dt><dd><p>
STA flags, see <span class="structname">enum</span> ieee80211_sta_info_flags, do not use directly
      </p></dd><dt><span class="term">ps_tx_buf[IEEE80211_NUM_ACS]</span></dt><dd><p>
buffers (per AC) of frames to transmit to this station
when it leaves power saving state or polls
      </p></dd><dt><span class="term">tx_filtered[IEEE80211_NUM_ACS]</span></dt><dd><p>
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
      </p></dd><dt><span class="term">driver_buffered_tids</span></dt><dd><p>
bitmap of TIDs the driver has data buffered on
      </p></dd><dt><span class="term">rx_packets</span></dt><dd><p>
Number of MSDUs received from this STA
      </p></dd><dt><span class="term">rx_bytes</span></dt><dd><p>
Number of bytes received from this STA
      </p></dd><dt><span class="term">wep_weak_iv_count</span></dt><dd><p>
number of weak WEP IVs received from this station
      </p></dd><dt><span class="term">last_rx</span></dt><dd><p>
time (in jiffies) when last frame was received from this STA
      </p></dd><dt><span class="term">last_connected</span></dt><dd><p>
time (in seconds) when a station got connected
      </p></dd><dt><span class="term">num_duplicates</span></dt><dd><p>
number of duplicate frames received from this STA
      </p></dd><dt><span class="term">rx_fragments</span></dt><dd><p>
number of received MPDUs
      </p></dd><dt><span class="term">rx_dropped</span></dt><dd><p>
number of dropped MPDUs from this STA
      </p></dd><dt><span class="term">last_signal</span></dt><dd><p>
signal of last received frame from this STA
      </p></dd><dt><span class="term">avg_signal</span></dt><dd><p>
moving average of signal of received frames from this STA
      </p></dd><dt><span class="term">last_ack_signal</span></dt><dd><p>
signal of last received Ack frame from this STA
      </p></dd><dt><span class="term">chains</span></dt><dd><p>
chains ever used for RX from this station
      </p></dd><dt><span class="term">chain_signal_last[IEEE80211_MAX_CHAINS]</span></dt><dd><p>
last signal (per chain)
      </p></dd><dt><span class="term">chain_signal_avg[IEEE80211_MAX_CHAINS]</span></dt><dd><p>
signal average (per chain)
      </p></dd><dt><span class="term">last_seq_ctrl[IEEE80211_NUM_TIDS + 1]</span></dt><dd><p>
last received seq/frag number from this STA (per RX queue)
      </p></dd><dt><span class="term">tx_filtered_count</span></dt><dd><p>
number of frames the hardware filtered for this STA
      </p></dd><dt><span class="term">tx_retry_failed</span></dt><dd><p>
number of frames that failed retry
      </p></dd><dt><span class="term">tx_retry_count</span></dt><dd><p>
total number of retries for frames to this STA
      </p></dd><dt><span class="term">fail_avg</span></dt><dd><p>
moving percentage of failed MSDUs
      </p></dd><dt><span class="term">tx_fragments</span></dt><dd><p>
number of transmitted MPDUs
      </p></dd><dt><span class="term">tx_packets[IEEE80211_NUM_ACS]</span></dt><dd><p>
number of RX/TX MSDUs
      </p></dd><dt><span class="term">tx_bytes[IEEE80211_NUM_ACS]</span></dt><dd><p>
number of bytes transmitted to this STA
      </p></dd><dt><span class="term">last_tx_rate</span></dt><dd><p>
rate used for last transmit, to report to userspace as
<span class="quote">&#8220;<span class="quote">the</span>&#8221;</span> transmit rate
      </p></dd><dt><span class="term">last_rx_rate_idx</span></dt><dd><p>
rx status rate index of the last data packet
      </p></dd><dt><span class="term">last_rx_rate_flag</span></dt><dd><p>
rx status flag of the last data packet
      </p></dd><dt><span class="term">last_rx_rate_vht_nss</span></dt><dd><p>
rx status nss of last data packet
      </p></dd><dt><span class="term">tid_seq[IEEE80211_QOS_CTL_TID_MASK + 1]</span></dt><dd><p>
per-TID sequence numbers for sending to this STA
      </p></dd><dt><span class="term">ampdu_mlme</span></dt><dd><p>
A-MPDU state machine state
      </p></dd><dt><span class="term">timer_to_tid[IEEE80211_NUM_TIDS]</span></dt><dd><p>
identity mapping to ID timers
      </p></dd><dt><span class="term">llid</span></dt><dd><p>
Local link ID
      </p></dd><dt><span class="term">plid</span></dt><dd><p>
Peer link ID
      </p></dd><dt><span class="term">reason</span></dt><dd><p>
Cancel reason on PLINK_HOLDING state
      </p></dd><dt><span class="term">plink_retries</span></dt><dd><p>
Retries in establishment
      </p></dd><dt><span class="term">ignore_plink_timer</span></dt><dd><p>
ignore the peer-link timer (used internally)
      </p></dd><dt><span class="term">plink_state</span></dt><dd><p>
peer link state
      </p></dd><dt><span class="term">plink_timeout</span></dt><dd><p>
timeout of peer link
      </p></dd><dt><span class="term">plink_timer</span></dt><dd><p>
peer link watch timer
      </p></dd><dt><span class="term">t_offset</span></dt><dd><p>
timing offset relative to this host
      </p></dd><dt><span class="term">t_offset_setpoint</span></dt><dd><p>
reference timing offset of this sta to be used when
calculating clockdrift
      </p></dd><dt><span class="term">local_pm</span></dt><dd><p>
local link-specific power save mode
      </p></dd><dt><span class="term">peer_pm</span></dt><dd><p>
peer-specific power save mode towards local STA
      </p></dd><dt><span class="term">nonpeer_pm</span></dt><dd><p>
STA power save mode towards non-peer neighbors
      </p></dd><dt><span class="term">debugfs</span></dt><dd><p>
debug filesystem info
      </p></dd><dt><span class="term">cur_max_bandwidth</span></dt><dd><p>
maximum bandwidth to use for TX to the station,
taken from HT/VHT capabilities or VHT operating mode notification
      </p></dd><dt><span class="term">lost_packets</span></dt><dd><p>
number of consecutive lost packets
      </p></dd><dt><span class="term">beacon_loss_count</span></dt><dd><p>
number of times beacon loss has triggered
      </p></dd><dt><span class="term">sta</span></dt><dd><p>
station information we share with the driver
      </p></dd></dl></div></div><div class="refsect1"><a id="idm139754516265872"></a><h2>Description</h2><p>
   </p><p>

   This structure collects information about a station that
   mac80211 is communicating with.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sta-info.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="sta-info.html#idm139754516369232">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-enum-ieee80211-sta-info-flags.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&#160;22.&#160;Station info handling&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">enum ieee80211_sta_info_flags</span></td></tr></table></div></body></html>