STAPPROBES.NFS

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

NAME

stapprobes.nfs - systemtap NFS client side probe points

 

DESCRIPTION

This family of probe points is used to probe NFS activities on client side. It contains the following probe points:

nfs.fop.llseek

Fires whenever doing a llseek operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

maxbyte
  Maximum size of the files

offset
  the offset of file to be repositioned 

origin
  the original position. The possible value could be:
          SEEK_SET
                The offset is set to offset bytes.
          SEEK_CUR
                The offset is set to its current location 
                plus offset bytes.
          SEEK_END
                The offset is set to the size of the file 
                plus offset bytes.

nfs.fop.llseek.return

Fires whenever nfs llseek operation is done

Arguments:

retstr
   resulting offset location 

nfs.fop.read

Fires whenever doing a read operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

len,size
  number of bytes to be read

pos
  current file offset   

buf
  the buf address 

nfs.fop.read.return

Fires whenever nfs read operation is done

Arguments:

size
  number of bytes read

nfs.fop.write

Fires whenever doing a write operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

len,size
  number of bytes to written

pos
  current file offset   

buf
  the buf address 

nfs.fop.write.return

Fires whenever nfs write operation is done

Arguments:

size
  number of bytes written 

nfs.fop.aio_read

Fires whenever doing an aio_read operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

count,size
  number of bytes to be read 

pos
  current file offset   

buf
  the buf address

parent_name
  parent dir name

file_name
  file name

cache_valid
  cache related bit mask flag

cache_time
  when we started read-caching this inode

attrtimeo
  how long the cached information is assumed to be valid.


  The cached attrs for this inode needed to be revalidated if
     jiffies - read_cache_jiffies > attrtime

nfs.fop.aio_read.return

Fires whenever nfs aio_read operation is done

Arguments:

size
  number of bytes read 

nfs.fop.aio_write

Fires whenever doing an aio_write operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

count,size
  number of bytes to written

pos
  current file offset   

buf
  the buf address

parent_name
  parent dir name

file_name
  file name

nfs.fop.aio_write.return

Fires whenever nfs aio_write operation is done

Arguments:

size
  number of bytes written 

nfs.fop.mmap

Fires whenever doing an mmap operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

vm_start
  start address within vm_mm 

vm_end
  the first byte after end address within vm_mm

vm_flag
  vm flags

parent_name
  parent dir name

file_name
  file name

cache_valid
  cache related bit mask flag

cache_time
  when we started read-caching this inode

attrtimeo
  how long the cached information is assumed to be valid.


  The cached attrs for this inode needed to be revalidated if
     jiffies - read_cache_jiffies > attrtime

nfs.fop.open

Fires whenever doing an open operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

file_name
  file name

flag
  file flag

i_size
  file length in bytes

nfs.fop.flush

Fires whenever doing an flush operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

mode
  file mode 

ndirty
  number of dirty page to be flushed

nfs.fop.release

Fires whenever doing a release page operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

mode
  file mode 

nfs.fop.fsync

Fires whenever doing a fsync operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

ndirty
  number of dirty page to be flushed

nfs.fop.lock

Fires whenever doing a file lock operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

i_mode
  file type and access rights

cmd
  cmd arguments

fl_type
  lock type

fl_flag
  lock flags

fl_start
  starting offset of locked region 

fl_end
  ending offset of locked region
 

nfs.fop.sendfile

Fires whenever doing a send file operation on nfs client side

Arguments:

dev
  device identifier 

ino
  inode number

s_id
  the pointer to s_id

devname
  the combination of server ip and the name of block device 
  on server

count,size
  number of bytes to sent 

ppos
  current file offset   

cache_valid
  cache related bit mask flag

cache_time
  when we started read-caching this inode

attrtimeo
  how long the cached information is assumed to be valid.


  The cached attrs for this inode needed to be revalidated if
     jiffies - read_cache_jiffies > attrtime

nfs.fop.sendfile.return

Fires whenever nfs sendfile operation is done

Arguments:

size
  number of bytes sent

nfs.fop.check_flags

Fires whenever doing a check flag operation on nfs client side

Arguments:

flags
  file flag

nfs.aop.readpage

Fires when a previous async read operation failed

Arguments:

__page
  the address of page

dev
  device identifier

ino
  inode number    

i_flag
  file flags

i_size
  file length in bytes

sb_flag
  super block flags

file
  file argument

page_index
  offset within mapping

rsize
   read size  (in bytes)

nfs.aop.readpages

Fires when in readahead way, read several pages once

Arguments:

dev
  device identifier

ino
  inode number    

nr_pages ,size
  number of pages attempted to read in this execution 

file
  filp argument

rpages
  read size (in pages) 

rsize
  read size (in bytes)

nfs.aop.readpages.return

Fires whenever a nfs read pages operation is done

Arguments:

size
  number of pages read

nfs.aop.set_page_dirty

Fires whenever set page dirty on nfs client side

Arguments:

__page
  the address of page

page_flag
  page flags

nfs.aop.writepage

Fires whenever writing an mapped page to the server from nfs client side

Arguments:

__page
  the address of page

dev
  device identifier

ino
  inode number  

for_reclaim
  a flag of writeback_control, indicates if it's invoked from the page allocator 

for_kupdate
  a flag of writeback_control, indicates if it's a kupdate writeback
  The priority of wb is decided by above two flags

i_flag
  file flags

i_size
  file length in bytes

i_state
  inode state flags

sb_flag
  super block flags

page_index
  offset within mapping

wsize
  write size

nfs.aop.writepages

Fires whenever writing several dirty pages to the server from nfs client sides

Arguments:

dev
  device identifier

ino
  inode number  

for_reclaim
  a flag of writeback_control, indicates if it's invoked from the page allocator 

for_kupdate
  a flag of writeback_control, indicates if it's a kupdate writeback
  The priority of wb is decided by above two flags

wpages
   write size (in pages)

wsize
  write size

nr_to_write ,size
  number of pages attempted to be written in this execution  

nfs.aop.prepare_write

Fires whenever prepare a page for writing on nfs client sides

Arguments:

__page
  the address of page

dev
  device identifier

ino
  inode number  

offset
  start address of this write operation 

to
  end address of this write operation 

page_index
  offset within mapping 

size
  read bytes

nfs.aop.commit_write

Fires often after prepare write operation

Arguments:

__page
  the address of page

dev
  device identifier

ino
  inode number  

offset
  start address of this write operation 

to
  end address of this write operation 

i_flag
  file flags

i_size
  file length in bytes

sb_flag
  super block flag

page_index
  offset within mapping 

size
  read bytes

nfs.aop.release_page

Arguments:

__page
  the address of page

dev
  device identifier

ino
  inode number

page_index
  offset within mapping 

nfs.proc.lookup

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

filename
  the name of  file which client opens/searches on server

name_len
  the length of file name

bitmask0, bitmask1
  V4 bitmask representing the set of attributes 
  supported on this filesystem (only in probe nfs.proc4.lookup)

nfs.proc.read

Fires when client synchronously reads file from server

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

flags
  used to set task->tk_flags in rpc_init_task function

size,count
  number of bytes to be read in this execution

offset
  the file offset

nfs.proc.read.return

Fires when synchronously reading file from server is done

Arguments:

size
  number of bytes read

nfs.proc.write

Fires when client synchronously writes file to server

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

flags
  used to set task->tk_flags in rpc_init_task function

size,count
  number of  bytes to be written in this execution

offset
  the file offset

bitmask0, bitmask1
  V4 bitmask representing the set of attributes 
  supported on this filesystem (only in probe nfs.proc4.lookup)

nfs.proc.write.return

Fires when synchronously writing file from server is done

Arguments:

size
  number of bytes written 

nfs.proc.commit

Fires when client writes the buffered data to disk, the buffered data is asynchronously written by client before(not exist in NFSV2)

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

size,count
  number of  bytes to be written in this execution

offset
  the file offset

bitmask0, bitmask1
  V4 bitmask representing the set of attributes 
  supported on this filesystem (only in probe nfs.proc4.lookup)

nfs.proc.commit.return

Fires when committing operation is done

Arguments:

size
  number of bytes written 

nfs.proc.read_setup

Fires when client asynchronously reads file from server, this function is used to setup a read rpc task, not do a real read operation.

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

size,count
  number of  bytes to be read in this execution

offset
  the file offset

nfs.proc.read_done

Fires when a read reply is received or some read error occur (timeout or socket shutdown)

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

status
  result of last async read operation 

count
  number of bytes read 

timestamp
  time stamp, which is used for lease renewal (only 
  in nfs.proc4.read_done)

nfs.proc.write_setup

Fires when client asynchronously write data to server, this function is used to setup a write rpc task, not do a write read operation.

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

size,count
  number of  bytes to be written in this execution

offset
  the file offset

how
  used to set args.stable, The possible value could be:
          NFS_UNSTABLE,
          NFS_DATA_SYNC,
          NFS_FILE_SYNC
          (only in nfs.proc3.write_setup and nfs.proc4.write_setup)

bitmask0, bitmask1
   V4 bitmask representing the set of attributes supported 
   on this filesystem (only in probe nfs.proc4.write_setup)

nfs.proc.write_done

Fires when a write reply is received or some write error occur (timeout or socket shutdown)

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

status
  result of last async write operation 

valid
  fattr->valid, indicates which fields are valid

count
  number of bytes written 

timestamp
  time stamp, which is used for lease renewal (only 
  in nfs.proc4.read_done)

nfs.proc.commit_setup

Fires when client asynchronously do a commit operation, this function is used to setup a commit rpc task, not do a commit read operation.

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

size,count
  number of  bytes to be written in this execution

offset
  the file offset

bitmask0, bitmask1
   V4 bitmask representing the set of attributes supported 
   on this filesystem (only in probe nfs.proc4.commit_setup)

nfs.proc.commit_done

Fires when a commit reply is received or some commit error occur (timeout or socket shutdown)

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

status
  result of last async write operation 

valid
  fattr->valid, indicates which fields are valid

count
  number of bytes written 

timestamp
  time stamp, which is used for lease renewal (only 
  in nfs.proc4.read_done)

nfs.proc.open

Fires whenever doing a open operation on nfs client side, the nfs_open function is used to allocate file read/write context information

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

filename
  file name

flag
  file flag

mode
  file mode

nfs.proc.release

Fires whenever doing a release operation on nfs client side,

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

filename
  file name

flag
  file flag

mode
  file mode

nfs.proc4.handle_exception

Fires whenever doing the error handling, only exist in NFSV4

errorcode
  error code 

nfs.proc.create

Fires whenever nfs client creates a file on server

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

fh
  file handler of parent dir

filename
  file name 

filelen
  length of file name

flag
  indicates create mode(only for NFSV3 and NFSV4)

nfs.proc.remove

Fires whenever nfs client removes a file from server

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

fh
  file handler of parent dir

filename
  file name 

filelen
  length of file name

nfs.proc.rename

Fires whenever nfs client renames a file on server

Arguments:

server_ip
  ip address of server

prot
  transfer protocol

version
  nfs version

old_fh
  file handler of old parent dir

old_name
  old file name 

old_filelen
  length of old file name

new_fh
  file handler of new parent dir

new_name
  new file name 

new_filelen
  length of new file name

 

SEE ALSO

stap(1), stapprobes(3stap)