1NFSTEST_INTEROP(1)            nfstest_interop 1.0           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       -o MTOPTS, --mtopts=MTOPTS
69              Mount options [default: 'hard,rsize=4096,wsize=4096']
70
71       --datadir=DATADIR
72              Data  directory where files are created, directory is created on
73              the mount point [default: '']
74
75
76   Logging options:
77       -v VERBOSE, --verbose=VERBOSE
78              Verbose level for debug messages [default: 'none']
79
80       --tverbose=TVERBOSE
81              Verbose level for test messages [default: '1']
82
83       --createlog
84              Create log file
85
86       --rexeclog
87              Create rexec log files
88
89       --warnings
90              Display warnings
91
92       --tag=TAG
93              Informational tag, it is displayed as an INFO message  [default:
94              '']
95
96       --notty
97              Do not use terminal colors on output
98
99
100   Packet trace options:
101       --createtraces
102              Create a packet trace for each test
103
104       --tbsize=TBSIZE
105              Capture buffer size for tcpdump [default: 192k]
106
107       --trcdelay=TRCDELAY
108              Seconds to delay before stopping packet trace [default: 0.0]
109
110       --keeptraces
111              Do not remove any trace files [default: remove trace files if no
112              errors]
113
114       --rmtraces
115              Remove trace files [default: remove trace files if no errors]
116
117       -i INTERFACE, --interface=INTERFACE
118              Device interface [default: automatically selected]
119
120
121   File options:
122       --nfiles=NFILES
123              Number of files to create [default: 2]
124
125       --filesize=FILESIZE
126              File size to use for test files [default: 64k]
127
128       --rsize=RSIZE
129              Read size to use when reading files [default: 4k]
130
131       --wsize=WSIZE
132              Write size to use when writing files [default: 4k]
133
134       --iodelay=IODELAY
135              Seconds to delay I/O operations [default: 0.1]
136
137       --offset-delta=OFFSET_DELTA
138              Read/Write offset delta [default: 4k]
139
140
141   Path options:
142       --sudo=SUDO
143              Full path of binary for sudo [default: '/usr/bin/sudo']
144
145       --tcpdump=TCPDUMP
146              Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
147
148       --iptables=IPTABLES
149              Full path of binary for iptables [default: '/usr/sbin/iptables']
150
151       --messages=MESSAGES
152              Full path of log messages file [default: '/var/log/messages']
153
154       --tmpdir=TMPDIR
155              Temporary directory [default: '/tmp']
156
157
158   Debug options:
159       --nocleanup
160              Do not cleanup created files
161
162       --bugmsgs=BUGMSGS
163              File containing test messages to mark as bugs if they failed
164
165       --ignore
166              Ignore all bugs given by bugmsgs
167
168       --nomount
169              Do not mount server and run the tests on local disk space
170
171       --basename=BASENAME
172              Base name for all files and logs [default: automatically  gener‐
173              ated]
174
175       --nfsdebug=NFSDEBUG
176              Set NFS kernel debug flags and save log messages [default: '']
177
178       --rpcdebug=RPCDEBUG
179              Set RPC kernel debug flags and save log messages [default: '']
180
181       --pktdisp
182              Display main packets related to the given test
183
184
185   Test options:
186       --runtest=RUNTEST
187              Comma  separated list of tests to run, if list starts with a '^'
188              then all tests are run except the ones listed [default: 'all']
189
190       --datasize=DATASIZE
191              Size of data to be written by  each  version  of  NFS  [default:
192              '10']
193

TESTS

195   test01
196       Verify appending data with NFSv3 is correctly read using NFSv3
197
198   test02
199       Verify appending data with NFSv3 is correctly read using NFSv4
200
201   test03
202       Verify appending data with NFSv3 is correctly read using NFSv4.1
203
204   test04
205       Verify appending data with NFSv4 is correctly read using NFSv3
206
207   test05
208       Verify appending data with NFSv4 is correctly read using NFSv4
209
210   test06
211       Verify appending data with NFSv4 is correctly read using NFSv4.1
212
213   test07
214       Verify appending data with NFSv4.1 is correctly read using NFSv3
215
216   test08
217       Verify appending data with NFSv4.1 is correctly read using NFSv4
218
219   test09
220       Verify appending data with NFSv4.1 is correctly read using NFSv4.1
221
222   test10
223       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv3
224
225   test11
226       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv4
227
228   test12
229       Verify appending data with NFSv3 and NFSv4 is correctly read using NFSv4.1
230
231   test13
232       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv3
233
234   test14
235       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv4
236
237   test15
238       Verify appending data with NFSv4 and NFSv3 is correctly read using NFSv4.1
239
240   test16
241       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv3
242
243   test17
244       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv4
245
246   test18
247       Verify appending data with NFSv3 and NFSv4.1 is correctly read using NFSv4.1
248
249   test19
250       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv3
251
252   test20
253       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv4
254
255   test21
256       Verify appending data with NFSv4.1 and NFSv3 is correctly read using NFSv4.1
257
258   test22
259       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv3
260
261   test23
262       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv4
263
264   test24
265       Verify appending data with NFSv4 and NFSv4.1 is correctly read using NFSv4.1
266
267   test25
268       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv3
269
270   test26
271       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv4
272
273   test27
274       Verify appending data with NFSv4.1 and NFSv4 is correctly read using NFSv4.1
275
276   test28
277       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv3
278
279   test29
280       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv4
281
282   test30
283       Verify appending data with NFSv3, NFSv4 and NFSv4.1 is correctly read using NFSv4.1
284
285   test31
286       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv3
287
288   test32
289       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv4
290
291   test33
292       Verify appending data with NFSv4, NFSv3 and NFSv4.1 is correctly read using NFSv4.1
293
294   test34
295       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv3
296
297   test35
298       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv4
299
300   test36
301       Verify appending data with NFSv4, NFSv4.1 and NFSv3 is correctly read using NFSv4.1
302
303   test37
304       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv3
305
306   test38
307       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv4
308
309   test39
310       Verify appending data with NFSv4.1, NFSv4 and NFSv3 is correctly read using NFSv4.1
311
312   test40
313       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv3
314
315   test41
316       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv4
317
318   test42
319       Verify appending data with NFSv4.1, NFSv3 and NFSv4 is correctly read using NFSv4.1
320
321   test43
322       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv3
323
324   test44
325       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv4
326
327   test45
328       Verify appending data with NFSv3, NFSv4.1 and NFSv4 is correctly read using NFSv4.1
329

SEE ALSO

331       nfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_dele‐
332       gation(1),     nfstest_dio(1),     nfstest_file(1),      nfstest_io(1),
333       nfstest_lock(1),   nfstest_pkt(1),  nfstest_pnfs(1),  nfstest_posix(1),
334       nfstest_sparse(1), nfstest_ssc(1), nfstest_xid(1)
335
336

BUGS

338       No known bugs.
339

AUTHOR

341       Jorge Mora (mora@netapp.com)
342
343
344
345NFStest 2.1.5                  14 February 2017             NFSTEST_INTEROP(1)
Impressum