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)