stapprobes.nfsd(3stap)
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_GUARDEDtruncptrunp arguments, indicates if the file shouldbe truncateverfierfile 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