manpagez: man pages & more
man ioping(1)
Home | html | info | man
ioping(1)                        User Commands                       ioping(1)




NAME

       ioping - simple disk I/O latency monitoring tool


SYNOPSYS

       directory|file|device
       -h | -v


DESCRIPTION

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


OPTIONS

       -a, -warmup count
              Ignore in statistics first count requests, default 1.

       -c, -count count
              Stop after count requests, default 0 (infinite).

       -i, -interval time
              Set time between requests, default 1s.

       -l, -speed-limit size
              Set speed limit  in  size  per  second.  Increases  interval  to
              request-size / speed.

       -r, -rate-limit count
              Set  rate  limit  in count per second. Increases interval to 1 /
              rate.

       -t, -min-time time
              Minimal valid request time (0us).  Too fast requests are ignored
              in statistics.

       -T, -max-time time
              Maximum  valid  request  time.  Too slow requests are ignored in
              statistics.

       -s, -size size
              Request size, default 4k.

       -S, -work-size size
              Working set size (1m for  directory,  whole  size  for  file  or
              device).

       -o, -work-offset size
              Starting offset in the file/device (0).

       -w, -work-time time
              Stop after time passed, default 0 (infinite).

       -p, -print-count count
              Print  raw  statistics  for  every  count  requests  (see format
              below).

       -P, -print-interval time
              Print raw statistics for every time.

       -A, -async
              Use asynchronous I/O (io_setup(2), io_submit(2) etc syscalls).

       -B, -batch
              Batch mode. Be quiet and print final statistics in raw format.

       -C, -cached
              Use cached  I/O.  Suppress  cache  invalidation  via  posix_fad-
              vise(2)) before read and fdatasync(2) after each write.

       -D, -direct
              Use direct I/O (see O_DIRECT in open(2)).

       -J, -json
              Print output in JSON format.

       -L, -linear
              Use  sequential  operations  rather  than random. This also sets
              default request size to 256k (as in -size 256k).

       -R, -rapid
              Disk seek rate test, or bandwidth test  if  used  together  with
              -linear.

              This  option suppress human-readable output for each request (as
              -quiet), sets default interval to zero (-interval 0), stops mea-
              surement  after  3  seconds (-work-time 3) and increases default
              working set size to 64m (-work-size 64m).  Working  set  (-work-
              size)  should be increased accordingly if disk has huge hardware
              cache.

       -W, -write
              Use writes rather than reads. Safe for temporary file in  direc-
              tory  target.  Write I/O gives more reliable results for systems
              where non-cached reads are  not  supported  or  cached  at  some
              level.

              Might  be  *DANGEROUS* for file/device: it will shred your data.
              In this case should be repeated three times (-WWW).

       -G, -read-write
              Alternate read and write requests.

       -Y, -sync
              Use sync I/O (see O_SYNC in open(2)).

       -y, -dsync
              Use data sync I/O (see O_DSYNC in open(2)).

       -k, -keep
              Keep and reuse temporary working  file  "ioping.tmp"  (only  for
              directory target).

       -q, -quiet
              Suppress periodical human-readable output.

       -h, -help
              Display help message and exit.

       -v, -version
              Display version and exit.

   Argument suffixes
       For  options  that expect time argument (-interval, -print-interval and
       -work-time), default is seconds, unless you specify one of the  follow-
       ing suffixes (case-insensitive):

       ns, nsec
              nanoseconds (a billionth of a second, 1 / 1 000 000 000)

       us, usec
              microseconds (a millionth of a second, 1 / 1 000 000)

       ms, msec
              milliseconds (a thousandth of a second, 1 / 1 000)

       s, sec seconds

       m, min minutes

       h, hour
              hours

       For  options  that  expect "size" argument (-size, -speed-limit, -work-
       size and -work-offset), default is bytes, unless you specify one of the
       following suffixes (case-insensitive):

       sector disk sectors (a sector is always 512).

       KiB, k, kb
              kilobytes (1 024 bytes)

       page   memory pages (a page is always 4KiB).

       MiB, m, mb
              megabytes (1 048 576 bytes)

       GiB, g, gb
              gigabytes (1 073 741 824 bytes)

       TiB, t, tb
              terabytes (1 099 511 627 776 bytes)

       For options that expect "number" argument (-count and -print-count) you
       can optionally specify one of  the  following  suffixes  (case-insensi-
       tive):

       k      kilo (thousands, 1 000)

       m      mega (millions, 1 000 000)

       g      giga (billions, 1 000 000 000)

       t      tera (trillions, 1 000 000 000 000)


EXIT STATUS

       Returns 0 upon success. The following error codes are defined:

       1      Invalid usage (error in arguments).

       2      Error during preparation stage.

       3      Error during runtime.


RAW STATISTICS

       ioping -print-count 100 -count 200 -interval 0 -quiet .
       99 10970974 9024 36961531 90437 110818 358872 30756 100 12516420
       100 9573265 10446 42785821 86849 95733 154609 10548 100 10649035
       (1) (2)     (3)   (4)      (5)   (6)   (7)    (8)   (9) (10)

       (1) count of requests in statistics
       (2) running time         (nanoseconds)
       (3) requests per second  (iops)
       (4) transfer speed       (bytes per second)
       (5) minimal request time (nanoseconds)
       (6) average request time (nanoseconds)
       (7) maximum request time (nanoseconds)
       (8) request time standard deviation (nanoseconds)
       (9) total requests       (including warmup, too slow or too fast)
       (10) total running time  (nanoseconds)


EXAMPLES

       ioping .
              Show disk I/O latency using the default values and the current
              directory, until interrupted. This command prepares temporary
              (unlinked/hidden) working file and reads random chunks from it
              using non-cached read requests.

       ioping -c 10 -s 1M /tmp
              Measure latency on /tmp using 10 requests of 1 megabyte each.

       ioping -R /dev/sda
              Measure disk seek rate.

       ioping -RL /dev/sda
              Measure disk sequential speed.

       ioping -RLB . | awk '{print $4}'
              Get disk sequential speed in bytes per second.


SEE ALSO

       iostat(1), dd(1), fio(1), stress(1), stress-ng(1), dbench(1), sys-
       bench(1), fsstress, xfstests, hdparm(8), badblocks(8),


HOMEPAGE


AUTHORS

       This program was written by Konstantin Khlebnikov
       Man-page was written by Kir Kolyshkin



                                   Oct 2014                          ioping(1)

ioping 1.2 - Generated Tue Feb 11 15:12:59 CST 2020
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.