.\" DO NOT MODIFY THIS FILE!  It was generated by setup.py 1.2.
.TH NFSTEST_IO 1 "21 March 2023" "NFStest 3.2" "nfstest_io 1.2"
.SH NAME
nfstest_io - I/O tool
.SH SYNOPSIS
nfstest_io -d <datadir> [options]
.SH DESCRIPTION
This I/O tool is used to create and manipulate files of different types.
The arguments allow running for a specified period of time as well as running
multiple processes. Each process modifies a single file at a time and the
file name space is different for each process so there are no collisions
between two different processes modifying the same file.


.SH OPTIONS
.IP "--version"
show program's version number and exit
.IP "-h, --help"
show this help message and exit
.IP "-d DATADIR, --datadir=DATADIR"
Top level directory where files will be created, it
will be created if it does not exist
.IP "-s SEED, --seed=SEED"
Seed to initialized the random number generator
[default: automatically generated]
.IP "-n NPROCS, --nprocs=NPROCS"
Number of processes to use [default: 1]
.IP "-r RUNTIME, --runtime=RUNTIME"
Run time [default: '0']
.IP "-v VERBOSE, --verbose=VERBOSE"
Verbose level: none|info|debug|dbg1-7|all [default:
\t'none']
.IP "-e, --exiterr"
Exit on first error

.SS Read and write:

.IP "--read=READ"
Read file percentage [default: 40.0]
.IP "--write=WRITE"
Write file percentage [default: 40.0]
.IP "--rdwr=RDWR"
Read/write file percentage [default: 20.0]
.IP "--randio=RANDIO"
Random file access percentage [default: 50.0]
.IP "--iodelay=IODELAY"
Seconds to delay I/O operations [default: 0.0]
.IP "--direct"
Use direct I/O
.IP "--rdwronly"
Use read and write only, no rename, remove, etc.

.SS File operations:

.IP "--create=CREATE"
Create file percentage [default: 5.0]
.IP "--odgrade=ODGRADE"
Open downgrade percentage [default: 5.0]
.IP "--osync=OSYNC"
Open file with O_SYNC [default: 10.0]
.IP "--fsync=FSYNC"
Percentage of fsync after write [default: 2.0]
.IP "--rename=RENAME"
Rename file percentage [default: 5.0]
.IP "--remove=REMOVE"
Remove file percentage [default: 5.0]
.IP "--trunc=TRUNC"
Truncate file percentage [default: 2.0]
.IP "--ftrunc=FTRUNC"
Truncate opened file percentage [default: 2.0]
.IP "--link=LINK"
Create hard link percentage [default: 1.0]
.IP "--slink=SLINK"
Create symbolic link percentage [default: 0.2]
.IP "--readdir=READDIR"
List contents of directory percentage [default: 0.5]
.IP "--lock=LOCK"
Lock file percentage [default: 20.0]
.IP "--unlock=UNLOCK"
Unlock file percentage [default: 80.0]
.IP "--tlock=TLOCK"
Lock test percentage [default: 20.0]
.IP "--lockfull=LOCKFULL"
Lock full file percentage [default: 50.0]
.IP "--minfiles=MINFILES"
Minimum number of files to create before any file
operation is executed [default: 10]

.SS File size options:

.IP "--fsizeavg=FSIZEAVG"
File size average [default: 1m]
.IP "--fsizedev=FSIZEDEV"
File size standard deviation [default: 256k]
.IP "--rsize=RSIZE"
Read block size [default: 64k]
.IP "--rsizedev=RSIZEDEV"
Read block size standard deviation [default: 8k]
.IP "--wsize=WSIZE"
Write block size [default: 64k]
.IP "--wsizedev=WSIZEDEV"
Write block size standard deviation [default: 8k]
.IP "--sizemult=SIZEMULT"
Size multiplier [default: 1.0]

.SS Logging options:

.IP "--createlog"
Create log file
.IP "--createlogs"
Create a log file for each process
.IP "--logdir=LOGDIR"
Log directory [default: '/tmp']
.SH SEE ALSO
.BR nfstest.file_io(3),
.BR nfstest_alloc(1),
.BR nfstest_cache(1),
.BR nfstest_delegation(1),
.BR nfstest_dio(1),
.BR nfstest_fcmp(1),
.BR nfstest_file(1),
.BR nfstest_interop(1),
.BR nfstest_lock(1),
.BR nfstest_pkt(1),
.BR nfstest_pnfs(1),
.BR nfstest_posix(1),
.BR nfstest_rdma(1),
.BR nfstest_sparse(1),
.BR nfstest_ssc(1),
.BR nfstest_xattr(1),
.BR nfstest_xid(1)

.SH BUGS
No known bugs.
.SH AUTHOR
Jorge Mora (mora@netapp.com)