1IOPING(1)                        User Commands                       IOPING(1)
2
3
4

NAME

6       ioping - simple disk I/O latency monitoring tool
7

SYNOPSYS

9       ioping [-ABCDLRWGYykq] [-c count] [-i interval] [-l speed] [-t time]
10              [-T time] [-s size] [-S wsize] [-o offset] [-w deadline]
11              [-p period] [-P period] directory|file|device
12       ioping -h | -v
13

DESCRIPTION

15       This tool generates various I/O patterns and lets you monitor I/O speed
16       and latency in real time.
17

OPTIONS

19       -c count
20              Stop after count requests.
21
22       -i interval
23              Set time between requests to interval (1s).
24
25       -l speed
26              Set speed limit in bytes per second. Set interval to request-
27              size / speed.
28
29       -t time
30              Minimal valid request time (0us).  Too fast requests are ignored
31              in statistics.
32
33       -T time
34              Maximum valid request time.  Too slow requests are ignored in
35              statistics.
36
37       -s size
38              Request size (4k).
39
40       -S wsize
41              Working set size (1m for directory, whole size for file or
42              device).
43
44       -o offset
45              Starting offset in the file/device (0).
46
47       -w deadline
48              Stop after deadline time passed.
49
50       -p period
51              Print raw statistics for every period requests (see format
52              below).
53
54       -P period
55              Print raw statistics for every period in time.
56
57       -A     Use asynchronous I/O (io_setup(2), io_submit(2) etc syscalls).
58
59       -B     Batch mode. Be quiet and print final statistics in raw format.
60
61       -C     Use cached I/O. Suppress cache invalidation via
62              posix_fadvise(2)) before read and fdatasync(2) after each write.
63
64       -D     Use direct I/O (see O_DIRECT in open(2)).
65
66       -L     Use sequential operations rather than random. This also sets
67              default request size to 256k (as in -s 256k).
68
69       -R     Disk seek rate test. This option suppress human-readable output
70              for each request (as -q), sets default interval to zero (-i 0),
71              stops measurement after 3 seconds (-w 3) and increases default
72              working set size to 64m (-S 64m). Working set (-S) should be
73              increased accordingly if disk has huge cache.
74
75       -W     Use writes rather than reads. Safe for directory target. Write
76              I/O gives more reliable results for systems where non-cached
77              reads are not supported or cached at some level. Might be
78              *DANGEROUS* for file/device: it will shred your data. In this
79              case should be repeated three times (-WWW).
80
81       -G     Alternate read and write requests.
82
83       -Y     Use sync I/O (see O_SYNC in open(2)).
84
85       -y     Use data sync I/O (see O_DSYNC in open(2)).
86
87       -k     Keep and reuse temporary working file "ioping.tmp" (only for
88              directory target).
89
90       -q     Suppress periodical human-readable output.
91
92       -h     Display help message and exit.
93
94       -v     Display version and exit.
95
96   Argument suffixes
97       For options that expect time argument (-i, -P and -w), default is
98       seconds, unless you specify one of the following suffixes (case-
99       insensitive):
100
101       ns, nsec
102              nanoseconds (a billionth of a second, 1 / 1 000 000 000)
103
104       us, usec
105              microseconds (a millionth of a second, 1 / 1 000 000)
106
107       ms, msec
108              milliseconds (a thousandth of a second, 1 / 1 000)
109
110       s, sec seconds
111
112       m, min minutes
113
114       h, hour
115              hours
116
117       For options that expect "size" argument (-s, -S and -o), default is
118       bytes, unless you specify one of the following suffixes (case-
119       insensitive):
120
121       sector disk sectors (a sector is always 512).
122
123       KiB, k, kb
124              kilobytes (1 024 bytes)
125
126       page   memory pages (a page is always 4KiB).
127
128       MiB, m, mb
129              megabytes (1 048 576 bytes)
130
131       GiB, g, gb
132              gigabytes (1 073 741 824 bytes)