NFSTEST_CACHE(1) nfstest_cache 1.0.1 NFSTEST_CACHE(1)NAME
nfstest_cache - NFS client side caching tests
SYNOPSIS
nfstest_cache --server <server> --client <client> [options]
DESCRIPTION
Verify consistency of attribute caching by varying acregmin, acregmax,
acdirmin, acdirmax and actimo. Verify consistency of data caching by
varying acregmin, acregmax, acdirmin, acdirmax and actimo.
Valid for any version of NFS.
OPTIONS--version
show program's version number and exit
-h, --help
show this help message and exit
-f FILE, --file=FILE
Options file
-s SERVER, --server=SERVER
Server name or IP address
-p PORT, --port=PORT
NFS server port [default: 2049]
--nfsversion=NFSVERSION
NFS version [default: 4]
--minorversion=MINORVERSION
Minor version [default: 1]
-e EXPORT, --export=EXPORT
Exported file system to mount [default: '/']
-m MTPOINT, --mtpoint=MTPOINT
Mount point [default: '/mnt/t']
--datadir=DATADIR
Data directory where files are created [default: '']
-o MTOPTS, --mtopts=MTOPTS
Mount options [default: 'hard,rsize=4096,wsize=4096']
-i INTERFACE, --interface=INTERFACE
Device interface [default: 'eth0']
-v VERBOSE, --verbose=VERBOSE
Verbose level [default: 'none']
--nocleanup
Do not cleanup
--rmtraces
Remove trace files [default: remove trace files if no errors]
--keeptraces
Do not remove any trace files [default: remove trace files if no
errors]
--createlog
Create log file
--bugmsgs=BUGMSGS
File containing test messages to mark as bugs if they failed
--ignore
Ignore all bugs given by bugmsgs
--nomount
Do not mount server
--basename=BASENAME
Base name for all files and logs [default: automatically gener‐
ated]
--tverbose=TVERBOSE
Verbose level for test messages [default: '1']
--filesize=FILESIZE
File size to use for test files [default: 32]
--nfiles=NFILES
Number of files to create [default: 2]
--rsize=RSIZE
Read size to use when reading files [default: 4096]
--wsize=WSIZE
Write size to use when writing files [default: 4096]
--iodelay=IODELAY
Seconds to delay I/O operations [default: 0.1]
--offset-delta=OFFSET_DELTA
Read/Write offset delta [default: 4096]
--warnings
Display warnings
--nfsdebug=NFSDEBUG
Set NFS kernel debug flags and save log messages [default: '']
--rpcdebug=RPCDEBUG
Set RPC kernel debug flags and save log messages [default: '']
--sudo=SUDO
Full path of binary for sudo [default: '/usr/bin/sudo']
--tcpdump=TCPDUMP
Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
--iptables=IPTABLES
Full path of binary for iptables [default: '/sbin/iptables']
--messages=MESSAGES
Full path of log messages file [default: '/var/log/messages']
--tmpdir=TMPDIR
Temporary directory [default: '/tmp']
--runtest=RUNTEST
Comma separated list of tests to run [default: 'all']
--client=CLIENT
Remote NFS client that mounts server used for multiple client
tests
--client-port=CLIENT_PORT
NFS server port for client to mount [default: value given in
'port' option]
--justbefore=JUSTBEFORE
Time in seconds to test a condition just before it is expected
to come true [default: 2]
--acmin=ACMIN
Comma separated values to use for acregmin/acdirmin/actimeo
[default: 10]
--acmax=ACMAX
Comma separated values to use for acregmax/acdirmax, first value
of acmin will be used as acregmin/acdirmin [default: 20]
TESTS
acregmin_attr
Verify consistency of attribute caching by varying the acregmin NFS
option.
The cached information is assumed to be valid for attrtimeo which
starts at acregmin.
acregmax_attr
Verify consistency of attribute caching by varying the acregmax NFS
option.
The cached information is assumed to be valid for attrtimeo which
starts at acregmin. An attribute revalidation to the server that shows
no attribute change doubles attrtimeo up to acregmax. An attribute
revalidation to the server that shows a change has occurred resets it
to acregmin.
acdirmin_attr
Verify consistency of attribute caching by varying the acdirmin NFS
option.
The cached information is assumed to be valid for attrtimeo which
starts at acdirmin. Test that this is so.
acdirmax_attr
Verify consistency of attribute caching by varying the acdirmax NFS
option.
The cached information is assumed to be valid for attrtimeo which
starts at acdirmin. An attribute revalidation to the server that shows
no attribute change doubles attrtimeo up to acdirmax. An attribute
revalidation to the server that shows a change has occurred resets it
to acdirmin.
actimeo_attr
Verify consistency of attribute caching by varying the actimeo NFS
option.
The cached information is assumed to be valid for attrtimeo which
starts and ends at actimeo.
acregmin_data
Verify consistency of data caching by varying the acregmin NFS option.
acregmax_data
Verify consistency of data caching by varying the acregmax NFS option.
The cached information is assumed to be valid for attrtimeo which
starts at acregmin. An attribute revalidation to the server that shows
no attribute change doubles attrtimeo up to acregmax. An attribute
revalidation to the server that shows a change has occurred resets it
to acregmin.
acdirmin_data
Verify consistency of data caching by varying the acdirmin NFS option.
The cached information is assumed to be valid for attrtimeo which
starts at acdirmin. Test that this is so.
acdirmax_data
Verify consistency of data caching by varying the acdirmax NFS option.
The cached information is assumed to be valid for attrtimeo which
starts at acdirmin. An attribute revalidation to the server that shows
no attribute change doubles attrtimeo up to acdirmax. An attribute
revalidation to the server that shows a change has occurred resets it
to acdirmin.
actimeo_data
Verify consistency of data caching by varying the actimeo NFS option.
The cached information is assumed to be valid for attrtimeo which
starts and ends at actimeo.
EXAMPLES
Required options are --server and --client
$ nfstest_cache --server 192.168.0.11 --client 192.168.0.20
Testing with different values of --acmin and --acmax (this takes a long
time)
$ nfstest_cache --server 192.168.0.11 --client 192.168.0.20 --acmin
10,20 --acmax 20,30,60,80
NOTES
The user id in the local host and the host specified by --client must
have access to run commands as root using the 'sudo' command without
the need for a password.
The user id must be able to 'ssh' to remote host without the need for a
password.
SEE ALSOnfstest.test_util(1), nfstest_delegation(1), nfstest_dio(1),
nfstest_pnfs(1), nfstest_posix(1)BUGS
No known bugs.
AUTHOR
Jorge Mora (mora@netapp.com)
NFStest 1.0.2 10 April 2013 NFSTEST_CACHE(1)