nfstest_fcmp1
Nfs file compare
Usage
nfstest_fcmp --server
<server>
[options]
Overview
Create a file using one set of NFS mount options and then verify the data is correct by reading the file using another set of NFS mount options.
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']
-
--nconnect=NCONNECT -
Multiple TCP connections option [default: '1']
-
-o MTOPTS, --mtopts=MTOPTS -
Mount options [default: 'hard']
-
--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: 'opts|info|dbg1|dbg2|dbg3']
-
--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
-
--isatty -
Use terminal colors on output -- useful when running with nohup
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: 2.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: 0]
-
--filesize=FILESIZE -
File size to use for test files [default: 1m]
-
--rsize=RSIZE -
Read size to use when reading files [default: 64k]
-
--wsize=WSIZE -
Write size to use when writing files [default: 64k]
-
--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']
-
--kill=KILL -
Full path of binary for kill [default: '/usr/bin/kill']
-
--nfsstat=NFSSTAT -
Full path of binary for nfsstat [default: '/usr/sbin/nfsstat']
-
--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']
-
--trcevents=TRCEVENTS -
Full path of tracing events directory [default: '/sys/kernel/debug/tracing/events']
-
--trcpipe=TRCPIPE -
Full path of trace pipe file [default: '/sys/kernel/debug/tracing/trace_pipe']
-
--tmpdir=TMPDIR -
Temporary directory [default: '/tmp']
Debug options:
-
--nocleanup -
Do not cleanup created files
-
--notimestamps -
Do not display timestamps in debug messages
-
--bugmsgs=BUGMSGS -
File containing test messages to mark as bugs if they failed
-
--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: '']
-
--tracepoints=TRACEPOINTS -
List of trace points modules to enable [default: '']
-
--nfsstats -
Get NFS stats [default: 'False']
-
--pktdisp -
Display main packets related to the given test
-
--nfserrors -
Fail every NFS error found in the packet trace
-
--client-ipaddr=CLIENT_IPADDR -
IP address of localhost
Reporting options:
-
--xunit-report -
Generate xUnit compatible test report
-
--xunit-report-file=XUNIT_REPORT_FILE -
Path to xout report file
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']
-
--nfsopts=NFSOPTS -
NFS options used for comparing test file. NFS mount definition is a list of arguments separated by a ':' given in the following order if positional arguments are used (see examples): ::export:nfsversion:port:proto:sec
-
--cmpopts=CMPOPTS -
NFS mount options used for comparing test file other than the ones specified in --nfsopts [default: 'hard']
Tests
test01
Verify data read from file is correct
test02
Verify data written to file is correct
all
Run all tests: test01, test02
Examples
Use positional arguments with nfsversion=3 for second mount:
nfstest_fcmp -s 192.168.0.2 -e /exports --nfsopts :::3
Use named arguments instead:
nfstest_fcmp -s 192.168.0.2 -e /exports --nfsopts nfsversion=3
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.