- experimental 3.2-1
| NFSTEST_IO(1) | nfstest_io 1.2 | 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.0]
- --write=WRITE
- Write file percentage [default: 40.0]
- --rdwr=RDWR
- Read/write file percentage [default: 20.0]
- --randio=RANDIO
- Random file access percentage [default: 50.0]
- --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.0]
- --odgrade=ODGRADE
- Open downgrade percentage [default: 5.0]
- --osync=OSYNC
- Open file with O_SYNC [default: 10.0]
- --fsync=FSYNC
- Percentage of fsync after write [default: 2.0]
- --rename=RENAME
- Rename file percentage [default: 5.0]
- --remove=REMOVE
- Remove file percentage [default: 5.0]
- --trunc=TRUNC
- Truncate file percentage [default: 2.0]
- --ftrunc=FTRUNC
- Truncate opened file percentage [default: 2.0]
- --link=LINK
- Create hard link percentage [default: 1.0]
- --slink=SLINK
- Create symbolic link percentage [default: 0.2]
- --readdir=READDIR
- List contents of directory percentage [default: 0.5]
- --lock=LOCK
- Lock file percentage [default: 20.0]
- --unlock=UNLOCK
- Unlock file percentage [default: 80.0]
- --tlock=TLOCK
- Lock test percentage [default: 20.0]
- --lockfull=LOCKFULL
- Lock full file percentage [default: 50.0]
- --minfiles=MINFILES
- Minimum 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.0]
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_fcmp(1), nfstest_file(1), nfstest_interop(1), nfstest_lock(1), nfstest_pkt(1), nfstest_pnfs(1), nfstest_posix(1), nfstest_rdma(1), nfstest_sparse(1), nfstest_ssc(1), nfstest_xattr(1), nfstest_xid(1)
BUGS¶
No known bugs.
AUTHOR¶
Jorge Mora (mora@netapp.com)
| 21 March 2023 | NFStest 3.2 |