include/net/netdev_queues.h

1 /* SPDX-License-Identifier: GPL-2.0 */
8  * struct netdev_config - queue-related configuration for a netdev
61  * struct netdev_stat_ops - netdev ops for fine grained stats
62  * @get_queue_stats_rx:	get stats for a given Rx queue
63  * @get_queue_stats_tx:	get stats for a given Tx queue
67  * on entry (specifically they are *not* zero-initialized). Drivers should
71  * Queue objects are not necessarily persistent, and only currently active
72  * queues are queried by the per-queue callbacks. This means that per-queue
79  * is issued to collect the delta, and then a series of per-queue callbacks.
81  * at the device level, meaning that unlike in queue callbacks, setting
89  * the @get_base_stats and subsequent per-queue calls are performed
92  * Device drivers are encouraged to reset the per-queue statistics when
94  * per-queue statistics is currently to detect traffic imbalance.
113  * struct netdev_queue_mgmt_ops - netdev ops for queue management
115  * @ndo_queue_mem_size: Size of the struct that describes a queue's memory.
117  * @ndo_queue_mem_alloc: Allocate memory for an RX queue at the specified index.
120  * @ndo_queue_mem_free:	Free memory from an RX queue.
122  * @ndo_queue_start:	Start an RX queue with the specified memory and at the
125  * @ndo_queue_stop:	Stop the RX queue at the specified index. The stopped
126  *			queue's memory is written at the specified address.
148  * DOC: Lockless queue stopping / waking helpers.
155  * wake attempts. The try-stop should happen from the xmit handler,
159  * The try-stop side is expected to run from the xmit handler and therefore
162  * handler may lead to xmit queue being enabled but not run.
191 			_res = -1;					\
197  * netif_txq_maybe_stop() - locklessly stop a Tx queue, if needed
200  * @stop_thrs:	minimal number of available descriptors for queue to be left
202  * @start_thrs:	minimal number of descriptors to re-enable the queue, can be
207  * return up-to-date information when evaluated!
211  *	 0 if the queue was stopped
212  *	 1 if the queue was left enabled
213  *	-1 if the queue was re-enabled (raced with waking)
239  * __netif_txq_completed_wake() - locklessly wake a Tx queue, if needed
244  * @start_thrs:	minimal number of descriptors to re-enable the queue
245  * @down_cond:	down condition, predicate indicating that the queue should
250  * return up-to-date information when evaluated!
254  *	 0 if the queue was woken up
255  *	 1 if the queue was already enabled (or disabled but @down_cond is true)
256  *	-1 if the queue was left unchanged (@start_thrs not reached)
264 		 * Barrier makes sure that anybody stopping the queue	\
270 		_res = -1;						\