1NFSTEST_CACHE(1)              nfstest_cache 1.0.1             NFSTEST_CACHE(1)
2
3
4

NAME

6       nfstest_cache - NFS client side caching tests
7

SYNOPSIS

9       nfstest_cache --server <server> --client <client> [options]
10

DESCRIPTION

12       Verify  consistency of attribute caching by varying acregmin, acregmax,
13       acdirmin, acdirmax and actimo. Verify consistency of  data  caching  by
14       varying acregmin, acregmax, acdirmin, acdirmax and actimo.
15
16       Valid for any version of NFS.
17
18
19

OPTIONS

21       --version
22              show program's version number and exit
23
24       -h, --help
25              show this help message and exit
26
27       -f FILE, --file=FILE
28              File  where  options  are specified besides the system wide file
29              /etc/nfstest, user wide file $HOME/.nfstest or  in  the  current
30              directory .nfstest file
31
32
33   NFS specific options:
34       -s SERVER, --server=SERVER
35              Server name or IP address
36
37       -e EXPORT, --export=EXPORT
38              Exported file system to mount [default: '/']
39
40       --nfsversion=NFSVERSION
41              NFS version, e.g., 3, 4, 4.1, etc. [default: 4.1]
42
43       -m MTPOINT, --mtpoint=MTPOINT
44              Mount point [default: '/mnt/t']
45
46       -p PORT, --port=PORT
47              NFS server port [default: 2049]
48
49       --proto=PROTO
50              NFS protocol name [default: 'tcp']
51
52       --sec=SEC
53              Security flavor [default: 'sys']
54
55       -o MTOPTS, --mtopts=MTOPTS
56              Mount options [default: 'hard,rsize=4096,wsize=4096']
57
58       --datadir=DATADIR
59              Data  directory where files are created, directory is created on
60              the mount point [default: '']
61
62
63   Logging options:
64       -v VERBOSE, --verbose=VERBOSE
65              Verbose level for debug messages [default: 'none']
66
67       --tverbose=TVERBOSE
68              Verbose level for test messages [default: '1']
69
70       --createlog
71              Create log file
72
73       --rexeclog
74              Create rexec log files
75
76       --warnings
77              Display warnings
78
79       --tag=TAG
80              Informational tag, it is displayed as an INFO message  [default:
81              '']
82
83       --notty
84              Do not use terminal colors on output
85
86
87   Packet trace options:
88       --createtraces
89              Create a packet trace for each test
90
91       --tbsize=TBSIZE
92              Capture buffer size for tcpdump [default: 192k]
93
94       --trcdelay=TRCDELAY
95              Seconds to delay before stopping packet trace [default: 0.0]
96
97       --keeptraces
98              Do not remove any trace files [default: remove trace files if no
99              errors]
100
101       --rmtraces
102              Remove trace files [default: remove trace files if no errors]
103
104       -i INTERFACE, --interface=INTERFACE
105              Device interface [default: automatically selected]
106
107
108   File options:
109       --nfiles=NFILES
110              Number of files to create [default: 2]
111
112       --filesize=FILESIZE
113              File size to use for test files [default: 32]
114
115       --rsize=RSIZE
116              Read size to use when reading files [default: 4k]
117
118       --wsize=WSIZE
119              Write size to use when writing files [default: 4k]
120
121       --iodelay=IODELAY
122              Seconds to delay I/O operations [default: 0.1]
123
124       --offset-delta=OFFSET_DELTA
125              Read/Write offset delta [default: 4k]
126
127
128   Path options:
129       --sudo=SUDO
130              Full path of binary for sudo [default: '/usr/bin/sudo']
131
132       --tcpdump=TCPDUMP
133              Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
134
135       --iptables=IPTABLES
136              Full path of binary for iptables [default: '/usr/sbin/iptables']
137
138       --messages=MESSAGES
139              Full path of log messages file [default: '/var/log/messages']
140
141       --tmpdir=TMPDIR
142              Temporary directory [default: '/tmp']
143
144
145   Debug options:
146       --nocleanup
147              Do not cleanup created files
148
149       --bugmsgs=BUGMSGS
150              File containing test messages to mark as bugs if they failed
151
152       --ignore
153              Ignore all bugs given by bugmsgs
154
155       --nomount
156              Do not mount server and run the tests on local disk space
157
158       --basename=BASENAME
159              Base name for all files and logs [default: automatically  gener‐
160              ated]
161
162       --nfsdebug=NFSDEBUG
163              Set NFS kernel debug flags and save log messages [default: '']
164
165       --rpcdebug=RPCDEBUG
166              Set RPC kernel debug flags and save log messages [default: '']
167
168       --pktdisp
169              Display main packets related to the given test
170
171
172   Test options:
173       --runtest=RUNTEST
174              Comma  separated list of tests to run, if list starts with a '^'
175              then all tests are run except the ones listed [default: 'all']
176
177       --client=CLIENT
178              Remote NFS client
179
180       --justbefore=JUSTBEFORE
181              Time in seconds to test a condition just before it  is  expected
182              to come true [default: 2]
183
184       --acmin=ACMIN
185              Comma  separated  values  to  use  for acregmin/acdirmin/actimeo
186              [default: 10]
187
188       --acmax=ACMAX
189              Comma separated values to use for acregmax/acdirmax, first value
190              of acmin will be used as acregmin/acdirmin [default: 20]
191

TESTS

193   acregmin_attr
194       Verify consistency of attribute caching by varying the
195       acregmin NFS option.
196
197       The cached information is assumed to be valid for attrtimeo
198       which starts at acregmin.
199
200   acregmax_attr
201       Verify consistency of attribute caching by varying the
202       acregmax NFS option.
203
204       The cached information is assumed to be valid for attrtimeo which
205       starts at acregmin. An attribute revalidation to the server
206       that shows no attribute change doubles attrtimeo up to acregmax.
207       An attribute revalidation to the server that shows a change has
208       occurred resets it to acregmin.
209
210   acdirmin_attr
211       Verify consistency of attribute caching by varying the
212       acdirmin NFS option.
213
214       The cached information is assumed to be valid for attrtimeo
215       which starts at acdirmin. Test that this is so.
216
217   acdirmax_attr
218       Verify consistency of attribute caching by varying the
219       acdirmax NFS option.
220
221       The cached information is assumed to be valid for attrtimeo which
222       starts at acdirmin. An attribute revalidation to the server
223       that shows no attribute change doubles attrtimeo up to acdirmax.
224       An attribute revalidation to the server that shows a change has
225       occurred resets it to acdirmin.
226
227   actimeo_attr
228       Verify consistency of attribute caching by varying the
229       actimeo NFS option.
230
231       The cached information is assumed to be valid for attrtimeo
232       which starts and ends at actimeo.
233
234   acregmin_data
235       Verify consistency of data caching by varying the
236       acregmin NFS option.
237
238   acregmax_data
239       Verify consistency of data caching by varying the
240       acregmax NFS option.
241
242       The cached information is assumed to be valid for attrtimeo which
243       starts at acregmin. An attribute revalidation to the server
244       that shows no attribute change doubles attrtimeo up to acregmax.
245       An attribute revalidation to the server that shows a change has
246       occurred resets it to acregmin.
247
248   acdirmin_data
249       Verify consistency of data caching by varying the
250       acdirmin NFS option.
251
252       The cached information is assumed to be valid for attrtimeo
253       which starts at acdirmin. Test that this is so.
254
255   acdirmax_data
256       Verify consistency of data caching by varying the
257       acdirmax NFS option.
258
259       The cached information is assumed to be valid for attrtimeo which
260       starts at acdirmin. An attribute revalidation to the server
261       that shows no attribute change doubles attrtimeo up to acdirmax.
262       An attribute revalidation to the server that shows a change has
263       occurred resets it to acdirmin.
264
265   actimeo_data
266       Verify consistency of data caching by varying the
267       actimeo NFS option.
268
269       The cached information is assumed to be valid for attrtimeo
270       which starts and ends at actimeo.
271

EXAMPLES

273       Required options are --server and --client
274       $ nfstest_cache --server 192.168.0.11 --client 192.168.0.20
275
276       Testing with different values of --acmin and --acmax (this takes a long
277       time)
278       $ nfstest_cache --server  192.168.0.11  --client  192.168.0.20  --acmin
279       10,20 --acmax 20,30,60,80
280

NOTES

282       The  user  id in the local host and the host specified by --client must
283       have access to run commands as root using the  'sudo'  command  without
284       the need for a password.
285
286       The user id must be able to 'ssh' to remote host without the need for a
287       password.
288

SEE ALSO

290       nfstest.test_util(3),     nfstest_alloc(1),      nfstest_delegation(1),
291       nfstest_dio(1),   nfstest_file(1),  nfstest_interop(1),  nfstest_io(1),
292       nfstest_lock(1),  nfstest_pkt(1),  nfstest_pnfs(1),   nfstest_posix(1),
293       nfstest_sparse(1), nfstest_ssc(1), nfstest_xid(1)
294
295

BUGS

297       No known bugs.
298

AUTHOR

300       Jorge Mora (mora@netapp.com)
301
302
303
304NFStest 2.1.5                  14 February 2017               NFSTEST_CACHE(1)
Impressum