Provided by: systemtap_0.0.20080705-2ubuntu1_i386 bug

NAME

       stapprobes.rpc - systemtap SunRPC probe points

DESCRIPTION

       This  family  of  probe  points is used to probe the SUNRPC activities,
       including the client, the server and the sunrpc scheduler.

       It contains the following probe points:

       sunrpc.clnt.create_client
              Fires when an RPC client is to be created

              Arguments:

              servername
                The name of the server machine

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              vers
                The version number of the RPC program

              prot
                The number of the IP protocol

              authflavor
                The authentication flavor

       sunrpc.clnt.clone_client
              Fires when an RPC client structure is to be cloned

              Arguments:

              servername
                The name of the server machine

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              vers
                The version number of the RPC program

              prot
                The number of the IP protocol

              authflavor
                The authentication flavor

       sunrpc.clnt.shutdown_client
              Fires when an RPC client is to be shut down

              Arguments

              servername
                The name of the server machine

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              vers
                The version number of the RPC program

              prot
                The number of the IP protocol

              authflavor
                The authentication flavor

              clones
                The number of clones

              tasks
                The number of references

              netreconn
                The count of reconnections

              rpccnt
                The count of RPC calls

              om_ops
                The count of operations

              om_ntrans
                The count of RPC transmissions

              om_bytes_sent
                The count of bytes out

              om_bytes_recv
                The count of bytes in

              om_queue
                The jiffies queued for transmission

              om_rtt
                The RPC RTT jiffies

              om_execution
                The RPC execution jiffies

       sunrpc.clnt.bind_new_program
              Fires when a new RPC program is to be bound an existing client

              Arguments

              servername
                The name of the server machine

              old_progname
                The name of old RPC program

              old_prog
                The number of old RPC program

              old_vers
                The version of old RPC program

              progname
                The name of new RPC program

              prog
                The number of new RPC program

              vers
                The version of new RPC program

       sunrpc.clnt.call_sync
              Fires when an RPC procedure is to be called synchronously

              Arguments

              servername
                The name of the server machine

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              vers
                The version number of the RPC program

              prot
                The number of the IP protocol

              port
                The port number

              xid
                Current transmission id

              dead
                Whether this client is abandoned

              procname
                The procedure name in this RPC call

              proc
                The procedure number in this RPC call

              flags
                The flags of this RPC call

       sunrpc.clnt.call_async
              Fires when an RPC procedure is to be called asynchronously

              Arguments

              servername
                The name of the server machine

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              vers
                The version number of the RPC program

              prot
                The number of the IP protocol

              port
                The port number

              xid
                Current transmission id

              dead
                Whether this client is abandoned

              procname
                The procedure name in this RPC call

              proc
                The procedure number in this RPC call

              flags
                The flags of this RPC call

       sunrpc.clnt.restart_call
              Fires when an (async) RPC client is to be restarted

              Arguments

              servername
                The name of the server machine

              prog
                The number of the RPC program

              xid
                The transmission id

              tk_pid
                The debugging aid of this task

              tk_flags
                The task flags

              tk_priority
                The task priority

              tk_runstate
                The task run status

       sunrpc.svc.register
              Fires when an RPC service is to be  registered  with  the  local
              portmapper.   If  proto  and port == 0, it means to unregister a
              service.

              Arguments

              sv_name
                The name of the service

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              prot
                The number of the IP protocol

              port
                The port number

       sunrpc.svc.create
              Fires when an RPC service is to be created

              Arguments

              progname
                The name of the RPC program

              prog
                The number of the RPC program

              pg_nvers
                The total of the supported versions

              bufsize
                The buffer size

       sunrpc.svc.destroy
              Fires when an RPC client is to be destroyed

              Arguments

              sv_name
                The service name

              sv_progname
                The name of the program

              sv_prog
                The number of the program

              sv_nrthreads
                The number of concurrent threads

              netcnt
                The count of received RPC requests

              nettcpconn
                The count of accepted TCP connections

              rpccnt
                The count of valid RPC requests

              rpcbadfmt
                The count of requests dropped for bad formats

              rpcbadauth
                The count of requests drooped for authentication failure

       sunrpc.svc.process
              Fires when an RPC client is to be processed

              Arguments

              sv_name
                The service name

              sv_prog
                The number of the program

              sv_nrthreads
                The number of concurrent threads

              peer_ip
                The peer address where the request is from

              rq_xid
                The transmission id in the request

              rq_prog
                The program number in the request

              rq_vers
                The program version in the request

              rq_proc
                The procedure number in the request

              rq_prot
                The IP protocol of the reqeust

       sunrpc.svc.authorise
              Fires when an RPC client is to be authorised

              Arguments

              sv_name
                The service name

              peer_ip
                The peer address where the request is from

              rq_xid
                The transmission id in the request

              rq_prog
                The program number in the request

              rq_vers
                The program version in the request

              rq_proc
                The procedure number in the request

              rq_prot
                The IP protocol of the reqeust

       sunrpc.svc.recv
              Fires when the server is to receive  the  next  request  on  any
              socket

              Arguments

              sv_name
                The service name

              sv_prog
                The number of the program

              sv_nrthreads
                The number of concurrent threads

              timeout
                The timeout of waiting for data

       sunrpc.svc.send
              Fires when want to return reply to client

              Arguments

              sv_name
                The service name

              peer_ip
                The peer address where the request is from

              rq_xid
                The transmission id in the request

              rq_prog
                The program number in the request

              rq_vers
                The program version in the request

              rq_proc
                The procedure number in the request

              rq_prot
                The IP protocol of the reqeust

       sunrpc.svc.drop
              Fires when a request is to be dropped

              Arguments

              sv_name
                The service name

              peer_ip
                The peer address where the request is from

              rq_xid
                The transmission id in the request

              rq_prog
                The program number in the request

              rq_vers
                The program version in the request

              rq_proc
                The procedure number in the request

              rq_prot
                The IP protocol of the reqeust

       sunrpc.sched.new_task
              Fires when a new task is to be created for the specified client

              Arguments xid
                The transmission id in the RPC call

              prog
                The program number in the RPC call

              vers
                The program version in the RPC call

              prot
                The IP protocol in the RPC call

              tk_flags
                The flags of the task

       sunrpc.sched.release_task
              Fires  when  all  resources  associated  with  a  task are to be
              released

              Arguments

              xid
                The transmission id in the RPC call

              prog
                The program number in the RPC call

              vers
                The program version in the RPC call

              prot
                The IP protocol in the RPC call

              tk_flags
                The flags of the task

       sunrpc.sched.execute
              Fires when the  RPC  ‘scheduler’(or  rather,  the  finite  state
              machine) is to be executed

              Arguments

              xid
                The transmission id in the RPC call

              prog
                The program number in the RPC call

              vers
                The program version in the RPC call

              prot
                The IP protocol in the RPC call

              tk_pid
                The debugging id of the task

              tk_flags
                The flags of the task

       sunrpc.sched.delay
              Fires when a task is to be delayed

              Arguments

              xid
                The transmission id in the RPC call

              prog
                The program number in the RPC call

              vers
                The program version in the RPC call

              prot
                The IP protocol in the RPC call

              tk_pid
                The debugging id of the task

              tk_flags
                The flags of the task

              delay
                The time delayed

SEE ALSO

       stap(1), stapprobes(5),