'\" t .\" Title: enum mac80211_tx_info_flags .\" 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 "ENUM MAC80211_TX_INF" "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" enum_mac80211_tx_info_flags \- flags to describe transmission information/status .SH "SYNOPSIS" .sp .nf enum mac80211_tx_info_flags { IEEE80211_TX_CTL_REQ_TX_STATUS, IEEE80211_TX_CTL_ASSIGN_SEQ, IEEE80211_TX_CTL_NO_ACK, IEEE80211_TX_CTL_CLEAR_PS_FILT, IEEE80211_TX_CTL_FIRST_FRAGMENT, IEEE80211_TX_CTL_SEND_AFTER_DTIM, IEEE80211_TX_CTL_AMPDU, IEEE80211_TX_CTL_INJECTED, IEEE80211_TX_STAT_TX_FILTERED, IEEE80211_TX_STAT_ACK, IEEE80211_TX_STAT_AMPDU, IEEE80211_TX_STAT_AMPDU_NO_BACK, IEEE80211_TX_CTL_RATE_CTRL_PROBE, IEEE80211_TX_INTFL_OFFCHAN_TX_OK, IEEE80211_TX_INTFL_NEED_TXPROCESSING, IEEE80211_TX_INTFL_RETRIED, IEEE80211_TX_INTFL_DONT_ENCRYPT, IEEE80211_TX_CTL_NO_PS_BUFFER, IEEE80211_TX_CTL_MORE_FRAMES, IEEE80211_TX_INTFL_RETRANSMISSION, IEEE80211_TX_INTFL_MLME_CONN_TX, IEEE80211_TX_INTFL_NL80211_FRAME_TX, IEEE80211_TX_CTL_LDPC, IEEE80211_TX_CTL_STBC, IEEE80211_TX_CTL_TX_OFFCHAN, IEEE80211_TX_INTFL_TKIP_MIC_FAILURE, IEEE80211_TX_CTL_NO_CCK_RATE, IEEE80211_TX_STATUS_EOSP, IEEE80211_TX_CTL_USE_MINRATE, IEEE80211_TX_CTL_DONTFRAG, IEEE80211_TX_STAT_NOACK_TRANSMITTED }; .fi .SH "CONSTANTS" .PP IEEE80211_TX_CTL_REQ_TX_STATUS .RS 4 require TX status callback for this frame\&. .RE .PP IEEE80211_TX_CTL_ASSIGN_SEQ .RS 4 The driver has to assign a sequence number to this frame, taking care of not overwriting the fragment number and increasing the sequence number only when the IEEE80211_TX_CTL_FIRST_FRAGMENT flag is set\&. mac80211 will properly assign sequence numbers to QoS\-data frames but cannot do so correctly for non\-QoS\-data and management frames because beacons need them from that counter as well and mac80211 cannot guarantee proper sequencing\&. If this flag is set, the driver should instruct the hardware to assign a sequence number to the frame or assign one itself\&. Cf\&. IEEE 802\&.11\-2007 7\&.1\&.3\&.4\&.1 paragraph 3\&. This flag will always be set for beacons and always be clear for frames without a sequence number field\&. .RE .PP IEEE80211_TX_CTL_NO_ACK .RS 4 tell the low level not to wait for an ack .RE .PP IEEE80211_TX_CTL_CLEAR_PS_FILT .RS 4 clear powersave filter for destination station .RE .PP IEEE80211_TX_CTL_FIRST_FRAGMENT .RS 4 this is a first fragment of the frame .RE .PP IEEE80211_TX_CTL_SEND_AFTER_DTIM .RS 4 send this frame after DTIM beacon .RE .PP IEEE80211_TX_CTL_AMPDU .RS 4 this frame should be sent as part of an A\-MPDU .RE .PP IEEE80211_TX_CTL_INJECTED .RS 4 Frame was injected, internal to mac80211\&. .RE .PP IEEE80211_TX_STAT_TX_FILTERED .RS 4 The frame was not transmitted because the destination STA was in powersave mode\&. Note that to avoid race conditions, the filter must be set by the hardware or firmware upon receiving a frame that indicates that the station went to sleep (must be done on device to filter frames already on the queue) and may only be unset after mac80211 gives the OK for that by setting the IEEE80211_TX_CTL_CLEAR_PS_FILT (see above), since only then is it guaranteed that no more frames are in the hardware queue\&. .RE .PP IEEE80211_TX_STAT_ACK .RS 4 Frame was acknowledged .RE .PP IEEE80211_TX_STAT_AMPDU .RS 4 The frame was aggregated, so status is for the whole aggregation\&. .RE .PP IEEE80211_TX_STAT_AMPDU_NO_BACK .RS 4 no block ack was returned, so consider using block ack request (BAR)\&. .RE .PP IEEE80211_TX_CTL_RATE_CTRL_PROBE .RS 4 internal to mac80211, can be set by rate control algorithms to indicate probe rate, will be cleared for fragmented frames (except on the last fragment) .RE .PP IEEE80211_TX_INTFL_OFFCHAN_TX_OK .RS 4 Internal to mac80211\&. Used to indicate that a frame can be transmitted while the queues are stopped for off\-channel operation\&. .RE .PP IEEE80211_TX_INTFL_NEED_TXPROCESSING .RS 4 completely internal to mac80211, used to indicate that a pending frame requires TX processing before it can be sent out\&. .RE .PP IEEE80211_TX_INTFL_RETRIED .RS 4 completely internal to mac80211, used to indicate that a frame was already retried due to PS .RE .PP IEEE80211_TX_INTFL_DONT_ENCRYPT .RS 4 completely internal to mac80211, used to indicate frame should not be encrypted .RE .PP IEEE80211_TX_CTL_NO_PS_BUFFER .RS 4 This frame is a response to a poll frame (PS\-Poll or uAPSD) or a non\-bufferable MMPDU and must be sent although the station is in powersave mode\&. .RE .PP IEEE80211_TX_CTL_MORE_FRAMES .RS 4 More frames will be passed to the transmit function after the current frame, this can be used by drivers to kick the DMA queue only if unset or when the queue gets full\&. .RE .PP IEEE80211_TX_INTFL_RETRANSMISSION .RS 4 This frame is being retransmitted after TX status because the destination was asleep, it must not be modified again (no seqno assignment, crypto, etc\&.) .RE .PP IEEE80211_TX_INTFL_MLME_CONN_TX .RS 4 This frame was transmitted by the MLME code for connection establishment, this indicates that its status should kick the MLME state machine\&. .RE .PP IEEE80211_TX_INTFL_NL80211_FRAME_TX .RS 4 Frame was requested through nl80211 MLME command (internal to mac80211 to figure out whether to send TX status to user space) .RE .PP IEEE80211_TX_CTL_LDPC .RS 4 tells the driver to use LDPC for this frame .RE .PP IEEE80211_TX_CTL_STBC .RS 4 Enables Space\-Time Block Coding (STBC) for this frame and selects the maximum number of streams that it can use\&. .RE .PP IEEE80211_TX_CTL_TX_OFFCHAN .RS 4 Marks this packet to be transmitted on the off\-channel channel when a remain\-on\-channel offload is done in hardware \-\- normal packets still flow and are expected to be handled properly by the device\&. .RE .PP IEEE80211_TX_INTFL_TKIP_MIC_FAILURE .RS 4 Marks this packet to be used for TKIP testing\&. It will be sent out with incorrect Michael MIC key to allow TKIP countermeasures to be tested\&. .RE .PP IEEE80211_TX_CTL_NO_CCK_RATE .RS 4 This frame will be sent at non CCK rate\&. This flag is actually used for management frame especially for P2P frames not being sent at CCK rate in 2GHz band\&. .RE .PP IEEE80211_TX_STATUS_EOSP .RS 4 This packet marks the end of service period, when its status is reported the service period ends\&. For frames in an SP that mac80211 transmits, it is already set; for driver frames the driver may set this flag\&. It is also used to do the same for PS\-Poll responses\&. .RE .PP IEEE80211_TX_CTL_USE_MINRATE .RS 4 This frame will be sent at lowest rate\&. This flag is used to send nullfunc frame at minimum rate when the nullfunc is used for connection monitoring purpose\&. .RE .PP IEEE80211_TX_CTL_DONTFRAG .RS 4 Don\*(Aqt fragment this packet even if it would be fragmented by size (this is optional, only used for monitor injection)\&. .RE .PP IEEE80211_TX_STAT_NOACK_TRANSMITTED .RS 4 A frame that was marked with IEEE80211_TX_CTL_NO_ACK has been successfully transmitted without any errors (like issues specific to the driver/HW)\&. This flag must not be set for frames that don\*(Aqt request no\-ack behaviour with IEEE80211_TX_CTL_NO_ACK\&. .RE .SH "DESCRIPTION" .PP .PP These flags are used with the \fIflags\fR member of ieee80211_tx_info\&. .SH "NOTE" .PP If you have to add new flags to the enumeration, then don\*(Aqt forget to update \fBIEEE80211_TX_TEMPORARY_FLAGS\fR when necessary\&. .SH "AUTHOR" .PP \fBJohannes Berg\fR <\&johannes@sipsolutions.net\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br