Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for nfstest_delegation (centos section 1)

NFSTEST_DELEGATION(1)					     nfstest_delegation 1.0.1					     NFSTEST_DELEGATION(1)

NAME
nfstest_delegation - Delegation tests
SYNOPSIS
nfstest_delegation --server <server> [--client <client>] [options]
DESCRIPTION
Basic delegation tests verify that a correct delegation is granted when opening a file for reading or writing. Also, another OPEN should not be sent for the same file when the client is holding a delegation. Verify that the stateid of all I/O operations should be the delega- tion stateid. Reads from a different process on the same file should not cause the client to send additional READ packets when the client is holding a read delegation. Furthermore, a LOCK packet should not be sent to the server when the client is holding a delegation. Recall delegation tests verify the delegation is recalled when a conflicting operation is sent to the server from a different client. Con- flicting operations are reading, writing and changing the permissions on the same file. Note, that reading a file from a different client can only recall a read delegation. Also, verify that a delegation is not recalled when a different client is granted a read delegation. After a delegation is recalled, the client should send an OPEN with CLAIM_DELEGATE_CUR before returning the delegation and the stateid should be the same as the original OPEN stateid. Also, a delegation should not be granted when re-opening the file right before returning the delegation. Verify client flushes all written data before returning the WRITE delegation. The LOCK should be sent as well right before returning a delegation which has been recalled. A delegation should not be granted on the second client who cause the delegation recall on the first client.
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'] --client=CLIENT Remote NFS client that mounts server used for multiple client tests --lock-offset=LOCK_OFFSET Starting offset for lock [default: 0] --lock-len=LOCK_LEN Number of bytes to lock [default: 0]
TESTS
read Basic read delegation test write Basic write delegation test read_lock Basic read delegation test with file lock write_lock Basic write delegation test with file lock read_recall_write Recall read delegation by writing from a second client write_recall_write Recall write delegation by writing from a second client read_recall_write_lock Recall read delegation by writing from a second client with file lock write_recall_write_lock Recall write delegation by writing from a second client with file lock write_recall_read Recall write delegation by reading from a second client write_recall_read_lock Recall write delegation by reading from a second client with file lock read_recall_setattr Recall read delegation by changing the permissions to the file write_recall_setattr Recall write delegation by changing the permissions to the file read_recall_setattr_lock Recall read delegation by changing the permissions to the file with file lock write_recall_setattr_lock Recall write delegation by changing the permissions to the file with file lock
EXAMPLES
The only required option is --server but only the basic delegation tests will be run. Use the --client option to run the recall tests as well $ nfstest_delegation --server 192.168.0.11 --client 192.168.0.20
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_cache(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_DELEGATION(1)