nfstest_fcmp - Man Page
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)
Referenced By
nfstest(1), 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).