Provided by: systemtap_0.0.20071201-1_i386 bug

NAME

       stapprobes.nfsd - systemtap NFS server side probe points

DESCRIPTION

       This  family  of probe points is used to probe NFS activities on server
       side.  Because there is only one function, i.e., nfsd4_proc_compound in
       proc  level  for NFSv4, all the following nfsd.proc probe points except
       nfsd.proc.compound are only for NFSv2 and NFSv3.

       It contains the following probe points:

       nfsd.proc.lookup

              Fires whenever client opens/searchs file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of parent dir

              filename
                file name

              filelen
                the length of file name

       nfsd.proc.read

              Fires whenever client reads file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of file

              count,size
                number of bytes to be read

              offset
                the offset of file

              vec
                struct kvec ,includes buf address in kernel address
                and the length of each buffer

              vlen
                number of blocks to be read

       nfsd.proc.write

              Fires whenever client writes data to file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of file

              count,size
                number of bytes to written

              offset
                the offset of file

              vec
                struct kvec ,includes buf address in kernel address
                and the length of each buffer

              vlen
                number of blocks to written

              stable
                 argp->stable(only for nfs.proc3.write)

       nfsd.proc.commit

              Fires whenever client does a commit operation

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of file

              count,size
                number of bytes to written

              offset
                the offset of file

       nfsd.proc.create

              Fires whenever client creates a file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of parent dir

              filename
                file name

              filelen
                the length of file name

       nfsd.proc.remove

              Fires whenever client removes a file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of file

              filename
                file name

              filelen
                the length of file name

       nfsd.proc.rename

              Fires whenever client renames a file on server

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              fh
                the pointer to file handler of old path

              tfh
                the pointer to file handler of new path

              filename
                old file name

              tname
                new file name

              filelen
                the length of old file name

              tlen
                the length of new file name

       nfsd.proc.compound

              Fires whenever server receives a NFSV4 operation from client

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              num
                number of file operation

              op
                head of operation list

       nfsd.open

              Fires whenever server opens file

              Arguments:

              fh
                 file handle (the first part is the length of the file handle)

              access
                type of open (read/write/commit/readdir...)

              type
                type of file(regular file or dir)

       nfsd.read

              Fires whenever server reads file

              Arguments:

              fh
                 file handle (the first part is the length of the file handle)

              file
                 argument :file, indicates if the file has been opened.

              count,size
                number of bytes to be read

              offset
                the offset of file

              vec
                struct kvec ,includes buf address in kernel address
                and the length of each buffer

              vlen
                number of blocks to be read

       nfsd.write

              Fires whenever server writes file

              Arguments:

              fh
                 file handle (the first part is the length of the file handle)

              file
                 argument :file, indicates if the file has been opened.

              count,size
                number of bytes to be read

              offset
                the offset of file

              vec
                struct kvec ,includes buf address in kernel address
                and the length of each buffer

              vlen
                number of blocks to be written

       nfsd.commit

              Fires when server commits all pending writes to stable storage

              Arguments:

              fh
                file handle (the first part is the length of the file handle)

              count,size
                number of bytes to be read

              offset
                the offset of file

       nfsd.lookup

              Fires whenever client opens/searchs file on server

              Arguments:

              fh
                file handle (the first part is the length of the file handle)

              filename
                file name

              filelen
                the length of file name

       nfsd.create

               Fires when client creates a file(regular,dir,device,fifo) on
               server side, sometimes nfsd will call nfsd_create_v3 instead
               of this function

              Arguments:

              fh
                file handle (the first part is the length of the file handle)

              filename
                file name

              filelen
                the length of file name

              type
                file type(regular,dir,device,fifo ...)

              iap_valid
                Attribute flags

              iap_mode
                file access mod

       nfsd.createv3

              Fires  when client creates a regular file or set file attributes
              on server side,only called by nfsd3_proc_create  and  nfsd4_open
              (op_claim_type is NFS4_OPEN_CLAIM_NULL)

              Arguments:

              fh
                file handle (the first part is the length of the file handle)

              filename
                file name

              filelen
                the length of file name

              iap_valid
                Attribute flags

              iap_mode
                file access mode

              createmode
                create mode .The possible values could be:
                  NFS3_CREATE_EXCLUSIVE,NFS3_CREATE_UNCHECKED,NFS3_CREATE_GUARDED

              truncp
                trunp arguments, indicates if the file shouldbe truncate

              verfier
                file attributes (atime,mtime,mode).It’s used to reset file
                attributes for CREATE_EXCLUSIVE

       nfsd.unlink

              Fires when client removes a file or a dir  on server side,

              Arguments:

              fh
                file handle (the first part is the length of the file handle)

              filename
                file name

              filelen
                the length of file name

              type
                file type(file or dir)

       nfsd.rename
              Fires when clients rename a file on server side

              Arguments:

              fh
                file handler of old path

              tfh
                file handler of new path

              filename
                old file name

              tname
                new file name

              flen
                length of old file name

              tlen
                length of new file name

       nfsd.close

              Fires whenever server closes file

              Arguments:

              filename
                file name

       nfsd.dispatch

              Fires whenever server receives NFS operation from client

              Arguments:

              client_ip
                the ip address of client

              proto
                transfer protocol

              version
                nfs version

              xid
                transmission id

              prog
                program number

              proc
                procedure number

SEE ALSO

       stap(1), stapprobes(5),