1NFSTEST_IO(1)                   nfstest_io 1.2                   NFSTEST_IO(1)
2
3
4

NAME

6       nfstest_io - I/O tool
7

SYNOPSIS

9       nfstest_io -d <datadir> [options]
10

DESCRIPTION

12       This  I/O  tool  is  used  to  create and manipulate files of different
13       types.  The arguments allow running for a specified period of  time  as
14       well as running multiple processes. Each process modifies a single file
15       at a time and the file name space is  different  for  each  process  so
16       there  are  no collisions between two different processes modifying the
17       same file.
18
19
20

OPTIONS

22       --version
23              show program's version number and exit
24
25       -h, --help
26              show this help message and exit
27
28       -d DATADIR, --datadir=DATADIR
29              Top level directory where files will be created, it will be cre‐
30              ated if it does not exist
31
32       -s SEED, --seed=SEED
33              Seed  to initialized the random number generator [default: auto‐
34              matically generated]
35
36       -n NPROCS, --nprocs=NPROCS
37              Number of processes to use [default: 1]
38
39       -r RUNTIME, --runtime=RUNTIME
40              Run time [default: '0']
41
42       -v VERBOSE, --verbose=VERBOSE
43              Verbose level: none|info|debug|dbg1-7|all [default: 'none']
44
45       -e, --exiterr
46              Exit on first error
47
48
49   Read and write:
50       --read=READ
51              Read file percentage [default: 40.0]
52
53       --write=WRITE
54              Write file percentage [default: 40.0]
55
56       --rdwr=RDWR
57              Read/write file percentage [default: 20.0]
58
59       --randio=RANDIO
60              Random file access percentage [default: 50.0]
61
62       --iodelay=IODELAY
63              Seconds to delay I/O operations [default: 0.0]
64
65       --direct
66              Use direct I/O
67
68       --rdwronly
69              Use read and write only, no rename, remove, etc.
70
71
72   File operations:
73       --create=CREATE
74              Create file percentage [default: 5.0]
75
76       --odgrade=ODGRADE
77              Open downgrade percentage [default: 5.0]
78
79       --osync=OSYNC
80              Open file with O_SYNC [default: 10.0]
81
82       --fsync=FSYNC
83              Percentage of fsync after write [default: 2.0]
84
85       --rename=RENAME
86              Rename file percentage [default: 5.0]
87
88       --remove=REMOVE
89              Remove file percentage [default: 5.0]
90
91       --trunc=TRUNC
92              Truncate file percentage [default: 2.0]
93
94       --ftrunc=FTRUNC
95              Truncate opened file percentage [default: 2.0]
96
97       --link=LINK
98              Create hard link percentage [default: 1.0]
99
100       --slink=SLINK
101              Create symbolic link percentage [default: 0.2]
102
103       --readdir=READDIR
104              List contents of directory percentage [default: 0.5]
105
106       --lock=LOCK
107              Lock file percentage [default: 20.0]
108
109       --unlock=UNLOCK
110              Unlock file percentage [default: 80.0]
111
112       --tlock=TLOCK
113              Lock test percentage [default: 20.0]
114
115       --lockfull=LOCKFULL
116              Lock full file percentage [default: 50.0]
117
118       --minfiles=MINFILES
119              Minimum number of files to create before any file  operation  is
120              executed [default: 10]
121
122
123   File size options:
124       --fsizeavg=FSIZEAVG
125              File size average [default: 1m]
126
127       --fsizedev=FSIZEDEV
128              File size standard deviation [default: 256k]
129
130       --rsize=RSIZE
131              Read block size [default: 64k]
132
133       --rsizedev=RSIZEDEV
134              Read block size standard deviation [default: 8k]
135
136       --wsize=WSIZE
137              Write block size [default: 64k]
138
139       --wsizedev=WSIZEDEV
140              Write block size standard deviation [default: 8k]
141
142       --sizemult=SIZEMULT
143              Size multiplier [default: 1.0]
144
145
146   Logging options:
147       --createlog
148              Create log file
149
150       --createlogs
151              Create a log file for each process
152
153       --logdir=LOGDIR
154              Log directory [default: '/tmp']
155

SEE ALSO

157       nfstest.file_io(3), nfstest_alloc(1), nfstest_cache(1), nfstest_delega‐
158       tion(1), nfstest_dio(1), nfstest_fcmp(1), nfstest_file(1),  nfstest_in‐
159       terop(1),   nfstest_lock(1),   nfstest_pkt(1),   nfstest_pnfs(1),   nf‐
160       stest_posix(1), nfstest_rdma(1), nfstest_sparse(1), nfstest_ssc(1), nf‐
161       stest_xattr(1), nfstest_xid(1)
162
163

BUGS

165       No known bugs.
166

AUTHOR

168       Jorge Mora (mora@netapp.com)
169
170
171
172NFStest 3.2                      21 March 2023                   NFSTEST_IO(1)
Impressum