요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
TX timeout and maximum rate
sysfs-class-net-queues:19-34TX queue별 timeout event counter와 Mbps 단위 maximum rate를 구분합니다.
Transmit Packet Steering
sysfs-class-net-queues:35-54XPS processing에 참여하는 CPU 또는 RX queue mask를 TX queue별로 설정합니다.
BQL timing and in-flight bytes
sysfs-class-net-queues:56-71Dynamic Queue Limits의 slack 측정 hold time과 현재 전송 중인 byte 수를 제공합니다.
BQL minimum and maximum limits
sysfs-class-net-queues:73-98현재 queue byte limit을 absolute minimum과 maximum 경계 안으로 clamp합니다.
TX completion stall detection
sysfs-class-net-queues:100-121Millisecond threshold, detected stall count와 longest stall 값을 통해 TX completion 정체를 진단합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/net/<iface>/queues/rx-<queue>/rps_cpus
2
Date: March 2010
3
KernelVersion: 2.6.35
4
Contact: netdev@vger.kernel.org
5
Description:
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.
11
What: /sys/class/net/<iface>/queues/rx-<queue>/rps_flow_cnt
12
Date: April 2010
13
KernelVersion: 2.6.35
14
Contact: netdev@vger.kernel.org
15
Description:
16
Number of Receive Packet Steering flows being currently
17
processed by this particular network device receive queue.
19
What: /sys/class/net/<iface>/queues/tx-<queue>/tx_timeout
20
Date: November 2011
21
KernelVersion: 3.3
22
Contact: netdev@vger.kernel.org
23
Description:
24
Indicates the number of transmit timeout events seen by this
25
network interface transmit queue.
27
What: /sys/class/net/<iface>/queues/tx-<queue>/tx_maxrate
28
Date: March 2015
29
KernelVersion: 4.1
30
Contact: netdev@vger.kernel.org
31
Description:
32
A Mbps max-rate set for the queue, a value of zero means disabled,
33
default is disabled.
35
What: /sys/class/net/<iface>/queues/tx-<queue>/xps_cpus
36
Date: November 2010
37
KernelVersion: 2.6.38
38
Contact: netdev@vger.kernel.org
39
Description:
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.
45
What: /sys/class/net/<iface>/queues/tx-<queue>/xps_rxqs
46
Date: June 2018
47
KernelVersion: 4.18.0
48
Contact: netdev@vger.kernel.org
49
Description:
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.
56
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/hold_time
57
Date: November 2011
58
KernelVersion: 3.3
59
Contact: netdev@vger.kernel.org
60
Description:
61
Indicates the hold time in milliseconds to measure the slack
62
of this particular network device transmit queue.
63
Default value is 1000.
65
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/inflight
66
Date: November 2011
67
KernelVersion: 3.3
68
Contact: netdev@vger.kernel.org
69
Description:
70
Indicates the number of bytes (objects) in flight on this
71
network device transmit queue.
73
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit
74
Date: November 2011
75
KernelVersion: 3.3
76
Contact: netdev@vger.kernel.org
77
Description:
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.
82
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_max
83
Date: November 2011
84
KernelVersion: 3.3
85
Contact: netdev@vger.kernel.org
86
Description:
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.
91
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_min
92
Date: November 2011
93
KernelVersion: 3.3
94
Contact: netdev@vger.kernel.org
95
Description:
96
Indicates the absolute minimum limit of bytes allowed to be
97
queued on this network device transmit queue. Default value is
98
0.
100
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_thrs
101
Date: Jan 2024
102
KernelVersion: 6.9
103
Contact: netdev@vger.kernel.org
104
Description:
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.
109
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_cnt
110
Date: Jan 2024
111
KernelVersion: 6.9
112
Contact: netdev@vger.kernel.org
113
Description:
114
Number of detected Tx completion stalls.
116
What: /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_max
117
Date: Jan 2024
118
KernelVersion: 6.9
119
Contact: netdev@vger.kernel.org
120
Description:
121
Longest detected Tx completion stall. Write 0 to clear.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
RPS CPU mask
1-9| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/rx-<queue>/rps_cpus |
| Date | 2010년 3월 |
| KernelVersion | 2.6.35 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device queue의 Receive Packet Steering packet processing flow에 현재 참여하도록 enable된 CPU의 mask입니다. 가능한 값은 system에서 사용할 수 있는 CPU 수에 따라 달라집니다. |
RPS flow count
11-17| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/rx-<queue>/rps_flow_cnt |
| Date | 2010년 4월 |
| KernelVersion | 2.6.35 |
| Contact | netdev@vger.kernel.org |
| Description | 이 특정 network device receive queue가 현재 처리하는 Receive Packet Steering flow 수입니다. |
속성대상값
rps_cpusRPS에 참여하는 CPUSystem CPU 수에 따른 mask
rps_flow_cnt현재 처리 중인 RPS flowFlow count
RPS의 processing CPU 집합과 queue별 flow 수를 구분합니다.
Transmit timeout events
19-25| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/tx_timeout |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network interface transmit queue에서 관찰된 transmit timeout event 수를 나타냅니다. |
Transmit queue maximum rate
27-33| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/tx_maxrate |
| Date | 2015년 3월 |
| KernelVersion | 4.1 |
| Contact | netdev@vger.kernel.org |
| Description | Queue에 설정한 Mbps 단위 maximum rate입니다. 0은 disabled를 뜻하며 기본값도 disabled입니다. |
속성의미단위 또는 기본값
tx_timeout관찰된 transmit timeout event 수Count
tx_maxrateQueue maximum rateMbps, 0은 disabled
TX queue의 누적 timeout event와 구성 가능한 rate limit을 구분합니다.
XPS CPU mask
35-43| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/xps_cpus |
| Date | 2010년 11월 |
| KernelVersion | 2.6.38 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue의 Transmit Packet Steering packet processing flow에 현재 참여하도록 enable된 CPU의 mask입니다. 가능한 값은 system에서 사용할 수 있는 CPU 수에 따라 달라집니다. |
XPS receive queue mask
45-54| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/xps_rxqs |
| Date | 2018년 6월 |
| KernelVersion | 4.18.0 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue의 Transmit Packet Steering packet processing flow에 현재 참여하도록 enable된 receive queue의 mask입니다. 가능한 값은 network device에서 사용할 수 있는 receive queue 수에 따라 달라집니다. 기본값은 disabled입니다. |
속성Mask 대상가능한 값의 기준기본값
xps_cpusCPUSystem의 available CPU 수원문에 명시되지 않음
xps_rxqsReceive queueDevice의 available RX queue 수Disabled
TX queue를 CPU locality 또는 RX queue locality에 대응시키는 두 XPS mask입니다.
BQL slack hold time
56-63| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/hold_time |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 특정 network device transmit queue의 slack을 측정하기 위한 hold time을 millisecond 단위로 나타냅니다. 기본값은 1000입니다. |
BQL in-flight bytes
65-71| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/inflight |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue에서 현재 전송 중인 byte(object) 수를 나타냅니다. |
BQL current byte limit
73-80| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue에 queue할 수 있는 현재 byte limit을 나타냅니다. 이 값은 limit_max와 limit_min이 정의하는 경계 안으로 clamp됩니다. |
BQL absolute maximum
82-89| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_max |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue에 queue할 수 있는 byte의 absolute maximum limit을 나타냅니다. 기본값은 include/linux/dynamic_queue_limits.h를 참조하십시오. |
BQL absolute minimum
91-98| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_min |
| Date | 2011년 11월 |
| KernelVersion | 3.3 |
| Contact | netdev@vger.kernel.org |
| Description | 이 network device transmit queue에 queue할 수 있는 byte의 absolute minimum limit을 나타냅니다. 기본값은 0입니다. |
속성의미기본값 또는 제약
hold_timeSlack 측정 hold time1000 ms
inflight현재 전송 중인 byte(object)Runtime value
limit현재 queue 가능 byte limitlimit_min 이상, limit_max 이하로 clamp
limit_maxAbsolute maximumdynamic_queue_limits.h 참조
limit_minAbsolute minimum0
BQL measurement와 현재 limit을 둘러싼 absolute 경계를 정리합니다.
TX completion stall threshold
100-107| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_thrs |
| Date | 2024년 1월 |
| KernelVersion | 6.9 |
| Contact | netdev@vger.kernel.org |
| Description | TX completion stall detection threshold를 millisecond 단위로 나타냅니다. Kernel은 이 threshold보다 긴 모든 stall을 detect하도록 보장하지만, threshold 절반보다 긴 stall도 detect할 수 있습니다. |
Detected TX stall count
109-114| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_cnt |
| Date | 2024년 1월 |
| KernelVersion | 6.9 |
| Contact | netdev@vger.kernel.org |
| Description | Detect된 TX completion stall 수입니다. |
Longest detected TX stall
116-121| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_max |
| Date | 2024년 1월 |
| KernelVersion | 6.9 |
| Contact | netdev@vger.kernel.org |
| Description | Detect된 TX completion stall 가운데 가장 긴 값입니다. 0을 쓰면 clear합니다. |
속성의미쓰기 동작
stall_thrsDetection threshold(ms)Threshold 설정
stall_cntDetect된 stall 수원문에 명시되지 않음
stall_max가장 긴 detected stall0을 쓰면 clear
Detection threshold와 누적 count, longest observed stall을 함께 해석합니다.
Receive Packet Steering
sysfs-class-net-queues:1-18RX queue의 RPS 참여 CPU mask와 현재 처리하는 flow 수를 제공합니다.