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)