xref: /linux/Documentation/ABI/testing/sysfs-class-net-queues (revision f5c31bcf604db54470868f3118a60dc4a9ba8813)
1What:		/sys/class/net/<iface>/queues/rx-<queue>/rps_cpus
2Date:		March 2010
3KernelVersion:	2.6.35
4Contact:	netdev@vger.kernel.org
5Description:
6		Mask of the CPU(s) currently enabled to participate into the
7		Receive Packet Steering packet processing flow for this
8		network device queue. Possible values depend on the number
9		of available CPU(s) in the system.
10
11What:		/sys/class/net/<iface>/queues/rx-<queue>/rps_flow_cnt
12Date:		April 2010
13KernelVersion:	2.6.35
14Contact:	netdev@vger.kernel.org
15Description:
16		Number of Receive Packet Steering flows being currently
17		processed by this particular network device receive queue.
18
19What:		/sys/class/net/<iface>/queues/tx-<queue>/tx_timeout
20Date:		November 2011
21KernelVersion:	3.3
22Contact:	netdev@vger.kernel.org
23Description:
24		Indicates the number of transmit timeout events seen by this
25		network interface transmit queue.
26
27What:		/sys/class/net/<iface>/queues/tx-<queue>/tx_maxrate
28Date:		March 2015
29KernelVersion:	4.1
30Contact:	netdev@vger.kernel.org
31Description:
32		A Mbps max-rate set for the queue, a value of zero means disabled,
33		default is disabled.
34
35What:		/sys/class/net/<iface>/queues/tx-<queue>/xps_cpus
36Date:		November 2010
37KernelVersion:	2.6.38
38Contact:	netdev@vger.kernel.org
39Description:
40		Mask of the CPU(s) currently enabled to participate into the
41		Transmit Packet Steering packet processing flow for this
42		network device transmit queue. Possible values depend on the
43		number of available CPU(s) in the system.
44
45What:		/sys/class/net/<iface>/queues/tx-<queue>/xps_rxqs
46Date:		June 2018
47KernelVersion:	4.18.0
48Contact:	netdev@vger.kernel.org
49Description:
50		Mask of the receive queue(s) currently enabled to participate
51		into the Transmit Packet Steering packet processing flow for this
52		network device transmit queue. Possible values depend on the
53		number of available receive queue(s) in the network device.
54		Default is disabled.
55
56What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/hold_time
57Date:		November 2011
58KernelVersion:	3.3
59Contact:	netdev@vger.kernel.org
60Description:
61		Indicates the hold time in milliseconds to measure the slack
62		of this particular network device transmit queue.
63		Default value is 1000.
64
65What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/inflight
66Date:		November 2011
67KernelVersion:	3.3
68Contact:	netdev@vger.kernel.org
69Description:
70		Indicates the number of bytes (objects) in flight on this
71		network device transmit queue.
72
73What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit
74Date:		November 2011
75KernelVersion:	3.3
76Contact:	netdev@vger.kernel.org
77Description:
78		Indicates the current limit of bytes allowed to be queued
79		on this network device transmit queue. This value is clamped
80		to be within the bounds defined by limit_max and limit_min.
81
82What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_max
83Date:		November 2011
84KernelVersion:	3.3
85Contact:	netdev@vger.kernel.org
86Description:
87		Indicates the absolute maximum limit of bytes allowed to be
88		queued on this network device transmit queue. See
89		include/linux/dynamic_queue_limits.h for the default value.
90
91What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_min
92Date:		November 2011
93KernelVersion:	3.3
94Contact:	netdev@vger.kernel.org
95Description:
96		Indicates the absolute minimum limit of bytes allowed to be
97		queued on this network device transmit queue. Default value is
98		0.
99
100What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_thrs
101Date:		Jan 2024
102KernelVersion:	6.9
103Contact:	netdev@vger.kernel.org
104Description:
105		Tx completion stall detection threshold in ms. Kernel will
106		guarantee to detect all stalls longer than this threshold but
107		may also detect stalls longer than half of the threshold.
108
109What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_cnt
110Date:		Jan 2024
111KernelVersion:	6.9
112Contact:	netdev@vger.kernel.org
113Description:
114		Number of detected Tx completion stalls.
115
116What:		/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_max
117Date:		Jan 2024
118KernelVersion:	6.9
119Contact:	netdev@vger.kernel.org
120Description:
121		Longest detected Tx completion stall. Write 0 to clear.
122