'\" t .\" Title: struct station_info .\" Author: .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Actions and configuration .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "STRUCT STATION_INFO" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Actions and configuration" .\" ----------------------------------------------------------------- .\" * 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_station_info \- station information .SH "SYNOPSIS" .sp .nf struct station_info { u64 filled; u32 connected_time; u32 inactive_time; u64 rx_bytes; u64 tx_bytes; u16 llid; u16 plid; u8 plink_state; s8 signal; s8 signal_avg; u8 chains; s8 chain_signal[IEEE80211_MAX_CHAINS]; s8 chain_signal_avg[IEEE80211_MAX_CHAINS]; struct rate_info txrate; struct rate_info rxrate; u32 rx_packets; u32 tx_packets; u32 tx_retries; u32 tx_failed; u32 rx_dropped_misc; struct sta_bss_parameters bss_param; struct nl80211_sta_flag_update sta_flags; int generation; const u8 * assoc_req_ies; size_t assoc_req_ies_len; u32 beacon_loss_count; s64 t_offset; enum nl80211_mesh_power_mode local_pm; enum nl80211_mesh_power_mode peer_pm; enum nl80211_mesh_power_mode nonpeer_pm; u32 expected_throughput; u64 rx_beacon; u64 rx_duration; u8 rx_beacon_signal_avg; struct cfg80211_tid_stats pertid[IEEE80211_NUM_TIDS + 1]; }; .fi .SH "MEMBERS" .PP filled .RS 4 bitflag of flags using the bits of enum nl80211_sta_info to indicate the relevant values in this struct for them .RE .PP connected_time .RS 4 time(in secs) since a station is last connected .RE .PP inactive_time .RS 4 time since last station activity (tx/rx) in milliseconds .RE .PP rx_bytes .RS 4 bytes (size of MPDUs) received from this station .RE .PP tx_bytes .RS 4 bytes (size of MPDUs) transmitted to this station .RE .PP llid .RS 4 mesh local link id .RE .PP plid .RS 4 mesh peer link id .RE .PP plink_state .RS 4 mesh peer link state .RE .PP signal .RS 4 The signal strength, type depends on the wiphy\*(Aqs signal_type\&. For CFG80211_SIGNAL_TYPE_MBM, value is expressed in _dBm_\&. .RE .PP signal_avg .RS 4 Average signal strength, type depends on the wiphy\*(Aqs signal_type\&. For CFG80211_SIGNAL_TYPE_MBM, value is expressed in _dBm_\&. .RE .PP chains .RS 4 bitmask for filled values in \fIchain_signal\fR, \fIchain_signal_avg\fR .RE .PP chain_signal[IEEE80211_MAX_CHAINS] .RS 4 per\-chain signal strength of last received packet in dBm .RE .PP chain_signal_avg[IEEE80211_MAX_CHAINS] .RS 4 per\-chain signal strength average in dBm .RE .PP txrate .RS 4 current unicast bitrate from this station .RE .PP rxrate .RS 4 current unicast bitrate to this station .RE .PP rx_packets .RS 4 packets (MSDUs & MMPDUs) received from this station .RE .PP tx_packets .RS 4 packets (MSDUs & MMPDUs) transmitted to this station .RE .PP tx_retries .RS 4 cumulative retry counts (MPDUs) .RE .PP tx_failed .RS 4 number of failed transmissions (MPDUs) (retries exceeded, no ACK) .RE .PP rx_dropped_misc .RS 4 Dropped for un\-specified reason\&. .RE .PP bss_param .RS 4 current BSS parameters .RE .PP sta_flags .RS 4 station flags mask & values .RE .PP generation .RS 4 generation number for nl80211 dumps\&. This number should increase every time the list of stations changes, i\&.e\&. when a station is added or removed, so that userspace can tell whether it got a consistent snapshot\&. .RE .PP assoc_req_ies .RS 4 IEs from (Re)Association Request\&. This is used only when in AP mode with drivers that do not use user space MLME/SME implementation\&. The information is provided for the \fBcfg80211_new_sta\fR calls to notify user space of the IEs\&. .RE .PP assoc_req_ies_len .RS 4 Length of assoc_req_ies buffer in octets\&. .RE .PP beacon_loss_count .RS 4 Number of times beacon loss event has triggered\&. .RE .PP t_offset .RS 4 Time offset of the station relative to this host\&. .RE .PP local_pm .RS 4 local mesh STA power save mode .RE .PP peer_pm .RS 4 peer mesh STA power save mode .RE .PP nonpeer_pm .RS 4 non\-peer mesh STA power save mode .RE .PP expected_throughput .RS 4 expected throughput in kbps (including 802\&.11 headers) towards this station\&. .RE .PP rx_beacon .RS 4 number of beacons received from this peer .RE .PP rx_duration .RS 4 aggregate PPDU duration(usecs) for all the frames from a peer .RE .PP rx_beacon_signal_avg .RS 4 signal strength average (in dBm) for beacons received from this peer .RE .PP pertid[IEEE80211_NUM_TIDS + 1] .RS 4 per\-TID statistics, see struct cfg80211_tid_stats, using the last (IEEE80211_NUM_TIDS) index for MSDUs not encapsulated in QoS\-MPDUs\&. .RE .SH "DESCRIPTION" .PP .PP Station information filled by driver for \fBget_station\fR and dump_station\&. .SH "AUTHOR" .PP \fBJohannes Berg\fR <\&johannes@sipsolutions.net\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br