Linux Certif

Toute la documentation sur la certification Linux LPI

tapset::rpc.3stap

NAME

tapset::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 request

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 request

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 request

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 request

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(3stap)