NFSTEST_PNFS(1) 						nfstest_pnfs 1.0.1						   NFSTEST_PNFS(1)

NAME

       nfstest_pnfs - Basic pNFS functional tests

SYNOPSIS

       nfstest_pnfs --server <server> [options]

DESCRIPTION

       Verify  basic pNFS functionality for file (both READ and WRITE), including opening a second file within the same mount and having a lock on
       the file.  Also, verify basic pNFS functionality for a file opened for both READ and WRITE while reading the file first and then writing to
       it  or  the  other  way	around	by writing to the file fist and then reading the file. These tests verify proper functionality of pNFS and
       NFSv4.1 as well.

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: 65536]

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

TESTS

   read
       Verify basic pNFS functionality on a couple of files opened for reading within the same mount.

   write
       Verify basic pNFS functionality on a couple of files opened for writing and then re-opening the first file  for	writing  within  the  same
       mount.

   write_read
       Verify  basic  pNFS  functionality  on  a couple of files opened for writing and then re-opening the first file for reading within the same
       mount.

   read_lock
       Verify traffic for locked file opened for reading using pNFS.

   write_lock
       Verify traffic for locked file opened for writing using pNFS.

   setattr
       Verify setattr traffic for file using pNFS.

   setattr_lock
       Verify setattr traffic for locked file using pNFS.

   rw_read
       Verify traffic for file opened for read and write: reading file first.

   rw_write
       Verify traffic for file opened for read and write: writing file first.

   one_ds
       Verify client only connects to the DS with I/O.

   rsize
       Verify traffic for file using pNFS when mount option rsize < 4096.

   wsize
       Verify traffic for file using pNFS when mount option wsize < 4096.

   rwsize
       Verify traffic for file using pNFS when mount option rsize < 4096 and wsize < 4096.

   nfsvers
       Verify file created with pNFS is read correctly from different versions of NFS. Also, verify files created with different versions  of  NFS
       are read correctly from pNFS

EXAMPLES

       The only required option is --server
       $ nfstest_pnfs --server 192.168.0.11

NOTES

       The user id in the local host must have access to run commands as root using the 'sudo' command without the need for a password.

SEE ALSO

       nfstest.test_util(1), nfstest_cache(1), nfstest_delegation(1), nfstest_dio(1), nfstest_posix(1)

BUGS

       No known bugs.

AUTHOR

       Jorge Mora (mora@netapp.com)

NFStest 1.0.2							   10 April 2013						   NFSTEST_PNFS(1)