1NFSTEST_DIO(1) nfstest_dio 1.2 NFSTEST_DIO(1)
2
6 nfstest_dio - Direct I/O tests
7
9 nfstest_dio --server <server> [options]
10
12 Functional direct I/O tests verify that every READ/WRITE is sent to the
13 server instead of the client caching the requests. Client bypasses read
14 ahead by sending the READ with only the requested bytes. Verify the
15 client correctly handles eof marker when reading the whole file. Verify
16 client ignores delegation while writing a file.
17 Direct I/O on pNFS tests verify the client sends the READ/WRITE to the
19 correct DS or the MDS if using a PAGESIZE aligned buffer or not,
20 respectively.
21 Direct I/O data correctness tests verify that a file written with
23 buffered I/O is read correctly with direct I/O. Verify that a file
24 written with direct I/O is read correctly with buffered I/O.
25 Vectored I/O tests verify coalescence of multiple vectors into one
27 READ/WRITE packet when all vectors are PAGESIZE aligned. Vectors with
28 different alignments are sent on separate packets.
29 Valid for NFSv4.0 and NFSv4.1 including pNFS.
31
35 --version
36 show program's version number and exit
37 -h, --help
39 show this help message and exit
40 -f FILE, --file=FILE
42 File where options are specified besides the system wide file
43 /etc/nfstest, user wide file $HOME/.nfstest or in the current
44 directory .nfstest file
45 NFS specific options:
48 -s SERVER, --server=SERVER
49 Server name or IP address
50 -e EXPORT, --export=EXPORT
52 Exported file system to mount [default: '/']
53 --nfsversion=NFSVERSION
55 NFS version, e.g., 3, 4, 4.1, etc. [default: 4.1]
56 -m MTPOINT, --mtpoint=MTPOINT
58 Mount point [default: '/mnt/t']
59 -p PORT, --port=PORT
61 NFS server port [default: 2049]
62 --proto=PROTO
64 NFS protocol name [default: 'tcp']
65 --sec=SEC
67 Security flavor [default: 'sys']
68 -o MTOPTS, --mtopts=MTOPTS
70 Mount options [default: 'hard,intr']
71 --datadir=DATADIR
73 Data directory where files are created, directory is created on
74 the mount point [default: '']
75 Logging options:
78 -v VERBOSE, --verbose=VERBOSE
79 Verbose level for debug messages [default: 'none']
80 --tverbose=TVERBOSE
82 Verbose level for test messages [default: '1']
83 --createlog
85 Create log file
86 --rexeclog
88 Create rexec log files
89 --warnings
91 Display warnings
92 --tag=TAG
94 Informational tag, it is displayed as an INFO message [default:
95 '']
96 --notty
98 Do not use terminal colors on output
99 Packet trace options:
102 --createtraces
103 Create a packet trace for each test
104 --tbsize=TBSIZE
106 Capture buffer size for tcpdump [default: 192k]
107 --trcdelay=TRCDELAY
109 Seconds to delay before stopping packet trace [default: 0.0]
110 --keeptraces
112 Do not remove any trace files [default: remove trace files if no
113 errors]
114 --rmtraces
116 Remove trace files [default: remove trace files if no errors]
117 -i INTERFACE, --interface=INTERFACE
119 Device interface [default: automatically selected]
120 File options:
123 --nfiles=NFILES
124 Number of files to create [default: 2]
125 --filesize=FILESIZE
127 File size to use for test files [default: 262144]
128 --rsize=RSIZE
130 Read size to use when reading files [default: 4k]
131 --wsize=WSIZE
133 Write size to use when writing files [default: 4k]
134 --iodelay=IODELAY
136 Seconds to delay I/O operations [default: 0.1]
137 --offset-delta=OFFSET_DELTA
139 Read/Write offset delta [default: 4k]
140 Path options:
143 --sudo=SUDO
144 Full path of binary for sudo [default: '/usr/bin/sudo']
145 --tcpdump=TCPDUMP
147 Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
148 --iptables=IPTABLES
150 Full path of binary for iptables [default: '/usr/sbin/iptables']
151 --messages=MESSAGES
153 Full path of log messages file [default: '/var/log/messages']
154 --tmpdir=TMPDIR
156 Temporary directory [default: '/tmp']
157 Debug options:
160 --nocleanup
161 Do not cleanup created files
162 --bugmsgs=BUGMSGS
164 File containing test messages to mark as bugs if they failed
165 --ignore
167 Ignore all bugs given by bugmsgs
168 --nomount
170 Do not mount server and run the tests on local disk space
171 --basename=BASENAME
173 Base name for all files and logs [default: automatically gener‐
174 ated]
175 --nfsdebug=NFSDEBUG
177 Set NFS kernel debug flags and save log messages [default: '']
178 --rpcdebug=RPCDEBUG
180 Set RPC kernel debug flags and save log messages [default: '']
181 --pktdisp
183 Display main packets related to the given test
184 Test options:
187 --runtest=RUNTEST
188 Comma separated list of tests to run, if list starts with a '^'
189 then all tests are run except the ones listed [default: 'all']
190 --iotype=IOTYPE
192 List of I/O types to test [default: 'read,write']
193 --biotype=BIOTYPE
195 List of buffered I/O types to test [default: 'none,read,write']
196 --withdeleg=WITHDELEG
198 Use delegation on tests [default: both without and with delega‐
199 tion]
200
202 eof
203 Verify eof marker is handled correctly when reading the end
204 of the file.
205 correctness
207 Verify data correctness when reading/writing using direct I/O.
208 File created with buffered I/O is read correctly with direct I/O.
209 File created with direct I/O is read correctly with buffered I/O.
210 fstat
212 Verify fstat() gets correct file size after writing.
213 read
215 Verify READ is sent after writing when the file is open for
216 both read and write.
217 read_ahead
219 Verify READ is sent with only the requested bytes bypassing
220 read ahead.
221 basic
223 Verify a packet is sent for each I/O request.
224 rsize
226 Verify multiple READ packets are sent for each read request
227 having request size > rsize.
228 wsize
230 Verify multiple WRITE packets are sent for each write request
231 having request size > wsize
232 aligned
234 Verify packet is sent to correct DS server when using a memory
235 which is PAGESIZE aligned.
236 nonaligned
238 Verify packet is sent to the MDS when using a memory which
239 is not PAGESIZE aligned.
240 diffalign
242 Verify packets are sent to both the MDS and correct DS on same open
243 using buffers with different alignments.
244 stripesize
246 Verify multiple packets are sent for each request having the
247 request size greater than stripe size.
248 vectored_io
250 Verify vectored I/O functionality.
251
253 The only required option is --server
254 $ nfstest_dio --server 192.168.0.11
255
257 The user id in the local host must have access to run commands as root
258 using the 'sudo' command without the need for a password.
259
261 nfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_dele‐
262 gation(1), nfstest_file(1), nfstest_interop(1), nfstest_io(1),
263 nfstest_lock(1), nfstest_pkt(1), nfstest_pnfs(1), nfstest_posix(1),
264 nfstest_sparse(1), nfstest_ssc(1), nfstest_xid(1),
265 packet.nfs.nfs4_const(3)
266
269 No known bugs.
270
272 Jorge Mora (mora@netapp.com)
273NFStest 2.1.5 14 February 2017 NFSTEST_DIO(1)