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 generated]

       --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 ALSO

       nfstest.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)