stapprobes.rpc5

Overview

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