File: dasdstat.8

package info (click to toggle)
s390-tools 2.3.0-1
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 6,176 kB
  • sloc: ansic: 87,755; sh: 8,398; cpp: 8,384; perl: 3,783; makefile: 1,476; asm: 654
file content (101 lines) | stat: -rw-r--r-- 2,536 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
.\" Copyright 2017 IBM Corp.
.\" s390-tools is free software; you can redistribute it and/or modify
.\" it under the terms of the MIT license. See LICENSE for details.
.\"
.TH LSDASD 8 "Feb 2011" "s390-tools"

.SH NAME
dasdstat \- read or modify the statistics of the DASD device driver.

.SH SYNOPSIS
.TP 8
.B dasdstat
.RB [ -h ]
.TP 8
.B dasdstat
.RB [ -e ]
.RB [ -d ]
.RB [ -r ]
.RB [ -i ]
.RB [ -l ]
.RB [ -c ]
.RB [ -w ]
.RB [ -V ]
.RB [ -v ]
.RI [ <statistic> " [" <statistic> "] ...]]"

.SH DESCRIPTION
The dasdstat command provides easy access to the debugfs based
statistics of the DASD device driver.

The DASD statistics feature allows to gather statistical data for the
I/O requests processed by the DASD device driver. This data can be
collected for individual DASD CCW devices (including PAV base and
alias devices), DASD block devices, or globally for all requests
handled by the DASD device driver.

When no other options are specified, then the default operation is to
print the statistics data in a formatted table. When no specific list
of statistics is given, then the operation will be performed on all
available statistics.

.SH OPTIONS
.TP 8
.BR -h | --help
Print help text.
.TP
.BR -e | --enable
Enable the statistics.
.TP
.BR -d | --disable
Disable the statistics.
.TP
.BR -r | --reset
Reset the statistics.
.TP
.BR -i | --directory
Specify the directory in which the statistics can be found.
.TP
.BR -l | --long
Print more detailed information, e.g differentiate between read and
write requests.
.TP
.BR -c | --columns " \fI<number>\fR"
Format the output in a table with the given number of columns.
.TP
.BR -w | --column-width " \fI<width>\fR"
Set the minimum width of the columns in the output table.
.TP
.BR -V | --verbose
Print more verbose information.
.TP
.BR -v | --version
Print the version of the s390-tools package and the command.
.TP
\fB<statistic>\fR =
Name of a statistic that the command should work on.

.SH EXAMPLES
\fBdasdstat\fR
.RS
Print a statistics table for each enabled statistic.
.RE

\fBdasdstat -e\fR
.RS
Enable all DASD statistics.
.RE

\fBdasdstat -l dasda 0.0.1800 0.0.18fe 0.0.18ff\fR
.RS
Print a detailed statistics table for DASD block device dasda and CCW
devices 0.0.1800, 0.0.18fe and 0.0.18ff. A typical scenario for this
example would be that dasda is the block device that belongs to
PAV base device 0.0.1800, and CCW devices 0.0.18fe and 0.0.18ff are the
associated alias devices.
.RE

.SH AUTHOR
.nf
This man-page was written by Stefan Weinhuber <wein@de.ibm.com>.
.fi