1NFSTEST_INTEROP(1)            nfstest_interop 1.1           NFSTEST_INTEROP(1)
2
3
4

NAME

6       nfstest_interop - NFS interoperability tests
7

SYNOPSIS

9       nfstest_interop --server <server> [options]
10

DESCRIPTION

12       Basic  interoperability tests verify that a file written with different
13       versions of NFS is written correctly. The contents of the file are ver‐
14       ified by reading the file back using one of the NFS versions.
15
16       The tests append different data from different versions of NFS one at a
17       time then reads the contents of the file to verify it was written  cor‐
18       rectly. This is done twice for each test:
19
20          1) Mount different versions of NFS (NFSv3, NFSv4, NFSv4.1)
21          2) Create empty file
22          3) Append data using NFSv3
23          4) Append data using NFSv4
24          5) Append data using NFSv4.1
25          6) Read file and verify contents are correct
26          7) Append data using NFSv3
27          8) Append data using NFSv4
28          9) Append data using NFSv4.1
29         10) Read file and verify contents are correct
30
31
32

OPTIONS

34       --version
35              show program's version number and exit
36
37       -h, --help
38              show this help message and exit
39
40       -f FILE, --file=FILE
41              File  where  options  are specified besides the system wide file
42              /etc/nfstest, user wide file $HOME/.nfstest or  in  the  current
43              directory .nfstest file
44
45
46   NFS specific options:
47       -s SERVER, --server=SERVER
48              Server name or IP address
49
50       -e EXPORT, --export=EXPORT
51              Exported file system to mount [default: '/']
52
53       --nfsversion=NFSVERSION
54              NFS version, e.g., 3, 4, 4.1, etc. [default: 4.1]
55
56       -m MTPOINT, --mtpoint=MTPOINT
57              Mount point [default: '/mnt/t']
58
59       -p PORT, --port=PORT
60              NFS server port [default: 2049]
61
62       --proto=PROTO
63              NFS protocol name [default: 'tcp']
64
65       --sec=SEC
66              Security flavor [default: 'sys']
67
68       --nconnect=NCONNECT
69              Multiple TCP connections option [default: '1']
70
71       -o MTOPTS, --mtopts=MTOPTS
72              Mount options [default: 'hard,rsize=4096,wsize=4096']
73
74       --datadir=DATADIR
75              Data  directory where files are created, directory is created on
76              the mount point [default: '']
77
78
79   Logging options:
80       -v VERBOSE, --verbose=VERBOSE
81              Verbose     level     for     debug      messages      [default:
82              'opts|info|dbg1|dbg2|dbg3']
83
84       --tverbose=TVERBOSE
85              Verbose level for test messages [default: '1']
86
87       --createlog
88              Create log file
89
90       --rexeclog
91              Create rexec log files
92
93       --warnings
94              Display warnings
95
96       --tag=TAG
97              Informational  tag, it is displayed as an INFO message [default:
98              '']
99
100       --notty
101              Do not use terminal colors on output
102
103       --isatty
104              Use terminal colors on output -- useful when running with nohup
105
106
107   Packet trace options:
108       --createtraces
109              Create a packet trace for each test
110
111       --tbsize=TBSIZE
112              Capture buffer size for tcpdump [default: 192k]
113
114       --trcdelay=TRCDELAY
115              Seconds to delay before stopping packet trace [default: 2.0]
116
117       --keeptraces
118              Do not remove any trace files [default: remove trace files if no
119              errors]
120
121       --rmtraces
122              Remove trace files [default: remove trace files if no errors]
123
124       -i INTERFACE, --interface=INTERFACE
125              Device interface [default: automatically selected]
126
127
128   File options:
129       --nfiles=NFILES
130              Number of files to create [default: 2]
131
132       --filesize=FILESIZE
133              File size to use for test files [default: 64k]
134
135       --rsize=RSIZE
136              Read size to use when reading files [default: 4k]
137
138       --wsize=WSIZE
139              Write size to use when writing files [default: 4k]
140
141       --iodelay=IODELAY
142              Seconds to delay I/O operations [default: 0.1]
143
144       --offset-delta=OFFSET_DELTA
145              Read/Write offset delta [default: 4k]
146
147
148   Path options:
149       --sudo=SUDO
150              Full path of binary for sudo [default: '/usr/bin/sudo']
151
152       --kill=KILL
153              Full path of binary for kill [default: '/usr/bin/kill']
154
155       --nfsstat=NFSSTAT
156              Full path of binary for nfsstat [default: '/usr/sbin/nfsstat']
157
158       --tcpdump=TCPDUMP
159              Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
160
161       --iptables=IPTABLES
162              Full path of binary for iptables [default: '/usr/sbin/iptables']
163
164       --messages=MESSAGES
165              Full path of log messages file [default: '/var/log/messages']
166
167       --trcevents=TRCEVENTS
168              Full path of tracing events directory [default: '/sys/kernel/de‐
169              bug/tracing/events']
170
171       --trcpipe=TRCPIPE
172              Full path of trace pipe file [default:  '/sys/kernel/debug/trac‐
173              ing/trace_pipe']
174
175       --tmpdir=TMPDIR
176              Temporary directory [default: '/tmp']
177
178
179   Debug options:
180       --nocleanup
181              Do not cleanup created files
182
183       --notimestamps
184              Do not display timestamps in debug messages
185
186       --bugmsgs=BUGMSGS
187              File containing test messages to mark as bugs if they failed
188
189       --nomount
190              Do not mount server and run the tests on local disk space
191
192       --basename=BASENAME
193              Base  name for all files and logs [default: automatically gener‐
194              ated]
195
196       --nfsdebug=NFSDEBUG
197              Set NFS kernel debug flags and save log messages [default: '']
198
199       --rpcdebug=RPCDEBUG
200              Set RPC kernel debug flags and save log messages [default: '']
201
202       --tracepoints=TRACEPOINTS
203              List of trace points modules to enable [default: '']
204
205       --nfsstats
206              Get NFS stats [default: 'False']
207
208       --pktdisp
209              Display main packets related to the given test
210
211       --nfserrors
212              Fail every NFS error found in the packet trace
213
214       --client-ipaddr=CLIENT_IPADDR
215              IP address of localhost
216
217
218   Reporting options:
219       --xunit-report
220              Generate xUnit compatible test report
221
222       --xunit-report-file=XUNIT_REPORT_FILE
223              Path to xout report file
224
225
226   Test options:
227       --runtest=RUNTEST
228              Comma separated list of tests to run, if list starts with a  '^'
229              then all tests are run except the ones listed [default: 'all']
230
231       --datasize=DATASIZE
232              Size  of  data  to  be  written by each version of NFS [default:
233              '10']
234

TESTS

236   test01
237       Verify appending data with NFSv3 is correctly read using NFSv3
238
239   test02
240       Verify appending data with NFSv3 is correctly read using NFSv4
241
242   test03
243       Verify appending data with NFSv3 is correctly read using NFSv4.1
244
245   test04
246       Verify appending data with NFSv4 is correctly read using NFSv3
247
248   test05
249       Verify appending data with NFSv4 is correctly read using NFSv4
250
251   test06
252       Verify appending data with NFSv4 is correctly read using NFSv4.1
253
254   test07
255       Verify appending data with NFSv4.1 is correctly read using NFSv3
256
257   test08
258       Verify appending data with NFSv4.1 is correctly read using NFSv4
259
260   test09
261       Verify appending data with NFSv4.1 is correctly read using NFSv4.1
262
263   test10
264       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv3
265
266   test11
267       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv4
268
269   test12
270       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv4.1
271
272   test13
273       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv3
274
275   test14
276       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv4
277
278   test15
279       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv4.1
280
281   test16
282       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv3
283
284   test17
285       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv4
286
287   test18
288       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv4.1
289
290   test19
291       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv3
292
293   test20
294       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv4
295
296   test21
297       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv4.1
298
299   test22
300       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv3
301
302   test23
303       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv4
304
305   test24
306       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv4.1
307
308   test25
309       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv3
310
311   test26
312       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv4
313
314   test27
315       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv4.1
316
317   test28
318       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv3
319
320   test29
321       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv4
322
323   test30
324       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv4.1
325
326   test31
327       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv3
328
329   test32
330       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv4
331
332   test33
333       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv4.1
334
335   test34
336       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv3
337
338   test35
339       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv4
340
341   test36
342       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv4.1
343
344   test37
345       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv3
346
347   test38
348       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv4
349
350   test39
351       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv4.1
352
353   test40
354       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv3
355
356   test41
357       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv4
358
359   test42
360       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv4.1
361
362   test43
363       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv3
364
365   test44
366       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv4
367
368   test45
369       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv4.1
370
371   all
372       Run all tests: test01, test02, test03, test04, test05, test06, test07,
373       test08, test09, test10, test11, test12, test13, test14, test15, test16,
374       test17, test18, test19, test20, test21, test22, test23, test24, test25,
375       test26, test27, test28, test29, test30, test31, test32, test33, test34,
376       test35, test36, test37, test38, test39, test40, test41, test42, test43,
377       test44, test45
378

SEE ALSO

380       nfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_dele‐
381       gation(1),   nfstest_dio(1),   nfstest_fcmp(1),   nfstest_file(1),  nf‐
382       stest_io(1),  nfstest_lock(1),  nfstest_pkt(1),  nfstest_pnfs(1),   nf‐
383       stest_posix(1), nfstest_rdma(1), nfstest_sparse(1), nfstest_ssc(1), nf‐
384       stest_xattr(1),        nfstest_xid(1),        packet.nfs.nfs3_const(3),
385       packet.nfs.nfs4_const(3)
386
387

BUGS

389       No known bugs.
390

AUTHOR

392       Jorge Mora (mora@netapp.com)
393
394
395
396NFStest 3.2                      21 March 2023              NFSTEST_INTEROP(1)