--- name: "stapprobes.rpc" section: "5" platform: "linux" package: "systemtap" version: "0.0.20080705-1+lenny1" release: "Debian 5.0 (Lenny)" platforms: ["linux"] url: "https://new.carta.tech/stapprobes.rpc" --- # stapprobes.rpc(5) systemtap SunRPC probe points ## NAME stapprobes.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 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 ## SEE ALSO [*stap*(1)](/stap/1.md), [*stapprobes*(5)](/stapprobes/5.md),