ioping

IOPING(1)                        User Commands                       IOPING(1)



NAME
       ioping - simple disk I/O latency monitoring tool

SYNOPSYS
       ioping [-LCDRq] [-c count] [-w deadline] [-p period] [-i interval]
              [-s size] [-S wsize] [-o offset] device|file|directory

       ioping -h | -v

DESCRIPTION
       This tool lets you monitor I/O latency in real time.

OPTIONS
       -c count
              Stop after count requests.

       -w deadline
              Stop after deadline time passed.

       -p period
              Print raw statistics for every period requests.

       -i interval
              Set time between requests to interval (1s).

       -s size
              Request size (4k).

       -S size
              Working set size (1m).

       -o offset
              Offset in input file.

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

       -C     Use cached I/O.

       -D     Use direct I/O.

       -R     Disk seek rate test (same as -q -i 0 -w 3 -S 64m).

       -q     Suppress human-readable output.

       -h     Display help message and exit.

       -v     Display version and exit.

   Argument suffixes
       For options that expect time argument (-i and -w), default is seconds,
       unless you specify one of the following suffixes (case-insensitive):

       us, usec
              microseconds

       ms, msec
              milliseconds

       s, sec seconds

       m, min minutes

       h, hour
              hours

       For options that expect "size" argument (-s, -S and -o), default is
       bytes, unless you specify one of the following suffixes (case-
       insensitive):

       s      disk sectors (a sector is always 512).

       k, kb  kilobytes

       p      memory pages (a page is always 4K).

       m, mb  megabytes

       g, gb  gigabytes

       t, tb  terabytes

       For options that expect "number" argument (-p and -c) you can
       optionally specify one of the following suffixes (case-insensitive):

       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.

EXAMPLES
       ioping .
              Show disk I/O latency using the default values and the current
              directory, until interrupted.

       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.

SEE ALSO
       Homepage ⟨http://code.google.com/p/ioping/⟩.

AUTHORS
       This program was written by Konstantin Khlebnikov ⟨koct9i@gmail.com⟩.
       Man-page was written by Kir Kolyshkin ⟨kir@openvz.org⟩.



                                   July 2011                         IOPING(1)