1TAPSET::NFSD(3stap) TAPSET::NFSD(3stap)
2
6 tapset::nfsd - systemtap NFS server side probe points
7
11 This family of probe points is used to probe NFS activities on server
12 side. Because there is only one function, i.e., nfsd4_proc_compound in
13 proc level for NFSv4, all the following nfsd.proc probe points except
14 nfsd.proc.compound are only for NFSv2 and NFSv3.
15 It contains the following probe points:
17 nfsd.proc.lookup
20 Fires whenever client opens/searches file on server
22 Arguments:
24 client_ip
26 the ip address of client
27 proto
29 transfer protocol
30 version
32 nfs version
33 fh
35 the pointer to file handler of parent dir
36 filename
38 file name
39 filelen
41 the length of file name
42 nfsd.proc.read
45 Fires whenever client reads file on server
47 Arguments:
49 client_ip
51 the ip address of client
52 proto
54 transfer protocol
55 version
57 nfs version
58 fh
60 the pointer to file handler of file
61 count,size
63 number of bytes to be read
64 offset
66 the offset of file
67 vec
69 struct kvec, includes buf address in kernel address
70 and the length of each buffer
71 vlen
73 number of blocks to be read
74 nfsd.proc.write
77 Fires whenever client writes data to file on server
79 Arguments:
81 client_ip
83 the ip address of client
84 proto
86 transfer protocol
87 version
89 nfs version
90 fh
92 the pointer to file handler of file
93 count,size
95 number of bytes to written
96 offset
98 the offset of file
99 vec
101 struct kvec, includes buf address in kernel address
102 and the length of each buffer
103 vlen
105 number of blocks to written
106 stable
108 argp->stable(only for nfs.proc3.write)
109 nfsd.proc.commit
112 Fires whenever client does a commit operation
114 Arguments:
116 client_ip
118 the ip address of client
119 proto
121 transfer protocol
122 version
124 nfs version
125 fh
127 the pointer to file handler of file
128 count,size
130 number of bytes to written
131 offset
133 the offset of file
134 nfsd.proc.create
137 Fires whenever client creates a file on server
139 Arguments:
141 client_ip
143 the ip address of client
144 proto
146 transfer protocol
147 version
149 nfs version
150 fh
152 the pointer to file handler of parent dir
153 filename
155 file name
156 filelen
158 the length of file name
159 nfsd.proc.remove
162 Fires whenever client removes a file on server
164 Arguments:
166 client_ip
168 the ip address of client
169 proto
171 transfer protocol
172 version
174 nfs version
175 fh
177 the pointer to file handler of file
178 filename
180 file name
181 filelen
183 the length of file name
184 nfsd.proc.rename
187 Fires whenever client renames a file on server
189 Arguments:
191 client_ip
193 the ip address of client
194 proto
196 transfer protocol
197 version
199 nfs version
200 fh
202 the pointer to file handler of old path
203 tfh
205 the pointer to file handler of new path
206 filename
208 old file name
209 tname
211 new file name
212 filelen
214 the length of old file name
215 tlen
217 the length of new file name
218 nfsd.proc.compound
221 Fires whenever server receives a NFSV4 operation from client
223 Arguments:
225 client_ip
227 the ip address of client
228 proto
230 transfer protocol
231 version
233 nfs version
234 num
236 number of file operation
237 op
239 head of operation list
240 nfsd.open
243 Fires whenever server opens file
245 Arguments:
247 fh
249 file handle (the first part is the length of the file handle)
250 access
252 type of open (read/write/commit/readdir...)
253 type
255 type of file(regular file or dir)
256 nfsd.read
259 Fires whenever server reads file
261 Arguments:
263 fh
265 file handle (the first part is the length of the file handle)
266 file
268 argument :file, indicates if the file has been opened.
269 count,size
271 number of bytes to be read
272 offset
274 the offset of file
275 vec
277 struct kvec, includes buf address in kernel address
278 and the length of each buffer
279 vlen
281 number of blocks to be read
282 nfsd.write
285 Fires whenever server writes file
287 Arguments:
289 fh
291 file handle (the first part is the length of the file handle)
292 file
294 argument :file, indicates if the file has been opened.
295 count,size
297 number of bytes to be read
298 offset
300 the offset of file
301 vec
303 struct kvec, includes buf address in kernel address
304 and the length of each buffer
305 vlen
307 number of blocks to be written
308 nfsd.commit
311 Fires when server commits all pending writes to stable storage
313 Arguments:
315 fh
317 file handle (the first part is the length of the file handle)
318 count,size
320 number of bytes to be read
321 offset
323 the offset of file
324 nfsd.lookup
327 Fires whenever client opens/searches file on server
329 Arguments:
331 fh
333 file handle (the first part is the length of the file handle)
334 filename
336 file name
337 filelen
339 the length of file name
340 nfsd.create
343 Fires when client creates a file(regular,dir,device,fifo) on
345 server side, sometimes nfsd will call nfsd_create_v3 instead
346 of this function
347 Arguments:
349 fh
351 file handle (the first part is the length of the file handle)
352 filename
354 file name
355 filelen
357 the length of file name
358 type
360 file type(regular,dir,device,fifo ...)
361 iap_valid
363 Attribute flags
364 iap_mode
366 file access mod
367 nfsd.createv3
370 Fires when client creates a regular file or set file attributes
372 on server side, only called by nfsd3_proc_create and nfsd4_open
373 (op_claim_type is NFS4_OPEN_CLAIM_NULL)
374 Arguments:
376 fh
378 file handle (the first part is the length of the file handle)
379 filename
381 file name
382 filelen
384 the length of file name
385 iap_valid
387 Attribute flags
388 iap_mode
390 file access mode
391 createmode
393 create mode. The possible values could be:
394 NFS3_CREATE_EXCLUSIVE,NFS3_CREATE_UNCHECKED,NFS3_CRE‐
395 ATE_GUARDED
396 truncp
398 trunp arguments, indicates if the file should be truncated
399 verfier
401 file attributes (atime,mtime,mode). It's used to reset file
402 attributes for CREATE_EXCLUSIVE
403 nfsd.unlink
406 Fires when client removes a file or a dir on server side,
408 Arguments:
410 fh
412 file handle (the first part is the length of the file handle)
413 filename
415 file name
416 filelen
418 the length of file name
419 type
421 file type(file or dir)
422 nfsd.rename
425 Fires when clients rename a file on server side
426 Arguments:
428 fh
430 file handler of old path
431 tfh
433 file handler of new path
434 filename
436 old file name
437 tname
439 new file name
440 flen
442 length of old file name
443 tlen
445 length of new file name
446 nfsd.close
449 Fires whenever server closes file
451 Arguments:
453 filename
455 file name
456 nfsd.dispatch
459 Fires whenever server receives NFS operation from client
461 Arguments:
463 client_ip
465 the ip address of client
466 proto
468 transfer protocol
469 version
471 nfs version
472 xid
474 transmission id
475 prog
477 program number
478 proc
480 procedure number
481
484 stap(1), stapprobes(3stap)
485IBM TAPSET::NFSD(3stap)