zpios

Section: User Commands (1)
Updated: 2013 FEB 28

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHORS
SEE ALSO

Return to Main Contents

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>.