1TAPSET::NFS(3stap) TAPSET::NFS(3stap)
2
6 tapset::nfs - systemtap NFS client side probe points
7
11 This family of probe points is used to probe NFS activities on client
12 side. It contains the following probe points:
13 nfs.fop.llseek
16 Fires whenever doing a llseek operation on nfs client side
18 Arguments:
20 dev
22 device identifier
23 ino
25 inode number
26 s_id
28 the pointer to s_id
29 devname
31 the combination of server ip and the name of block device
32 on server
33 maxbyte
35 Maximum size of the files
36 offset
38 the offset of file to be repositioned
39 origin
41 the original position. The possible value could be:
42 SEEK_SET
43 The offset is set to offset bytes.
44 SEEK_CUR
45 The offset is set to its current location
46 plus offset bytes.
47 SEEK_END
48 The offset is set to the size of the file
49 plus offset bytes.
50 nfs.fop.llseek.return
53 Fires whenever nfs llseek operation is done
55 Arguments:
57 retstr
59 resulting offset location
60 nfs.fop.read
63 Fires whenever doing a read operation on nfs client side
65 Arguments:
67 dev
69 device identifier
70 ino
72 inode number
73 s_id
75 the pointer to s_id
76 devname
78 the combination of server ip and the name of block device
79 on server
80 len,size
82 number of bytes to be read
83 pos
85 current file offset
86 buf
88 the buf address
89 nfs.fop.read.return
92 Fires whenever nfs read operation is done
94 Arguments:
96 size
98 number of bytes read
99 nfs.fop.write
102 Fires whenever doing a write operation on nfs client side
104 Arguments:
106 dev
108 device identifier
109 ino
111 inode number
112 s_id
114 the pointer to s_id
115 devname
117 the combination of server ip and the name of block device
118 on server
119 len,size
121 number of bytes to written
122 pos
124 current file offset
125 buf
127 the buf address
128 nfs.fop.write.return
131 Fires whenever nfs write operation is done
133 Arguments:
135 size
137 number of bytes written
138 nfs.fop.aio_read
141 Fires whenever doing an aio_read operation on nfs client side
143 Arguments:
145 dev
147 device identifier
148 ino
150 inode number
151 s_id
153 the pointer to s_id
154 devname
156 the combination of server ip and the name of block device
157 on server
158 count,size
160 number of bytes to be read
161 pos
163 current file offset
164 buf
166 the buf address
167 parent_name
169 parent dir name
170 file_name
172 file name
173 cache_valid
175 cache related bit mask flag
176 cache_time
178 when we started read-caching this inode
179 attrtimeo
181 how long the cached information is assumed to be valid.
182 The cached attrs for this inode needed to be revalidated if
184 jiffies - read_cache_jiffies > attrtime
185 nfs.fop.aio_read.return
188 Fires whenever nfs aio_read operation is done
190 Arguments:
192 size
194 number of bytes read
195 nfs.fop.aio_write
198 Fires whenever doing an aio_write operation on nfs client side
200 Arguments:
202 dev
204 device identifier
205 ino
207 inode number
208 s_id
210 the pointer to s_id
211 devname
213 the combination of server ip and the name of block device
214 on server
215 count,size
217 number of bytes to written
218 pos
220 current file offset
221 buf
223 the buf address
224 parent_name
226 parent dir name
227 file_name
229 file name
230 nfs.fop.aio_write.return
233 Fires whenever nfs aio_write operation is done
235 Arguments:
237 size
239 number of bytes written
240 nfs.fop.mmap
243 Fires whenever doing an mmap operation on nfs client side
245 Arguments:
247 dev
249 device identifier
250 ino
252 inode number
253 s_id
255 the pointer to s_id
256 devname
258 the combination of server ip and the name of block device
259 on server
260 vm_start
262 start address within vm_mm
263 vm_end
265 the first byte after end address within vm_mm
266 vm_flag
268 vm flags
269 parent_name
271 parent dir name
272 file_name
274 file name
275 cache_valid
277 cache related bit mask flag
278 cache_time
280 when we started read-caching this inode
281 attrtimeo
283 how long the cached information is assumed to be valid.
284 The cached attrs for this inode needed to be revalidated if
286 jiffies - read_cache_jiffies > attrtime
287 nfs.fop.open
290 Fires whenever doing an open operation on nfs client side
292 Arguments:
294 dev
296 device identifier
297 ino
299 inode number
300 s_id
302 the pointer to s_id
303 devname
305 the combination of server ip and the name of block device
306 on server
307 file_name
309 file name
310 flag
312 file flag
313 i_size
315 file length in bytes
316 nfs.fop.flush
319 Fires whenever doing an flush operation on nfs client side
321 Arguments:
323 dev
325 device identifier
326 ino
328 inode number
329 s_id
331 the pointer to s_id
332 devname
334 the combination of server ip and the name of block device
335 on server
336 mode
338 file mode
339 ndirty
341 number of dirty page to be flushed
342 nfs.fop.release
345 Fires whenever doing a release page operation on nfs client side
347 Arguments:
349 dev
351 device identifier
352 ino
354 inode number
355 s_id
357 the pointer to s_id
358 devname
360 the combination of server ip and the name of block device
361 on server
362 mode
364 file mode
365 nfs.fop.fsync
368 Fires whenever doing a fsync operation on nfs client side
370 Arguments:
372 dev
374 device identifier
375 ino
377 inode number
378 s_id
380 the pointer to s_id
381 devname
383 the combination of server ip and the name of block device
384 on server
385 ndirty
387 number of dirty page to be flushed
388 nfs.fop.lock
391 Fires whenever doing a file lock operation on nfs client side
393 Arguments:
395 dev
397 device identifier
398 ino
400 inode number
401 s_id
403 the pointer to s_id
404 devname
406 the combination of server ip and the name of block device
407 on server
408 i_mode
410 file type and access rights
411 cmd
413 cmd arguments
414 fl_type
416 lock type
417 fl_flag
419 lock flags
420 fl_start
422 starting offset of locked region
423 fl_end
425 ending offset of locked region
426 nfs.fop.sendfile
429 Fires whenever doing a send file operation on nfs client side
431 Arguments:
433 dev
435 device identifier
436 ino
438 inode number
439 s_id
441 the pointer to s_id
442 devname
444 the combination of server ip and the name of block device
445 on server
446 count,size
448 number of bytes to sent
449 ppos
451 current file offset
452 cache_valid
454 cache related bit mask flag
455 cache_time
457 when we started read-caching this inode
458 attrtimeo
460 how long the cached information is assumed to be valid.
461 The cached attrs for this inode needed to be revalidated if
463 jiffies - read_cache_jiffies > attrtime
464 nfs.fop.sendfile.return
467 Fires whenever nfs sendfile operation is done
469 Arguments:
471 size
473 number of bytes sent
474 nfs.fop.check_flags
477 Fires whenever doing a check flag operation on nfs client side
479 Arguments:
481 flags
483 file flag
484 nfs.aop.readpage
487 Fires when a previous async read operation failed
489 Arguments:
491 __page
493 the address of page
494 dev
496 device identifier
497 ino
499 inode number
500 i_flag
502 file flags
503 i_size
505 file length in bytes
506 sb_flag
508 super block flags
509 file
511 file argument
512 page_index
514 offset within mapping
515 rsize
517 read size (in bytes)
518 nfs.aop.readpages
521 Fires when in readahead way, read several pages once
523 Arguments:
525 dev
527 device identifier
528 ino
530 inode number
531 nr_pages ,size
533 number of pages attempted to read in this execution
534 file
536 filp argument
537 rpages
539 read size (in pages)
540 rsize
542 read size (in bytes)
543 nfs.aop.readpages.return
546 Fires whenever a nfs read pages operation is done
548 Arguments:
550 size
552 number of pages read
553 nfs.aop.set_page_dirty
556 Fires whenever set page dirty on nfs client side
558 Arguments:
560 __page
562 the address of page
563 page_flag
565 page flags
566 nfs.aop.writepage
569 Fires whenever writing an mapped page to the server from nfs
571 client side
572 Arguments:
574 __page
576 the address of page
577 dev
579 device identifier
580 ino
582 inode number
583 for_reclaim
585 a flag of writeback_control, indicates if it's invoked from
586 the page allocator
587 for_kupdate
589 a flag of writeback_control, indicates if it's a kupdate
590 writeback
591 The priority of wb is decided by above two flags
592 i_flag
594 file flags
595 i_size
597 file length in bytes
598 i_state
600 inode state flags
601 sb_flag
603 super block flags
604 page_index
606 offset within mapping
607 wsize
609 write size
610 nfs.aop.writepages
613 Fires whenever writing several dirty pages to the server from
615 nfs client sides
616 Arguments:
618 dev
620 device identifier
621 ino
623 inode number
624 for_reclaim
626 a flag of writeback_control, indicates if it's invoked from
627 the page allocator
628 for_kupdate
630 a flag of writeback_control, indicates if it's a kupdate
631 writeback
632 The priority of wb is decided by above two flags
633 wpages
635 write size (in pages)
636 wsize
638 write size
639 nr_to_write ,size
641 number of pages attempted to be written in this execution
642 nfs.aop.prepare_write
645 Fires whenever prepare a page for writing on nfs client sides
647 Arguments:
649 __page
651 the address of page
652 dev
654 device identifier
655 ino
657 inode number
658 offset
660 start address of this write operation
661 to
663 end address of this write operation
664 page_index
666 offset within mapping
667 size
669 read bytes
670 nfs.aop.commit_write
673 Fires often after prepare write operation
675 Arguments:
677 __page
679 the address of page
680 dev
682 device identifier
683 ino
685 inode number
686 offset
688 start address of this write operation
689 to
691 end address of this write operation
692 i_flag
694 file flags
695 i_size
697 file length in bytes
698 sb_flag
700 super block flag
701 page_index
703 offset within mapping
704 size
706 read bytes
707 nfs.aop.release_page
710 Arguments:
712 __page
714 the address of page
715 dev
717 device identifier
718 ino
720 inode number
721 page_index
723 offset within mapping
724 nfs.proc.lookup
727 Arguments:
729 server_ip
731 ip address of server
732 prot
734 transfer protocol
735 version
737 nfs version
738 filename
740 the name of file which client opens/searches on server
741 name_len
743 the length of file name
744 bitmask0, bitmask1
746 V4 bitmask representing the set of attributes
747 supported on this filesystem (only in probe nfs.proc4.lookup)
748 nfs.proc.read
751 Fires when client synchronously reads file from server
753 Arguments:
755 server_ip
757 ip address of server
758 prot
760 transfer protocol
761 version
763 nfs version
764 flags
766 used to set task->tk_flags in rpc_init_task function
767 size,count
769 number of bytes to be read in this execution
770 offset
772 the file offset
773 nfs.proc.read.return
776 Fires when synchronously reading file from server is done
778 Arguments:
780 size
782 number of bytes read
783 nfs.proc.write
786 Fires when client synchronously writes file to server
788 Arguments:
790 server_ip
792 ip address of server
793 prot
795 transfer protocol
796 version
798 nfs version
799 flags
801 used to set task->tk_flags in rpc_init_task function
802 size,count
804 number of bytes to be written in this execution
805 offset
807 the file offset
808 bitmask0, bitmask1
810 V4 bitmask representing the set of attributes
811 supported on this filesystem (only in probe nfs.proc4.lookup)
812 nfs.proc.write.return
815 Fires when synchronously writing file from server is done
817 Arguments:
819 size
821 number of bytes written
822 nfs.proc.commit
825 Fires when client writes the buffered data to disk, the buffered
827 data is asynchronously written by client before(not exist in
828 NFSV2)
829 Arguments:
831 server_ip
833 ip address of server
834 prot
836 transfer protocol
837 version
839 nfs version
840 size,count
842 number of bytes to be written in this execution
843 offset
845 the file offset
846 bitmask0, bitmask1
848 V4 bitmask representing the set of attributes
849 supported on this filesystem (only in probe nfs.proc4.lookup)
850 nfs.proc.commit.return
853 Fires when committing operation is done
855 Arguments:
857 size
859 number of bytes written
860 nfs.proc.read_setup
863 Fires when client asynchronously reads file from server, this
865 function is used to setup a read rpc task, not do a real read
866 operation.
867 Arguments:
869 server_ip
871 ip address of server
872 prot
874 transfer protocol
875 version
877 nfs version
878 size,count
880 number of bytes to be read in this execution
881 offset
883 the file offset
884 nfs.proc.read_done
887 Fires when a read reply is received or some read error occur
889 (timeout or socket shutdown)
890 Arguments:
892 server_ip
894 ip address of server
895 prot
897 transfer protocol
898 version
900 nfs version
901 status
903 result of last async read operation
904 count
906 number of bytes read
907 timestamp
909 time stamp, which is used for lease renewal (only
910 in nfs.proc4.read_done)
911 nfs.proc.write_setup
914 Fires when client asynchronously write data to server, this
916 function is used to setup a write rpc task, not do a write read
917 operation.
918 Arguments:
920 server_ip
922 ip address of server
923 prot
925 transfer protocol
926 version
928 nfs version
929 size,count
931 number of bytes to be written in this execution
932 offset
934 the file offset
935 how
937 used to set args.stable, The possible value could be:
938 NFS_UNSTABLE,
939 NFS_DATA_SYNC,
940 NFS_FILE_SYNC
941 (only in nfs.proc3.write_setup and
942 nfs.proc4.write_setup)
943 bitmask0, bitmask1
945 V4 bitmask representing the set of attributes supported
946 on this filesystem (only in probe nfs.proc4.write_setup)
947 nfs.proc.write_done
950 Fires when a write reply is received or some write error occur
952 (timeout or socket shutdown)
953 Arguments:
955 server_ip
957 ip address of server
958 prot
960 transfer protocol
961 version
963 nfs version
964 status
966 result of last async write operation
967 valid
969 fattr->valid, indicates which fields are valid
970 count
972 number of bytes written
973 timestamp
975 time stamp, which is used for lease renewal (only
976 in nfs.proc4.read_done)
977 nfs.proc.commit_setup
980 Fires when client asynchronously do a commit operation, this
982 function is used to setup a commit rpc task, not do a commit
983 read operation.
984 Arguments:
986 server_ip
988 ip address of server
989 prot
991 transfer protocol
992 version
994 nfs version
995 size,count
997 number of bytes to be written in this execution
998 offset
1000 the file offset
1001 bitmask0, bitmask1
1003 V4 bitmask representing the set of attributes supported
1004 on this filesystem (only in probe nfs.proc4.commit_setup)
1005 nfs.proc.commit_done
1008 Fires when a commit reply is received or some commit error occur
1010 (timeout or socket shutdown)
1011 Arguments:
1013 server_ip
1015 ip address of server
1016 prot
1018 transfer protocol
1019 version
1021 nfs version
1022 status
1024 result of last async write operation
1025 valid
1027 fattr->valid, indicates which fields are valid
1028 count
1030 number of bytes written
1031 timestamp
1033 time stamp, which is used for lease renewal (only
1034 in nfs.proc4.read_done)
1035 nfs.proc.open
1038 Fires whenever doing a open operation on nfs client side, the
1040 nfs_open function is used to allocate file read/write context
1041 information
1042 Arguments:
1044 server_ip
1046 ip address of server
1047 prot
1049 transfer protocol
1050 version
1052 nfs version
1053 filename
1055 file name
1056 flag
1058 file flag
1059 mode
1061 file mode
1062 nfs.proc.release
1065 Fires whenever doing a release operation on nfs client side,
1067 Arguments:
1069 server_ip
1071 ip address of server
1072 prot
1074 transfer protocol
1075 version
1077 nfs version
1078 filename
1080 file name
1081 flag
1083 file flag
1084 mode
1086 file mode
1087 nfs.proc4.handle_exception
1090 Fires whenever doing the error handling, only exist in NFSV4
1092 errorcode
1094 error code
1095 nfs.proc.create
1098 Fires whenever nfs client creates a file on server
1100 Arguments:
1102 server_ip
1104 ip address of server
1105 prot
1107 transfer protocol
1108 version
1110 nfs version
1111 fh
1113 file handler of parent dir
1114 filename
1116 file name
1117 filelen
1119 length of file name
1120 flag
1122 indicates create mode(only for NFSV3 and NFSV4)
1123 nfs.proc.remove
1126 Fires whenever nfs client removes a file from server
1128 Arguments:
1130 server_ip
1132 ip address of server
1133 prot
1135 transfer protocol
1136 version
1138 nfs version
1139 fh
1141 file handler of parent dir
1142 filename
1144 file name
1145 filelen
1147 length of file name
1148 nfs.proc.rename
1151 Fires whenever nfs client renames a file on server
1153 Arguments:
1155 server_ip
1157 ip address of server
1158 prot
1160 transfer protocol
1161 version
1163 nfs version
1164 old_fh
1166 file handler of old parent dir
1167 old_name
1169 old file name
1170 old_filelen
1172 length of old file name
1173 new_fh
1175 file handler of new parent dir
1176 new_name
1178 new file name
1179 new_filelen
1181 length of new file name
1182
1185 stap(1), stapprobes(3stap)
1186IBM TAPSET::NFS(3stap)