1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>struct station_info</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="The 802.11 subsystems – for kernel developers"><link rel="up" href="bk01ch02.html" title="Chapter 2. Actions and configuration"><link rel="prev" href="API-struct-rate-info.html" title="struct rate_info"><link rel="next" href="API-enum-monitor-flags.html" title="enum monitor_flags"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">struct station_info</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-struct-rate-info.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Actions and configuration</th><td width="20%" align="right"> <a accesskey="n" href="API-enum-monitor-flags.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-struct-station-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>struct station_info — 2 station information 3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="programlisting"> 4struct station_info { 5 u32 filled; 6 u32 connected_time; 7 u32 inactive_time; 8 u64 rx_bytes; 9 u64 tx_bytes; 10 u16 llid; 11 u16 plid; 12 u8 plink_state; 13 s8 signal; 14 s8 signal_avg; 15 u8 chains; 16 s8 chain_signal[IEEE80211_MAX_CHAINS]; 17 s8 chain_signal_avg[IEEE80211_MAX_CHAINS]; 18 struct rate_info txrate; 19 struct rate_info rxrate; 20 u32 rx_packets; 21 u32 tx_packets; 22 u32 tx_retries; 23 u32 tx_failed; 24 u32 rx_dropped_misc; 25 struct sta_bss_parameters bss_param; 26 struct nl80211_sta_flag_update sta_flags; 27 int generation; 28 const u8 * assoc_req_ies; 29 size_t assoc_req_ies_len; 30 u32 beacon_loss_count; 31 s64 t_offset; 32 enum nl80211_mesh_power_mode local_pm; 33 enum nl80211_mesh_power_mode peer_pm; 34 enum nl80211_mesh_power_mode nonpeer_pm; 35 u32 expected_throughput; 36 u64 rx_beacon; 37 u8 rx_beacon_signal_avg; 38 struct cfg80211_tid_stats pertid[IEEE80211_NUM_TIDS + 1]; 39}; </pre></div><div class="refsect1"><a name="idp1112564860"></a><h2>Members</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">filled</span></dt><dd><p> 40bitflag of flags using the bits of <span class="structname">enum</span> nl80211_sta_info to 41indicate the relevant values in this struct for them 42 </p></dd><dt><span class="term">connected_time</span></dt><dd><p> 43time(in secs) since a station is last connected 44 </p></dd><dt><span class="term">inactive_time</span></dt><dd><p> 45time since last station activity (tx/rx) in milliseconds 46 </p></dd><dt><span class="term">rx_bytes</span></dt><dd><p> 47bytes (size of MPDUs) received from this station 48 </p></dd><dt><span class="term">tx_bytes</span></dt><dd><p> 49bytes (size of MPDUs) transmitted to this station 50 </p></dd><dt><span class="term">llid</span></dt><dd><p> 51mesh local link id 52 </p></dd><dt><span class="term">plid</span></dt><dd><p> 53mesh peer link id 54 </p></dd><dt><span class="term">plink_state</span></dt><dd><p> 55mesh peer link state 56 </p></dd><dt><span class="term">signal</span></dt><dd><p> 57The signal strength, type depends on the wiphy's signal_type. 58For CFG80211_SIGNAL_TYPE_MBM, value is expressed in _dBm_. 59 </p></dd><dt><span class="term">signal_avg</span></dt><dd><p> 60Average signal strength, type depends on the wiphy's signal_type. 61For CFG80211_SIGNAL_TYPE_MBM, value is expressed in _dBm_. 62 </p></dd><dt><span class="term">chains</span></dt><dd><p> 63bitmask for filled values in <em class="parameter"><code>chain_signal</code></em>, <em class="parameter"><code>chain_signal_avg</code></em> 64 </p></dd><dt><span class="term">chain_signal[IEEE80211_MAX_CHAINS]</span></dt><dd><p> 65per-chain signal strength of last received packet in dBm 66 </p></dd><dt><span class="term">chain_signal_avg[IEEE80211_MAX_CHAINS]</span></dt><dd><p> 67per-chain signal strength average in dBm 68 </p></dd><dt><span class="term">txrate</span></dt><dd><p> 69current unicast bitrate from this station 70 </p></dd><dt><span class="term">rxrate</span></dt><dd><p> 71current unicast bitrate to this station 72 </p></dd><dt><span class="term">rx_packets</span></dt><dd><p> 73packets (MSDUs & MMPDUs) received from this station 74 </p></dd><dt><span class="term">tx_packets</span></dt><dd><p> 75packets (MSDUs & MMPDUs) transmitted to this station 76 </p></dd><dt><span class="term">tx_retries</span></dt><dd><p> 77cumulative retry counts (MPDUs) 78 </p></dd><dt><span class="term">tx_failed</span></dt><dd><p> 79number of failed transmissions (MPDUs) (retries exceeded, no ACK) 80 </p></dd><dt><span class="term">rx_dropped_misc</span></dt><dd><p> 81Dropped for un-specified reason. 82 </p></dd><dt><span class="term">bss_param</span></dt><dd><p> 83current BSS parameters 84 </p></dd><dt><span class="term">sta_flags</span></dt><dd><p> 85station flags mask & values 86 </p></dd><dt><span class="term">generation</span></dt><dd><p> 87generation number for nl80211 dumps. 88This number should increase every time the list of stations 89changes, i.e. when a station is added or removed, so that 90userspace can tell whether it got a consistent snapshot. 91 </p></dd><dt><span class="term">assoc_req_ies</span></dt><dd><p> 92IEs from (Re)Association Request. 93This is used only when in AP mode with drivers that do not use 94user space MLME/SME implementation. The information is provided for 95the <code class="function">cfg80211_new_sta</code> calls to notify user space of the IEs. 96 </p></dd><dt><span class="term">assoc_req_ies_len</span></dt><dd><p> 97Length of assoc_req_ies buffer in octets. 98 </p></dd><dt><span class="term">beacon_loss_count</span></dt><dd><p> 99Number of times beacon loss event has triggered. 100 </p></dd><dt><span class="term">t_offset</span></dt><dd><p> 101Time offset of the station relative to this host. 102 </p></dd><dt><span class="term">local_pm</span></dt><dd><p> 103local mesh STA power save mode 104 </p></dd><dt><span class="term">peer_pm</span></dt><dd><p> 105peer mesh STA power save mode 106 </p></dd><dt><span class="term">nonpeer_pm</span></dt><dd><p> 107non-peer mesh STA power save mode 108 </p></dd><dt><span class="term">expected_throughput</span></dt><dd><p> 109expected throughput in kbps (including 802.11 headers) 110towards this station. 111 </p></dd><dt><span class="term">rx_beacon</span></dt><dd><p> 112number of beacons received from this peer 113 </p></dd><dt><span class="term">rx_beacon_signal_avg</span></dt><dd><p> 114signal strength average (in dBm) for beacons received 115from this peer 116 </p></dd><dt><span class="term">pertid[IEEE80211_NUM_TIDS + 1]</span></dt><dd><p> 117per-TID statistics, see <span class="structname">struct cfg80211_tid_stats</span>, using the last 118(IEEE80211_NUM_TIDS) index for MSDUs not encapsulated in QoS-MPDUs. 119 </p></dd></dl></div></div><div class="refsect1"><a name="idp1112591356"></a><h2>Description</h2><p> 120 </p><p> 121 122 Station information filled by driver for <code class="function">get_station</code> and dump_station. 123</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-struct-rate-info.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk01ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-enum-monitor-flags.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">struct rate_info</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">enum monitor_flags</span></td></tr></table></div></body></html> 124