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

SEE ALSO

zpool(8), zfs(8)