OSCL-LXR linux-6.0.1/​drivers/​net/​wireless/​ralink/​rt2x00/​rt2x00queue.h	Source navigation Diff markup Identifier search General search
	Version: linux-6.0.1 spark-3.0.0 hadoop-3.2.0-src hadoop-3.3.0-src spark-2.4.7 linux-4.15.13 hadoop-2.7.4-src Revert   Change

 /* SPDX-License-Identifier: GPL-2.0-or-later */
 /*
     Copyright (C) 2004 - 2010 Ivo van Doorn <IvDoorn@gmail.com>
     <http://rt2x00.serialmonkey.com>
 
  */
 
 /*
     Module: rt2x00
     Abstract: rt2x00 queue datastructures and routines
  */
 
 #ifndef RT2X00QUEUE_H
 #define RT2X00QUEUE_H
 
 #include <linux/prefetch.h>
 
 /**
  * DOC: Entry frame size
  *
  * Ralink PCI devices demand the Frame size to be a multiple of 128 bytes,
  * for USB devices this restriction does not apply, but the value of
  * 2432 makes sense since it is big enough to contain the maximum fragment
  * size according to the ieee802.11 specs.
  * The aggregation size depends on support from the driver, but should
  * be something around 3840 bytes.
  */
 #define DATA_FRAME_SIZE     2432
 #define MGMT_FRAME_SIZE     256
 #define AGGREGATION_SIZE    3840
 
 /**
  * enum data_queue_qid: Queue identification
  *
  * @QID_AC_VO: AC VO queue
  * @QID_AC_VI: AC VI queue
  * @QID_AC_BE: AC BE queue
  * @QID_AC_BK: AC BK queue
  * @QID_HCCA: HCCA queue
  * @QID_MGMT: MGMT queue (prio queue)
  * @QID_RX: RX queue
  * @QID_OTHER: None of the above (don't use, only present for completeness)
  * @QID_BEACON: Beacon queue (value unspecified, don't send it to device)
  * @QID_ATIM: Atim queue (value unspecified, don't send it to device)
  */
 enum data_queue_qid {
     QID_AC_VO = 0,
     QID_AC_VI = 1,
     QID_AC_BE = 2,
     QID_AC_BK = 3,
     QID_HCCA = 4,
     QID_MGMT = 13,
     QID_RX = 14,
     QID_OTHER = 15,
     QID_BEACON,
     QID_ATIM,
 };
 
 /**
  * enum skb_frame_desc_flags: Flags for &struct skb_frame_desc
  *
  * @SKBDESC_DMA_MAPPED_RX: &skb_dma field has been mapped for RX
  * @SKBDESC_DMA_MAPPED_TX: &skb_dma field has been mapped for TX
  * @SKBDESC_IV_STRIPPED: Frame contained a IV/EIV provided by
  *  mac80211 but was stripped for processing by the driver.
  * @SKBDESC_NOT_MAC80211: Frame didn't originate from mac80211,
  *  don't try to pass it back.
  * @SKBDESC_DESC_IN_SKB: The descriptor is at the start of the
  *  skb, instead of in the desc field.
  */
 enum skb_frame_desc_flags {
     SKBDESC_DMA_MAPPED_RX = 1 << 0,
     SKBDESC_DMA_MAPPED_TX = 1 << 1,
     SKBDESC_IV_STRIPPED = 1 << 2,
     SKBDESC_NOT_MAC80211 = 1 << 3,
     SKBDESC_DESC_IN_SKB = 1 << 4,
 };
 
 /**
  * struct skb_frame_desc: Descriptor information for the skb buffer
  *
  * This structure is placed over the driver_data array, this means that
  * this structure should not exceed the size of that array (40 bytes).
  *
  * @flags: Frame flags, see &enum skb_frame_desc_flags.
  * @desc_len: Length of the frame descriptor.
  * @tx_rate_idx: the index of the TX rate, used for TX status reporting
  * @tx_rate_flags: the TX rate flags, used for TX status reporting
  * @desc: Pointer to descriptor part of the frame.
  *  Note that this pointer could point to something outside
  *  of the scope of the skb->data pointer.
  * @iv: IV/EIV data used during encryption/decryption.
  * @skb_dma: (PCI-only) the DMA address associated with the sk buffer.
  * @sta: The station where sk buffer was sent.
  */
 struct skb_frame_desc {
     u8 flags;
 
     u8 desc_len;
     u8 tx_rate_idx;
     u8 tx_rate_flags;
 
     void *desc;
 
     __le32 iv[2];
 
     dma_addr_t skb_dma;
     struct ieee80211_sta *sta;
 };
 
 /**
  * get_skb_frame_desc - Obtain the rt2x00 frame descriptor from a sk_buff.
  * @skb: &struct sk_buff from where we obtain the &struct skb_frame_desc
  */
 static inline struct skb_frame_desc* get_skb_frame_desc(struct sk_buff *skb)
 {
     BUILD_BUG_ON(sizeof(struct skb_frame_desc) >
              IEEE80211_TX_INFO_DRIVER_DATA_SIZE);
     return (struct skb_frame_desc *)&IEEE80211_SKB_CB(skb)->driver_data;
 }
 
 /**
  * enum rxdone_entry_desc_flags: Flags for &struct rxdone_entry_desc
  *
  * @RXDONE_SIGNAL_PLCP: Signal field contains the plcp value.
  * @RXDONE_SIGNAL_BITRATE: Signal field contains the bitrate value.
  * @RXDONE_SIGNAL_MCS: Signal field contains the mcs value.
  * @RXDONE_MY_BSS: Does this frame originate from device's BSS.
  * @RXDONE_CRYPTO_IV: Driver provided IV/EIV data.
  * @RXDONE_CRYPTO_ICV: Driver provided ICV data.
  * @RXDONE_L2PAD: 802.11 payload has been padded to 4-byte boundary.
  */
 enum rxdone_entry_desc_flags {
     RXDONE_SIGNAL_PLCP = BIT(0),
     RXDONE_SIGNAL_BITRATE = BIT(1),
     RXDONE_SIGNAL_MCS = BIT(2),
     RXDONE_MY_BSS = BIT(3),
     RXDONE_CRYPTO_IV = BIT(4),
     RXDONE_CRYPTO_ICV = BIT(5),
     RXDONE_L2PAD = BIT(6),
 };
 
 /**
  * RXDONE_SIGNAL_MASK - Define to mask off all &rxdone_entry_desc_flags flags
  * except for the RXDONE_SIGNAL_* flags. This is useful to convert the dev_flags
  * from &rxdone_entry_desc to a signal value type.
  */
 #define RXDONE_SIGNAL_MASK \
     ( RXDONE_SIGNAL_PLCP | RXDONE_SIGNAL_BITRATE | RXDONE_SIGNAL_MCS )
 
 /**
  * struct rxdone_entry_desc: RX Entry descriptor
  *
  * Summary of information that has been read from the RX frame descriptor.
  *
  * @timestamp: RX Timestamp
  * @signal: Signal of the received frame.
  * @rssi: RSSI of the received frame.
  * @size: Data size of the received frame.
  * @flags: MAC80211 receive flags (See &enum mac80211_rx_flags).
  * @dev_flags: Ralink receive flags (See &enum rxdone_entry_desc_flags).
  * @rate_mode: Rate mode (See @enum rate_modulation).
  * @cipher: Cipher type used during decryption.
  * @cipher_status: Decryption status.
  * @iv: IV/EIV data used during decryption.
  * @icv: ICV data used during decryption.
  */
 struct rxdone_entry_desc {
     u64 timestamp;
     int signal;
     int rssi;
     int size;
     int flags;
     int dev_flags;
     u16 rate_mode;
     u16 enc_flags;
     enum mac80211_rx_encoding encoding;
     enum rate_info_bw bw;
     u8 cipher;
     u8 cipher_status;
 
     __le32 iv[2];
     __le32 icv;
 };
 
 /**
  * enum txdone_entry_desc_flags: Flags for &struct txdone_entry_desc
  *
  * Every txdone report has to contain the basic result of the
  * transmission, either &TXDONE_UNKNOWN, &TXDONE_SUCCESS or
  * &TXDONE_FAILURE. The flag &TXDONE_FALLBACK can be used in
  * conjunction with all of these flags but should only be set
  * if retires > 0. The flag &TXDONE_EXCESSIVE_RETRY can only be used
  * in conjunction with &TXDONE_FAILURE.
  *
  * @TXDONE_UNKNOWN: Hardware could not determine success of transmission.
  * @TXDONE_SUCCESS: Frame was successfully send
  * @TXDONE_FALLBACK: Hardware used fallback rates for retries
  * @TXDONE_FAILURE: Frame was not successfully send
  * @TXDONE_EXCESSIVE_RETRY: In addition to &TXDONE_FAILURE, the
  *  frame transmission failed due to excessive retries.
  */
 enum txdone_entry_desc_flags {
     TXDONE_UNKNOWN,
     TXDONE_SUCCESS,
     TXDONE_FALLBACK,
     TXDONE_FAILURE,
     TXDONE_EXCESSIVE_RETRY,
     TXDONE_AMPDU,
     TXDONE_NO_ACK_REQ,
 };
 
 /**
  * struct txdone_entry_desc: TX done entry descriptor
  *
  * Summary of information that has been read from the TX frame descriptor
  * after the device is done with transmission.
  *
  * @flags: TX done flags (See &enum txdone_entry_desc_flags).
  * @retry: Retry count.
  */
 struct txdone_entry_desc {
     unsigned long flags;
     int retry;
 };
 
 /**
  * enum txentry_desc_flags: Status flags for TX entry descriptor
  *
  * @ENTRY_TXD_RTS_FRAME: This frame is a RTS frame.
  * @ENTRY_TXD_CTS_FRAME: This frame is a CTS-to-self frame.
  * @ENTRY_TXD_GENERATE_SEQ: This frame requires sequence counter.
  * @ENTRY_TXD_FIRST_FRAGMENT: This is the first frame.
  * @ENTRY_TXD_MORE_FRAG: This frame is followed by another fragment.
  * @ENTRY_TXD_REQ_TIMESTAMP: Require timestamp to be inserted.
  * @ENTRY_TXD_BURST: This frame belongs to the same burst event.
  * @ENTRY_TXD_ACK: An ACK is required for this frame.
  * @ENTRY_TXD_RETRY_MODE: When set, the long retry count is used.
  * @ENTRY_TXD_ENCRYPT: This frame should be encrypted.
  * @ENTRY_TXD_ENCRYPT_PAIRWISE: Use pairwise key table (instead of shared).
  * @ENTRY_TXD_ENCRYPT_IV: Generate IV/EIV in hardware.
  * @ENTRY_TXD_ENCRYPT_MMIC: Generate MIC in hardware.
  * @ENTRY_TXD_HT_AMPDU: This frame is part of an AMPDU.
  * @ENTRY_TXD_HT_BW_40: Use 40MHz Bandwidth.
  * @ENTRY_TXD_HT_SHORT_GI: Use short GI.
  * @ENTRY_TXD_HT_MIMO_PS: The receiving STA is in dynamic SM PS mode.
  */
 enum txentry_desc_flags {
     ENTRY_TXD_RTS_FRAME,
     ENTRY_TXD_CTS_FRAME,
     ENTRY_TXD_GENERATE_SEQ,
     ENTRY_TXD_FIRST_FRAGMENT,
     ENTRY_TXD_MORE_FRAG,
     ENTRY_TXD_REQ_TIMESTAMP,
     ENTRY_TXD_BURST,
     ENTRY_TXD_ACK,
     ENTRY_TXD_RETRY_MODE,
     ENTRY_TXD_ENCRYPT,
     ENTRY_TXD_ENCRYPT_PAIRWISE,
     ENTRY_TXD_ENCRYPT_IV,
     ENTRY_TXD_ENCRYPT_MMIC,
     ENTRY_TXD_HT_AMPDU,
     ENTRY_TXD_HT_BW_40,
     ENTRY_TXD_HT_SHORT_GI,
     ENTRY_TXD_HT_MIMO_PS,
 };
 
 /**
  * struct txentry_desc: TX Entry descriptor
  *
  * Summary of information for the frame descriptor before sending a TX frame.
  *
  * @flags: Descriptor flags (See &enum queue_entry_flags).
  * @length: Length of the entire frame.
  * @header_length: Length of 802.11 header.
  * @length_high: PLCP length high word.
  * @length_low: PLCP length low word.
  * @signal: PLCP signal.
  * @service: PLCP service.
  * @msc: MCS.
  * @stbc: Use Space Time Block Coding (only available for MCS rates < 8).
  * @ba_size: Size of the recepients RX reorder buffer - 1.
  * @rate_mode: Rate mode (See @enum rate_modulation).
  * @mpdu_density: MDPU density.
  * @retry_limit: Max number of retries.
  * @ifs: IFS value.
  * @txop: IFS value for 11n capable chips.
  * @cipher: Cipher type used for encryption.
  * @key_idx: Key index used for encryption.
  * @iv_offset: Position where IV should be inserted by hardware.
  * @iv_len: Length of IV data.
  */
 struct txentry_desc {
     unsigned long flags;
 
     u16 length;
     u16 header_length;
 
     union {
         struct {
             u16 length_high;
             u16 length_low;
             u16 signal;
             u16 service;
             enum ifs ifs;
         } plcp;
 
         struct {
             u16 mcs;
             u8 stbc;
             u8 ba_size;
             u8 mpdu_density;
             enum txop txop;
             int wcid;
         } ht;
     } u;
 
     enum rate_modulation rate_mode;
 
     short retry_limit;
 
     enum cipher cipher;
     u16 key_idx;
     u16 iv_offset;
     u16 iv_len;
 };
 
 /**
  * enum queue_entry_flags: Status flags for queue entry
  *
  * @ENTRY_BCN_ASSIGNED: This entry has been assigned to an interface.
  *  As long as this bit is set, this entry may only be touched
  *  through the interface structure.
  * @ENTRY_OWNER_DEVICE_DATA: This entry is owned by the device for data
  *  transfer (either TX or RX depending on the queue). The entry should
  *  only be touched after the device has signaled it is done with it.
  * @ENTRY_DATA_PENDING: This entry contains a valid frame and is waiting
  *  for the signal to start sending.
  * @ENTRY_DATA_IO_FAILED: Hardware indicated that an IO error occurred
  *  while transferring the data to the hardware. No TX status report will
  *  be expected from the hardware.
  * @ENTRY_DATA_STATUS_PENDING: The entry has been send to the device and
  *  returned. It is now waiting for the status reporting before the
  *  entry can be reused again.
  */
 enum queue_entry_flags {
     ENTRY_BCN_ASSIGNED,
     ENTRY_BCN_ENABLED,
     ENTRY_OWNER_DEVICE_DATA,
     ENTRY_DATA_PENDING,
     ENTRY_DATA_IO_FAILED,
     ENTRY_DATA_STATUS_PENDING,
 };
 
 /**
  * struct queue_entry: Entry inside the &struct data_queue
  *
  * @flags: Entry flags, see &enum queue_entry_flags.
  * @last_action: Timestamp of last change.
  * @queue: The data queue (&struct data_queue) to which this entry belongs.
  * @skb: The buffer which is currently being transmitted (for TX queue),
  *  or used to directly receive data in (for RX queue).
  * @entry_idx: The entry index number.
  * @priv_data: Private data belonging to this queue entry. The pointer
  *  points to data specific to a particular driver and queue type.
  * @status: Device specific status
  */
 struct queue_entry {
     unsigned long flags;
     unsigned long last_action;
 
     struct data_queue *queue;
 
     struct sk_buff *skb;
 
     unsigned int entry_idx;
 
     void *priv_data;
 };
 
 /**
  * enum queue_index: Queue index type
  *
  * @Q_INDEX: Index pointer to the current entry in the queue, if this entry is
  *  owned by the hardware then the queue is considered to be full.
  * @Q_INDEX_DMA_DONE: Index pointer for the next entry which will have been
  *  transferred to the hardware.
  * @Q_INDEX_DONE: Index pointer to the next entry which will be completed by
  *  the hardware and for which we need to run the txdone handler. If this
  *  entry is not owned by the hardware the queue is considered to be empty.
  * @Q_INDEX_MAX: Keep last, used in &struct data_queue to determine the size
  *  of the index array.
  */
 enum queue_index {
     Q_INDEX,
     Q_INDEX_DMA_DONE,
     Q_INDEX_DONE,
     Q_INDEX_MAX,
 };
 
 /**
  * enum data_queue_flags: Status flags for data queues
  *
  * @QUEUE_STARTED: The queue has been started. Fox RX queues this means the
  *  device might be DMA'ing skbuffers. TX queues will accept skbuffers to
  *  be transmitted and beacon queues will start beaconing the configured
  *  beacons.
  * @QUEUE_PAUSED: The queue has been started but is currently paused.
  *  When this bit is set, the queue has been stopped in mac80211,
  *  preventing new frames to be enqueued. However, a few frames
  *  might still appear shortly after the pausing...
  */
 enum data_queue_flags {
     QUEUE_STARTED,
     QUEUE_PAUSED,
 };
 
 /**
  * struct data_queue: Data queue
  *
  * @rt2x00dev: Pointer to main &struct rt2x00dev where this queue belongs to.
  * @entries: Base address of the &struct queue_entry which are
  *  part of this queue.
  * @qid: The queue identification, see &enum data_queue_qid.
  * @flags: Entry flags, see &enum queue_entry_flags.
  * @status_lock: The mutex for protecting the start/stop/flush
  *  handling on this queue.
  * @tx_lock: Spinlock to serialize tx operations on this queue.
  * @index_lock: Spinlock to protect index handling. Whenever @index, @index_done or
  *  @index_crypt needs to be changed this lock should be grabbed to prevent
  *  index corruption due to concurrency.
  * @count: Number of frames handled in the queue.
  * @limit: Maximum number of entries in the queue.
  * @threshold: Minimum number of free entries before queue is kicked by force.
  * @length: Number of frames in queue.
  * @index: Index pointers to entry positions in the queue,
  *  use &enum queue_index to get a specific index field.
  * @wd_count: watchdog counter number of times entry does change
  *      in the queue
  * @wd_idx: index of queue entry saved by watchdog
  * @txop: maximum burst time.
  * @aifs: The aifs value for outgoing frames (field ignored in RX queue).
  * @cw_min: The cw min value for outgoing frames (field ignored in RX queue).
  * @cw_max: The cw max value for outgoing frames (field ignored in RX queue).
  * @data_size: Maximum data size for the frames in this queue.
  * @desc_size: Hardware descriptor size for the data in this queue.
  * @priv_size: Size of per-queue_entry private data.
  * @usb_endpoint: Device endpoint used for communication (USB only)
  * @usb_maxpacket: Max packet size for given endpoint (USB only)
  */
 struct data_queue {
     struct rt2x00_dev *rt2x00dev;
     struct queue_entry *entries;
 
     enum data_queue_qid qid;
     unsigned long flags;
 
     struct mutex status_lock;
     spinlock_t tx_lock;
     spinlock_t index_lock;
 
     unsigned int count;
     unsigned short limit;
     unsigned short threshold;
     unsigned short length;
     unsigned short index[Q_INDEX_MAX];
 
     unsigned short wd_count;
     unsigned int wd_idx;
 
     unsigned short txop;
     unsigned short aifs;
     unsigned short cw_min;
     unsigned short cw_max;
 
     unsigned short data_size;
     unsigned char  desc_size;
     unsigned char  winfo_size;
     unsigned short priv_size;
 
     unsigned short usb_endpoint;
     unsigned short usb_maxpacket;
 };
 
 /**
  * queue_end - Return pointer to the last queue (HELPER MACRO).
  * @__dev: Pointer to &struct rt2x00_dev
  *
  * Using the base rx pointer and the maximum number of available queues,
  * this macro will return the address of 1 position beyond  the end of the
  * queues array.
  */
 #define queue_end(__dev) \
     &(__dev)->rx[(__dev)->data_queues]
 
 /**
  * tx_queue_end - Return pointer to the last TX queue (HELPER MACRO).
  * @__dev: Pointer to &struct rt2x00_dev
  *
  * Using the base tx pointer and the maximum number of available TX
  * queues, this macro will return the address of 1 position beyond
  * the end of the TX queue array.
  */
 #define tx_queue_end(__dev) \
     &(__dev)->tx[(__dev)->ops->tx_queues]
 
 /**
  * queue_next - Return pointer to next queue in list (HELPER MACRO).
  * @__queue: Current queue for which we need the next queue
  *
  * Using the current queue address we take the address directly
  * after the queue to take the next queue. Note that this macro
  * should be used carefully since it does not protect against
  * moving past the end of the list. (See macros &queue_end and
  * &tx_queue_end for determining the end of the queue).
  */
 #define queue_next(__queue) \
     &(__queue)[1]
 
 /**
  * queue_loop - Loop through the queues within a specific range (HELPER MACRO).
  * @__entry: Pointer where the current queue entry will be stored in.
  * @__start: Start queue pointer.
  * @__end: End queue pointer.
  *
  * This macro will loop through all queues between &__start and &__end.
  */
 #define queue_loop(__entry, __start, __end)         \
     for ((__entry) = (__start);             \
          prefetch(queue_next(__entry)), (__entry) != (__end);\
          (__entry) = queue_next(__entry))
 
 /**
  * queue_for_each - Loop through all queues
  * @__dev: Pointer to &struct rt2x00_dev
  * @__entry: Pointer where the current queue entry will be stored in.
  *
  * This macro will loop through all available queues.
  */
 #define queue_for_each(__dev, __entry) \
     queue_loop(__entry, (__dev)->rx, queue_end(__dev))
 
 /**
  * tx_queue_for_each - Loop through the TX queues
  * @__dev: Pointer to &struct rt2x00_dev
  * @__entry: Pointer where the current queue entry will be stored in.
  *
  * This macro will loop through all TX related queues excluding
  * the Beacon and Atim queues.
  */
 #define tx_queue_for_each(__dev, __entry) \
     queue_loop(__entry, (__dev)->tx, tx_queue_end(__dev))
 
 /**
  * txall_queue_for_each - Loop through all TX related queues
  * @__dev: Pointer to &struct rt2x00_dev
  * @__entry: Pointer where the current queue entry will be stored in.
  *
  * This macro will loop through all TX related queues including
  * the Beacon and Atim queues.
  */
 #define txall_queue_for_each(__dev, __entry) \
     queue_loop(__entry, (__dev)->tx, queue_end(__dev))
 
 /**
  * rt2x00queue_for_each_entry - Loop through all entries in the queue
  * @queue: Pointer to @data_queue
  * @start: &enum queue_index Pointer to start index
  * @end: &enum queue_index Pointer to end index
  * @data: Data to pass to the callback function
  * @fn: The function to call for each &struct queue_entry
  *
  * This will walk through all entries in the queue, in chronological
  * order. This means it will start at the current @start pointer
  * and will walk through the queue until it reaches the @end pointer.
  *
  * If fn returns true for an entry rt2x00queue_for_each_entry will stop
  * processing and return true as well.
  */
 bool rt2x00queue_for_each_entry(struct data_queue *queue,
                 enum queue_index start,
                 enum queue_index end,
                 void *data,
                 bool (*fn)(struct queue_entry *entry,
                        void *data));
 
 /**
  * rt2x00queue_empty - Check if the queue is empty.
  * @queue: Queue to check if empty.
  */
 static inline int rt2x00queue_empty(struct data_queue *queue)
 {
     return queue->length == 0;
 }
 
 /**
  * rt2x00queue_full - Check if the queue is full.
  * @queue: Queue to check if full.
  */
 static inline int rt2x00queue_full(struct data_queue *queue)
 {
     return queue->length == queue->limit;
 }
 
 /**
  * rt2x00queue_free - Check the number of available entries in queue.
  * @queue: Queue to check.
  */
 static inline int rt2x00queue_available(struct data_queue *queue)
 {
     return queue->limit - queue->length;
 }
 
 /**
  * rt2x00queue_threshold - Check if the queue is below threshold
  * @queue: Queue to check.
  */
 static inline int rt2x00queue_threshold(struct data_queue *queue)
 {
     return rt2x00queue_available(queue) < queue->threshold;
 }
 /**
  * rt2x00queue_dma_timeout - Check if a timeout occurred for DMA transfers
  * @entry: Queue entry to check.
  */
 static inline int rt2x00queue_dma_timeout(struct queue_entry *entry)
 {
     if (!test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
         return false;
     return time_after(jiffies, entry->last_action + msecs_to_jiffies(100));
 }
 
 /**
  * _rt2x00_desc_read - Read a word from the hardware descriptor.
  * @desc: Base descriptor address
  * @word: Word index from where the descriptor should be read.
  */
 static inline __le32 _rt2x00_desc_read(__le32 *desc, const u8 word)
 {
     return desc[word];
 }
 
 /**
  * rt2x00_desc_read - Read a word from the hardware descriptor, this
  * function will take care of the byte ordering.
  * @desc: Base descriptor address
  * @word: Word index from where the descriptor should be read.
  */
 static inline u32 rt2x00_desc_read(__le32 *desc, const u8 word)
 {
     return le32_to_cpu(_rt2x00_desc_read(desc, word));
 }
 
 /**
  * rt2x00_desc_write - write a word to the hardware descriptor, this
  * function will take care of the byte ordering.
  * @desc: Base descriptor address
  * @word: Word index from where the descriptor should be written.
  * @value: Value that should be written into the descriptor.
  */
 static inline void _rt2x00_desc_write(__le32 *desc, const u8 word, __le32 value)
 {
     desc[word] = value;
 }
 
 /**
  * rt2x00_desc_write - write a word to the hardware descriptor.
  * @desc: Base descriptor address
  * @word: Word index from where the descriptor should be written.
  * @value: Value that should be written into the descriptor.
  */
 static inline void rt2x00_desc_write(__le32 *desc, const u8 word, u32 value)
 {
     _rt2x00_desc_write(desc, word, cpu_to_le32(value));
 }
 
 #endif /* RT2X00QUEUE_H */

This page was automatically generated by the 2.1.0 LXR engine. The LXR team