TAPSET::RPC(3stap) 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)
IBM
TAPSET::RPC(3stap)