TAPSET::NFSD(3stap)

NAME
tapset::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/searches 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/searches 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 should be truncated 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(3stap)