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