- experimental 3.2-1
NFSTEST_FCMP(1) | nfstest_fcmp 1.0 | NFSTEST_FCMP(1) |
NAME¶
nfstest_fcmp - NFS file compare
SYNOPSIS¶
nfstest_fcmp --server <server> [options]
DESCRIPTION¶
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.
SEE ALSO¶
nfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_delegation(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_rdma(1), nfstest_sparse(1), nfstest_ssc(1), nfstest_xattr(1), nfstest_xid(1)
BUGS¶
No known bugs.
AUTHOR¶
Jorge Mora (mora@netapp.com)
21 March 2023 | NFStest 3.2 |