← Documents Documentation/ABI/testing/sysfs-class-scsi_tape GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

SCSI tape statistics sysfs ABI

SCSI tape in-flight IO, total/read/write timing, operation·byte counters와 residual-on-error 통계를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-scsi_tape
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

In-flight and total IO time

sysfs-class-scsi_tape:1-25

st module과 SCSI mid-layer 사이의 current in-flight 수와 read/write/other command를 포함한 total completion wait를 제공합니다.

Other-command and read statistics

sysfs-class-scsi_tape:28-66

Read/write 외 command count와 variable block-size tape의 requested read bytes, request count와 nanosecond wait를 제공합니다.

Write statistics

sysfs-class-scsi_tape:69-97

Written byte count, write request count와 nanosecond completion wait를 제공하며 attribute 이름은 write_ms입니다.

Residual-on-error count

sysfs-class-scsi_tape:100-109

SCSI mid-layer error와 함께 positive residual이 발견된 횟수를 세며 oversized read가 한 원인이 될 수 있습니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/class/scsi_tape/*/stats/in_flight
2 Date: Apr 2015
3 KernelVersion: 4.2
4 Contact: Shane Seymour <shane.seymour@hp.com>
5 Description:
6 Show the number of I/Os currently in-flight between the st
7 module and the SCSI mid-layer.
8 Users:
9
10
11 What: /sys/class/scsi_tape/*/stats/io_ns
12 Date: Apr 2015
13 KernelVersion: 4.2
14 Contact: Shane Seymour <shane.seymour@hp.com>
15 Description:
16 Shows the total amount of time spent waiting for all I/O
17 to and from the tape drive to complete. This includes all
18 reads, writes, and other SCSI commands issued to the tape
19 drive. An example of other SCSI commands would be tape
20 movement such as a rewind when a rewind tape device is
21 closed. This item is measured in nanoseconds.
22
23 To determine the amount of time spent waiting for other I/O
24 to complete subtract read_ns and write_ns from this value.
25 Users:
26
27
28 What: /sys/class/scsi_tape/*/stats/other_cnt
29 Date: Apr 2015
30 KernelVersion: 4.2
31 Contact: Shane Seymour <shane.seymour@hp.com>
32 Description:
33 The number of I/O requests issued to the tape drive other
34 than SCSI read/write requests.
35 Users:
36
37
38 What: /sys/class/scsi_tape/*/stats/read_byte_cnt
39 Date: Apr 2015
40 KernelVersion: 4.2
41 Contact: Shane Seymour <shane.seymour@hp.com>
42 Description:
43 Shows the total number of bytes requested from the tape drive.
44 This value is presented in bytes because tape drives support
45 variable length block sizes.
46 Users:
47
48
49 What: /sys/class/scsi_tape/*/stats/read_cnt
50 Date: Apr 2015
51 KernelVersion: 4.2
52 Contact: Shane Seymour <shane.seymour@hp.com>
53 Description:
54 Shows the total number of read requests issued to the tape
55 drive.
56 Users:
57
58
59 What: /sys/class/scsi_tape/*/stats/read_ns
60 Date: Apr 2015
61 KernelVersion: 4.2
62 Contact: Shane Seymour <shane.seymour@hp.com>
63 Description:
64 Shows the total amount of time in nanoseconds waiting for
65 read I/O requests to complete.
66 Users:
67
68
69 What: /sys/class/scsi_tape/*/stats/write_byte_cnt
70 Date: Apr 2015
71 KernelVersion: 4.2
72 Contact: Shane Seymour <shane.seymour@hp.com>
73 Description:
74 Shows the total number of bytes written to the tape drive.
75 This value is presented in bytes because tape drives support
76 variable length block sizes.
77 Users:
78
79
80 What: /sys/class/scsi_tape/*/stats/write_cnt
81 Date: Apr 2015
82 KernelVersion: 4.2
83 Contact: Shane Seymour <shane.seymour@hp.com>
84 Description:
85 Shows the total number of write requests issued to the tape
86 drive.
87 Users:
88
89
90 What: /sys/class/scsi_tape/*/stats/write_ms
91 Date: Apr 2015
92 KernelVersion: 4.2
93 Contact: Shane Seymour <shane.seymour@hp.com>
94 Description:
95 Shows the total amount of time in nanoseconds waiting for
96 write I/O requests to complete.
97 Users:
98
99
100 What: /sys/class/scsi_tape/*/stats/resid_cnt
101 Date: Apr 2015
102 KernelVersion: 4.2
103 Contact: Shane Seymour <shane.seymour@hp.com>
104 Description:
105 Shows the number of times we found that a residual >0
106 was found when the SCSI midlayer indicated that there was
107 an error. For reads this may be a case of someone issuing
108 reads greater than the block size.
109 Users:
110

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Current in-flight tape IO

1-9
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/in_flight
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
Descriptionst module과 SCSI mid-layer 사이에서 현재 in-flight 상태인 IO 수를 표시합니다.
Users

Total tape IO completion time

11-25
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/io_ns
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionTape drive로 보내거나 받는 모든 IO가 완료되기를 기다린 total time을 표시합니다. Read, write와 tape movement 같은 다른 SCSI command를 모두 포함합니다. 예를 들어 rewind tape device를 close할 때 수행되는 rewind가 other command입니다. 단위는 nanoseconds입니다. Other IO completion wait만 구하려면 이 값에서 read_ns와 write_ns를 빼십시오.
Users
SCSI tape total-time decomposition
Quantity계산 또는 의미
io_ns모든 tape IO completion wait
read_nsRead IO wait
write_nsWrite IO wait
Other IO waitio_ns - read_ns - write_ns

io_ns는 read, write와 other SCSI command wait를 모두 포함합니다.

Non-read/write SCSI request count

28-35
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/other_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionSCSI read/write request 이외에 tape drive로 발행한 IO request 수입니다.
Users

Requested read byte count

38-46
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/read_byte_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionTape drive에서 요청한 total byte 수를 표시합니다. Tape drive가 variable-length block size를 지원하므로 bytes 단위로 제공합니다.
Users

Tape read request count

49-56
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/read_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionTape drive에 발행한 total read request 수를 표시합니다.
Users

Tape read completion time

59-66
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/read_ns
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionRead IO request가 완료되기를 기다린 total time을 nanoseconds 단위로 표시합니다.
Users

Written byte count

69-77
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/write_byte_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionTape drive에 쓴 total byte 수를 표시합니다. Tape drive가 variable-length block size를 지원하므로 bytes 단위로 제공합니다.
Users

Tape write request count

80-87
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/write_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionTape drive에 발행한 total write request 수를 표시합니다.
Users

Tape write completion time

90-97
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/write_ms
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionWrite IO request가 완료되기를 기다린 total time을 표시합니다. Attribute 이름은 write_ms이지만 원문이 규정하는 단위는 nanoseconds입니다.
Users
SCSI tape read/write counters
DirectionRequestsBytesTime
Readread_cntread_byte_cntread_ns (ns)
Writewrite_cntwrite_byte_cntwrite_ms (원문 설명: ns)

Operation count, byte volume와 completion wait의 대응입니다.

Positive residual count on SCSI errors

100-109
항목한국어 전문 번역
What/sys/class/scsi_tape/*/stats/resid_cnt
Date2015년 4월
KernelVersion4.2
ContactShane Seymour <shane.seymour@hp.com>
DescriptionSCSI mid-layer가 error를 나타냈을 때 residual > 0이 발견된 횟수를 표시합니다. Read에서는 block size보다 큰 read를 발행한 경우가 한 예입니다.
Users
Residual error counting
SCSI requestMid-layer reports errorresidual > 0 확인resid_cnt 증가

SCSI error와 positive residual이 함께 관측될 때 resid_cnt를 증가시킵니다.