SysTutorials

Linux Manual Pages › Section 1

nfstest_io(1)

NAME

nfstest_io – I/O tool

SYNOPSIS

nfstest_io -d <datadir> [options]

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.

OPTIONS

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

Read and write:

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

File operations:

–create=CREATE
Create file percentage [default: 5]
–odgrade=ODGRADE
Open downgrade percentage [default: 10]
–osync=OSYNC
Open file with O_SYNC [default: 20]
–fsync=FSYNC
Percentage of fsync after write [default: 5]
–rename=RENAME
Rename file percentage [default: 5]
–remove=REMOVE
Remove file percentage [default: 5]
–trunc=TRUNC
Truncate file percentage [default: 5]
–ftrunc=FTRUNC
Truncate opened file percentage [default: 5]
–link=LINK
Create hard link percentage [default: 2]
–slink=SLINK
Create symbolic link percentage [default: 1]
–readdir=READDIR
List contents of directory percentage [default: 1]
–lock=LOCK
Lock file percentage [default: 20]
–unlock=UNLOCK
Unlock file percentage [default: 80]
–tlock=TLOCK
Lock test percentage [default: 50]
–lockfull=LOCKFULL
Lock full file percentage [default: 50]
–minfiles=MINFILES
Mininum number of files to create before any file operation is executed [default: 10]

File size options:

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

Logging options:

–createlog
Create log file
–createlogs
Create a log file for each process
–logdir=LOGDIR
Log directory [default: ‘/tmp’]

SEE ALSO

nfstest.file_io(3), nfstest_alloc(1), nfstest_cache(1), nfstest_delegation(1), nfstest_dio(1), nfstest_file(1), nfstest_interop(1), nfstest_lock(1), nfstest_pkt(1), nfstest_pnfs(1), nfstest_posix(1), nfstest_sparse(1), nfstest_xid(1)

BUGS

No known bugs.

AUTHOR

Jorge Mora (mora [at] netapp.com)