Provided by: systemtap_0.0.20071201-1_i386 bug

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

              Fies 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

              Fies whenever a nfs read pages operation is done

              Arguments:

              size
                number of pages read

       nfs.aop.set_page_dirty

              Fies whenever set page dirty on nfs client side

              Arguments:

              __page
                the address of page

              page_flag
                page flags

       nfs.aop.writepage

              Fies  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

              Fies 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

              Fies whenever prepare a page for writting 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

              Fies 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/searchs 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 writting 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(5),