'\" t
.\" Title: struct ieee80211_tx_rate
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: January 2017
.\" Manual: The basic mac80211 driver interface
.\" Source: Kernel Hackers Manual 4.8.15
.\" Language: English
.\"
.TH "STRUCT IEEE80211_TX_" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "The basic mac80211 driver inte"
.\" -----------------------------------------------------------------
.\" * 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_tx_rate \- rate selection/status
.SH "SYNOPSIS"
.sp
.nf
struct ieee80211_tx_rate {
s8 idx;
u16 count:5;
u16 flags:11;
};
.fi
.SH "MEMBERS"
.PP
idx
.RS 4
rate index to attempt to send with
.RE
.PP
count
.RS 4
number of tries in this rate before going to the next rate
.RE
.PP
flags
.RS 4
rate control flags (enum
mac80211_rate_control_flags)
.RE
.SH "DESCRIPTION"
.PP
A value of \-1 for
\fIidx\fR
indicates an invalid rate and, if used in an array of retry rates, that no more rates should be tried\&.
.PP
When used for transmit status reporting, the driver should always report the rate along with the flags it used\&.
.PP
struct ieee80211_tx_info
contains an array of these structs in the control information, and it will be filled by the rate control algorithm according to what should be sent\&. For example, if this array contains, in the format { , } the information { 3, 2 }, { 2, 2 }, { 1, 4 }, { \-1, 0 }, { \-1, 0 } then this means that the frame should be transmitted up to twice at rate 3, up to twice at rate 2, and up to four times at rate 1 if it doesn\*(Aqt get acknowledged\&. Say it gets acknowledged by the peer after the fifth attempt, the status information should then contain { 3, 2 }, { 2, 2 }, { 1, 1 }, { \-1, 0 } \&.\&.\&. since it was transmitted twice at rate 3, twice at rate 2 and once at rate 1 after which we received an acknowledgement\&.
.SH "AUTHOR"
.PP
\fBJohannes Berg\fR <\&johannes@sipsolutions.net\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br