Provided by: zfs-test_0.7.12-1ubuntu5_amd64 bug

NAME

       zpios - Directly test the DMU.

SYNOPSIS

       zpios [options] <-p pool>

DESCRIPTION

       This utility runs in-kernel DMU performance and stress tests that do not depend on the ZFS
       Posix Layer ("ZPL").

OPTIONS

       -t regex, --threadcount regex

              Start this many threads for each  test  series,  specified  as  a  comma  delimited
              regular expression. (eg: "-t 1,2,3")

              This option is mutually exclusive with the threadcount_* options.

       -l regex_low, --threadcount_low regex_low

       -h regex_high, --threadcount_high regex_high

       -e regex_incr, --threadcount_incr regex_incr

              Start  regex_low  threads  for  the  first  test,  add  regex_incr threads for each
              subsequent test, and start regex_high threads for the last test.

              These three options must be specified together and are mutually exclusive with  the
              threadcount option.

       -n regex, --regioncount regex

              Create  this  many  regions  for  each  test series, specified as a comma delimited
              regular expression. (eg: "-n 512,4096,65536")

              This option is mutually exclusive with the regioncount_* options.

       -i regex_low, --regioncount_low regex_low

       -j regex_high, --regioncount_high regex_high

       -k regex_incr, --regioncount_incr regex_incr

              Create regex_low regions for the  first  test,  add  regex_incr  regions  for  each
              subsequent test, and create regex_high regions for the last test.

              These  three options must be specified together and are mutually exclusive with the
              regioncount option.

       -o size, --offset size

              Create regions at size offset for each test series, specified as a comma  delimited
              regular  expression  with  an  optional  unit  suffix.   (eg:  "-o  4M"  means four
              megabytes.)

              This option is mutually exclusive with the offset_* options.

       -m size_low, --offset_low size_low

       -q size_high, --offset_high size_high

       -r size_incr, --offset_incr size_incr

              Create a region at size_low offset for the first test, add size_incr to the  offset
              for  each  subsequent  test,  and  create a region at size_high offset for the last
              test.

              These three options must be specified together and are mutually exclusive with  the
              offset option.

       -c size, --chunksize size

              Use  size  chunks  for each test, specified as a comma delimited regular expression
              with an optional unit suffix. (eg: "-c 1M" means one megabyte.) The chunk size must
              be at least the region size.

              This option is mutually exclusive with the chunksize_* options.

       -a size_low, --chunksize_low size_low

       -b size_high, --chunksize_high size_high

       -g size_incr, --chunksize_incr size_incr

              Use  a  size_low chunk size for the first test, add size_incr to the chunk size for
              each subsequent test, and use a size_high chunk size for the last test.

              These three options must be specified together and are mutually exclusive with  the
              chunksize option.

       -s size, --regionsize size

              Use  size  regions for each test, specified as a comma delimited regular expression
              with an optional unit suffix. (eg: "-s 1M" means one megabyte.)

              This option is mutually exclusive with the regionsize_* options.

       -A size_low, --regionsize_low size_low

       -B size_high, --regionsize_high size_high

       -C size_incr, --regionsize_incr size_incr

              Use a size_low region size for the first test, add size_incr to the region size for
              each subsequent test, and use a size_high region size for the last test.

              These  three options must be specified together and are mutually exclusive with the
              regionsize option.

       -S size | sizes, --blocksize size | sizes

              Use size ZFS  blocks  for  each  test,  specified  as  a  comma  delimited  regular
              expression  with  an  optional  unit  suffix. (eg: "-S 1M" means one megabyte.) The
              supported range is powers of two from 128K through 16M.  A range of blocks  can  be
              tested as follows: "-S 128K,256K,512K,1M".

       -L dmu_flags, --load dmu_flags

              Specify dmuio for regular DMU_IO, ssf for single shared file access, or fpp for per
              thread access. Use commas to delimit multiple flags. (eg: "-L dmuio,ssf")

       -p name, --pool name

              The pool name, which is mandatory.

       -M test, --name test

              An arbitrary string that appears in the program output.

       -x, --cleanup

              Enable the DMU_REMOVE flag.

       -P command, --prerun command

              Invoke command from the kernel before running the  test.  Shell  expansion  is  not
              performed    and    the    environment    is    set    to    HOME=/;    TERM=linux;
              PATH=/sbin:/usr/sbin:/bin:/usr/bin.

       -R command, --postrun command

              Invoke command from the kernel after running  the  test.  Shell  expansion  is  not
              performed    and    the    environment    is    set    to    HOME=/;    TERM=linux;
              PATH=/sbin:/usr/sbin:/bin:/usr/bin.

       -G directory, --log directory

              Put logging output in this directory.

       -I size, --regionnoise size

              Randomly vary the regionsize parameter for each test modulo size bytes.

       -N size, --chunknoise size

              Randomly vary the chunksize parameter for each test modulo size bytes.

       -T time, --threaddelay time

              Randomly vary the execution time for each test modulo time kernel jiffies.

       -V, --verify

              Enable the DMU_VERIFY flag for trivial data verification.

       -z, --zerocopy

              Enable the DMU_READ_ZC and DMU_WRITE_ZC flags, which  are  currently  unimplemented
              for Linux.

       -O, --nowait

              Enable the DMU_WRITE_NOWAIT flag.

       -f, --noprefetch

              Enable the DMU_READ_NOPF flag.

       -H, --human-readable

              Print PASS and FAIL results explicitly and put unit suffixes on large numbers.

       -v, --verbose

              Increase output verbosity.

       -? , --help

              Print the usage message.

AUTHORS

       The  original  zpios implementation was created by Cluster File Systems Inc and adapted to
       ZFS on Linux by Brian Behlendorf <behlendorf1@llnl.gov>.

       This man page was written by Darik Horn <dajhorn@vanadac.com>.

SEE ALSO

       zpool(8), zfs(8)