TAPSET::NFSD(3stap)													       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)

IBM
															       TAPSET::NFSD(3stap)