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)