nfstest_fcmp - NFS file compare

       Jorge Mora (mora@netapp.com)

NFStest 3.2                                       21 March 2023                                  NFSTEST_FCMP(1)

       No known bugs.

       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.

       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

       nfstest_fcmp - NFS file compare

       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.

       --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

   NFSspecificoptions:
       -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: '']

   Loggingoptions:
       -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

   Packettraceoptions:
       --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]

   Fileoptions:
       --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]

   Pathoptions:
       --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']

   Debugoptions:
       --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

   Reportingoptions:
       --xunit-report
              Generate xUnit compatible test report

       --xunit-report-file=XUNIT_REPORT_FILE
              Path to xout report file

   Testoptions:
       --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']

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)

       nfstest_fcmp --server <server> [options]

test01
       Verify data read from file is correct

   test02
       Verify data written to file is correct

   all
       Run all tests: test01, test02