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)