STAPPROBES.NFSD

Section: Misc. Reference Manual Pages (3stap)
Updated: 2009-10-21
Index Return to Main Contents
 

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/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)