NFSTEST_DELEGATION - Online Linux Manual PageSection : 1
Updated : 14 February 2017
Source : NFStest 2.1.5
Note : nfstest_delegation 1.6
NAMEnfstest_delegation - Delegation tests
SYNOPSISnfstest_delegation --server <server> [--client <client>] [options]
DESCRIPTIONBasic 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 delegation 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. Conflicting 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 File where options are specified besides the system wide file /etc/nfstest, user wide file $HOME/.nfstest or in the current directory .nfstest file
NFS specific options:-s SERVER, --server=SERVER Server name or IP address -e EXPORT, --export=EXPORT Exported file system to mount [default: '/'] --nfsversion=NFSVERSION NFS version, e.g., 3, 4, 4.1, etc. [default: 4.1] -m MTPOINT, --mtpoint=MTPOINT Mount point [default: '/mnt/t'] -p PORT, --port=PORT NFS server port [default: 2049] --proto=PROTO NFS protocol name [default: 'tcp'] --sec=SEC Security flavor [default: 'sys'] -o MTOPTS, --mtopts=MTOPTS Mount options [default: 'hard,rsize=4096,wsize=4096'] --datadir=DATADIR Data directory where files are created, directory is created on the mount point [default: '']
Logging options:-v VERBOSE, --verbose=VERBOSE Verbose level for debug messages [default: 'none'] --tverbose=TVERBOSE Verbose level for test messages [default: '1'] --createlog Create log file --rexeclog Create rexec log files --warnings Display warnings --tag=TAG Informational tag, it is displayed as an INFO message [default: ''] --notty Do not use terminal colors on output
Packet trace options:--createtraces Create a packet trace for each test --tbsize=TBSIZE Capture buffer size for tcpdump [default: 192k] --trcdelay=TRCDELAY Seconds to delay before stopping packet trace [default: 0.0] --keeptraces Do not remove any trace files [default: remove trace files if no errors] --rmtraces Remove trace files [default: remove trace files if no errors] -i INTERFACE, --interface=INTERFACE Device interface [default: automatically selected]
File options:--nfiles=NFILES Number of files to create [default: 2] --filesize=FILESIZE File size to use for test files [default: 64k] --rsize=RSIZE Read size to use when reading files [default: 4k] --wsize=WSIZE Write size to use when writing files [default: 4k] --iodelay=IODELAY Seconds to delay I/O operations [default: 0.1] --offset-delta=OFFSET_DELTA Read/Write offset delta [default: 4k]
Path options:--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: '/usr/sbin/iptables'] --messages=MESSAGES Full path of log messages file [default: '/var/log/messages'] --tmpdir=TMPDIR Temporary directory [default: '/tmp']
Debug options:--nocleanup Do not cleanup created files --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 and run the tests on local disk space --basename=BASENAME Base name for all files and logs [default: automatically generated] --nfsdebug=NFSDEBUG Set NFS kernel debug flags and save log messages [default: ''] --rpcdebug=RPCDEBUG Set RPC kernel debug flags and save log messages [default: ''] --pktdisp Display main packets related to the given test
Test options:--runtest=RUNTEST Comma separated list of tests to run, if list starts with a '^' then all tests are run except the ones listed [default: 'all'] --client=CLIENT Remote NFS client used for recall tests --lock-offset=LOCK_OFFSET Starting offset for lock [default: 0] --lock-len=LOCK_LEN Number of bytes to lock [default: 0] --truncate Truncate file when writing from the second file for the recall tests
TESTS
basicRun all basic delegation tests: basic01, basic02, basic03, basic04, basic05, basic06
basic01Basic read delegation test
basic02Basic write delegation test
basic03Basic read delegation test with file stat
basic04Basic write delegation test with file stat
basic05Basic read delegation test with file lock
basic06Basic write delegation test with file lock
recallRun all recall delegation tests: recall01, recall02, recall03, recall04, recall05, recall06, recall07, recall08, recall09, recall10
recall01Recall read delegation by writing from a second client
recall02Recall write delegation by writing from a second client
recall03Recall read delegation by writing from a second client with file lock
recall04Recall write delegation by writing from a second client with file lock
recall05Recall write delegation by reading from a second client
recall06Recall write delegation by reading from a second client with file lock
recall07Recall read delegation by changing the permissions to the file
recall08Recall write delegation by changing the permissions to the file
recall09Recall read delegation by changing the permissions to the file with file lock
recall10Recall write delegation by changing the permissions to the file with file lock
EXAMPLESThe 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
NOTESThe 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 ALSOnfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_dio(1), nfstest_file(1), nfstest_interop(1), nfstest_io(1), nfstest_lock(1), nfstest_pkt(1), nfstest_pnfs(1), nfstest_posix(1), nfstest_sparse(1), nfstest_ssc(1), nfstest_xid(1), packet.nfs.nfs4_const(3)
BUGSNo known bugs.
AUTHORJorge Mora (mora@netapp.com) 0
Johanes Gumabo
Data Size   :   30,819 byte
man-nfstest_delegation.1Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 174,407
Visitor ID   :     :  
Visitor IP   :   3.133.153.232   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.