1NFSTEST_PNFS(1)                nfstest_pnfs 1.4                NFSTEST_PNFS(1)
2
3
4

NAME

6       nfstest_pnfs - Basic pNFS functional tests
7

SYNOPSIS

9       nfstest_pnfs --server <server> [options]
10

DESCRIPTION

12       Verify basic pNFS functionality for file (both READ and WRITE), includ‐
13       ing opening a second file within the same mount and having  a  lock  on
14       the  file.  Also, verify basic pNFS functionality for a file opened for
15       both READ and WRITE while reading the file first and then writing to it
16       or  the  other  way around by writing to the file fist and then reading
17       the file. These tests verify proper functionality of pNFS  and  NFSv4.1
18       as well.
19
20
21

OPTIONS

23       --version
24              show program's version number and exit
25
26       -h, --help
27              show this help message and exit
28
29       -f FILE, --file=FILE
30              File  where  options  are specified besides the system wide file
31              /etc/nfstest, user wide file $HOME/.nfstest or  in  the  current
32              directory .nfstest file
33
34
35   NFS specific options:
36       -s SERVER, --server=SERVER
37              Server name or IP address
38
39       -e EXPORT, --export=EXPORT
40              Exported file system to mount [default: '/']
41
42       --nfsversion=NFSVERSION
43              NFS version, e.g., 3, 4, 4.1, etc. [default: 4.1]
44
45       -m MTPOINT, --mtpoint=MTPOINT
46              Mount point [default: '/mnt/t']
47
48       -p PORT, --port=PORT
49              NFS server port [default: 2049]
50
51       --proto=PROTO
52              NFS protocol name [default: 'tcp']
53
54       --sec=SEC
55              Security flavor [default: 'sys']
56
57       -o MTOPTS, --mtopts=MTOPTS
58              Mount options [default: 'hard,rsize=4096,wsize=4096']
59
60       --datadir=DATADIR
61              Data  directory where files are created, directory is created on
62              the mount point [default: '']
63
64
65   Logging options:
66       -v VERBOSE, --verbose=VERBOSE
67              Verbose level for debug messages [default: 'none']
68
69       --tverbose=TVERBOSE
70              Verbose level for test messages [default: '1']
71
72       --createlog
73              Create log file
74
75       --rexeclog
76              Create rexec log files
77
78       --warnings
79              Display warnings
80
81       --tag=TAG
82              Informational tag, it is displayed as an INFO message  [default:
83              '']
84
85       --notty
86              Do not use terminal colors on output
87
88
89   Packet trace options:
90       --createtraces
91              Create a packet trace for each test
92
93       --tbsize=TBSIZE
94              Capture buffer size for tcpdump [default: 192k]
95
96       --trcdelay=TRCDELAY
97              Seconds to delay before stopping packet trace [default: 0.0]
98
99       --keeptraces
100              Do not remove any trace files [default: remove trace files if no
101              errors]
102
103       --rmtraces
104              Remove trace files [default: remove trace files if no errors]
105
106       -i INTERFACE, --interface=INTERFACE
107              Device interface [default: automatically selected]
108
109
110   File options:
111       --nfiles=NFILES
112              Number of files to create [default: 2]
113
114       --filesize=FILESIZE
115              File size to use for test files [default: 64k]
116
117       --rsize=RSIZE
118              Read size to use when reading files [default: 4k]
119
120       --wsize=WSIZE
121              Write size to use when writing files [default: 4k]
122
123       --iodelay=IODELAY
124              Seconds to delay I/O operations [default: 0.1]
125
126       --offset-delta=OFFSET_DELTA
127              Read/Write offset delta [default: 4k]
128
129
130   Path options:
131       --sudo=SUDO
132              Full path of binary for sudo [default: '/usr/bin/sudo']
133
134       --tcpdump=TCPDUMP
135              Full path of binary for tcpdump [default: '/usr/sbin/tcpdump']
136
137       --iptables=IPTABLES
138              Full path of binary for iptables [default: '/usr/sbin/iptables']
139
140       --messages=MESSAGES
141              Full path of log messages file [default: '/var/log/messages']
142
143       --tmpdir=TMPDIR
144              Temporary directory [default: '/tmp']
145
146
147   Debug options:
148       --nocleanup
149              Do not cleanup created files
150
151       --bugmsgs=BUGMSGS
152              File containing test messages to mark as bugs if they failed
153
154       --ignore
155              Ignore all bugs given by bugmsgs
156
157       --nomount
158              Do not mount server and run the tests on local disk space
159
160       --basename=BASENAME
161              Base name for all files and logs [default: automatically  gener‐
162              ated]
163
164       --nfsdebug=NFSDEBUG
165              Set NFS kernel debug flags and save log messages [default: '']
166
167       --rpcdebug=RPCDEBUG
168              Set RPC kernel debug flags and save log messages [default: '']
169
170       --pktdisp
171              Display main packets related to the given test
172
173
174   Test options:
175       --runtest=RUNTEST
176              Comma  separated list of tests to run, if list starts with a '^'
177              then all tests are run except the ones listed [default: 'all']
178

TESTS

180   read
181       Verify basic pNFS functionality on a couple of files opened for
182       reading within the same mount.
183
184   write
185       Verify basic pNFS functionality on a couple of files opened for
186       writing and then re-opening the first file for writing within
187       the same mount.
188
189   write_read
190       Verify basic pNFS functionality on a couple of files opened for
191       writing and then re-opening the first file for reading within
192       the same mount.
193
194   read_lock
195       Verify traffic for locked file opened for reading using pNFS.
196
197   write_lock
198       Verify traffic for locked file opened for writing using pNFS.
199
200   setattr
201       Verify setattr traffic for file using pNFS.
202
203   setattr_lock
204       Verify setattr traffic for locked file using pNFS.
205
206   rw_read
207       Verify traffic for file opened for read and write: reading file first.
208
209   rw_write
210       Verify traffic for file opened for read and write: writing file first.
211
212   one_ds
213       Verify client only connects to the DS with I/O.
214
215   rsize
216       Verify traffic for file using pNFS when mount option rsize < 4096.
217
218   wsize
219       Verify traffic for file using pNFS when mount option wsize < 4096.
220
221   rwsize
222       Verify traffic for file using pNFS when mount option rsize < 4096 and wsize < 4096.
223
224   nfsvers
225       Verify file created with pNFS is read correctly from different versions
226       of NFS. Also, verify files created with different versions of NFS are
227       read correctly from pNFS
228

EXAMPLES

230       The only required option is --server
231       $ nfstest_pnfs --server 192.168.0.11
232

NOTES

234       The user id in the local host must have access to run commands as  root
235       using the 'sudo' command without the need for a password.
236

SEE ALSO

238       nfstest.test_util(3), nfstest_alloc(1), nfstest_cache(1), nfstest_dele‐
239       gation(1),   nfstest_dio(1),    nfstest_file(1),    nfstest_interop(1),
240       nfstest_io(1),   nfstest_lock(1),   nfstest_pkt(1),   nfstest_posix(1),
241       nfstest_sparse(1),           nfstest_ssc(1),            nfstest_xid(1),
242       packet.nfs.nfs4_const(3)
243
244

BUGS

246       No known bugs.
247

AUTHOR

249       Jorge Mora (mora@netapp.com)
250
251
252
253NFStest 2.1.5                  14 February 2017                NFSTEST_PNFS(1)