1NFSTEST_CACHE(1) nfstest_cache 1.0.1 NFSTEST_CACHE(1)
2
3
4
6 nfstest_cache - NFS client side caching tests
7
9 nfstest_cache --server <server> --client <client> [options]
10
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
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
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
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
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
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
297 No known bugs.
298
300 Jorge Mora (mora@netapp.com)
301
302
303
304NFStest 2.1.5 14 February 2017 NFSTEST_CACHE(1)