stapprobes.nfsd5

Overview

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