1TAPSET::RPC(3stap)                                          TAPSET::RPC(3stap)
2
3
4

NAME

6       tapset::rpc - systemtap SunRPC probe points
7
8
9

DESCRIPTION

11       This  family  of  probe  points is used to probe the SUNRPC activities,
12       including the client, the server and the sunrpc scheduler.
13
14       It contains the following probe points:
15
16
17       sunrpc.clnt.create_client
18              Fires when an RPC client is to be created
19
20              Arguments:
21
22              servername
23                The name of the server machine
24
25              progname
26                The name of the RPC program
27
28              prog
29                The number of the RPC program
30
31              vers
32                The version number of the RPC program
33
34              prot
35                The number of the IP protocol
36
37              authflavor
38                The authentication flavor
39
40
41       sunrpc.clnt.clone_client
42              Fires when an RPC client structure is to be cloned
43
44              Arguments:
45
46              servername
47                The name of the server machine
48
49              progname
50                The name of the RPC program
51
52              prog
53                The number of the RPC program
54
55              vers
56                The version number of the RPC program
57
58              prot
59                The number of the IP protocol
60
61              authflavor
62                The authentication flavor
63
64
65       sunrpc.clnt.shutdown_client
66              Fires when an RPC client is to be shut down
67
68              Arguments
69
70              servername
71                The name of the server machine
72
73              progname
74                The name of the RPC program
75
76              prog
77                The number of the RPC program
78
79              vers
80                The version number of the RPC program
81
82              prot
83                The number of the IP protocol
84
85              authflavor
86                The authentication flavor
87
88              clones
89                The number of clones
90
91              tasks
92                The number of references
93
94              netreconn
95                The count of reconnections
96
97              rpccnt
98                The count of RPC calls
99
100              om_ops
101                The count of operations
102
103              om_ntrans
104                The count of RPC transmissions
105
106              om_bytes_sent
107                The count of bytes out
108
109              om_bytes_recv
110                The count of bytes in
111
112              om_queue
113                The jiffies queued for transmission
114
115              om_rtt
116                The RPC RTT jiffies
117
118              om_execution
119                The RPC execution jiffies
120
121
122       sunrpc.clnt.bind_new_program
123              Fires when a new RPC program is to be bound an existing client
124
125              Arguments
126
127              servername
128                The name of the server machine
129
130              old_progname
131                The name of old RPC program
132
133              old_prog
134                The number of old RPC program
135
136              old_vers
137                The version of old RPC program
138
139              progname
140                The name of new RPC program
141
142              prog
143                The number of new RPC program
144
145              vers
146                The version of new RPC program
147
148
149       sunrpc.clnt.call_sync
150              Fires when an RPC procedure is to be called synchronously
151
152              Arguments
153
154              servername
155                The name of the server machine
156
157              progname
158                The name of the RPC program
159
160              prog
161                The number of the RPC program
162
163              vers
164                The version number of the RPC program
165
166              prot
167                The number of the IP protocol
168
169              port
170                The port number
171
172              xid
173                Current transmission id
174
175              dead
176                Whether this client is abandoned
177
178              procname
179                The procedure name in this RPC call
180
181              proc
182                The procedure number in this RPC call
183
184              flags
185                The flags of this RPC call
186
187
188       sunrpc.clnt.call_async
189              Fires when an RPC procedure is to be called asynchronously
190
191              Arguments
192
193              servername
194                The name of the server machine
195
196              progname
197                The name of the RPC program
198
199              prog
200                The number of the RPC program
201
202              vers
203                The version number of the RPC program
204
205              prot
206                The number of the IP protocol
207
208              port
209                The port number
210
211              xid
212                Current transmission id
213
214              dead
215                Whether this client is abandoned
216
217              procname
218                The procedure name in this RPC call
219
220              proc
221                The procedure number in this RPC call
222
223              flags
224                The flags of this RPC call
225
226
227       sunrpc.clnt.restart_call
228              Fires when an (async) RPC client is to be restarted
229
230              Arguments
231
232              servername
233                The name of the server machine
234
235              prog
236                The number of the RPC program
237
238              xid
239                The transmission id
240
241              tk_pid
242                The debugging aid of this task
243
244              tk_flags
245                The task flags
246
247              tk_priority
248                The task priority
249
250              tk_runstate
251                The task run status
252
253
254       sunrpc.svc.register
255              Fires when an RPC service is to be  registered  with  the  local
256              portmapper.   If  proto  and port == 0, it means to unregister a
257              service.
258
259              Arguments
260
261              sv_name
262                The name of the service
263
264              progname
265                The name of the RPC program
266
267              prog
268                The number of the RPC program
269
270              prot
271                The number of the IP protocol
272
273              port
274                The port number
275
276
277       sunrpc.svc.create
278              Fires when an RPC service is to be created
279
280              Arguments
281
282              progname
283                The name of the RPC program
284
285              prog
286                The number of the RPC program
287
288              pg_nvers
289                The total of the supported versions
290
291              bufsize
292                The buffer size
293
294
295       sunrpc.svc.destroy
296              Fires when an RPC client is to be destroyed
297
298              Arguments
299
300              sv_name
301                The service name
302
303              sv_progname
304                The name of the program
305
306              sv_prog
307                The number of the program
308
309              sv_nrthreads
310                The number of concurrent threads
311
312              netcnt
313                The count of received RPC requests
314
315              nettcpconn
316                The count of accepted TCP connections
317
318              rpccnt
319                The count of valid RPC requests
320
321              rpcbadfmt
322                The count of requests dropped for bad formats
323
324              rpcbadauth
325                The count of requests drooped for authentication failure
326
327
328       sunrpc.svc.process
329              Fires when an RPC client is to be processed
330
331              Arguments
332
333              sv_name
334                The service name
335
336              sv_prog
337                The number of the program
338
339              sv_nrthreads
340                The number of concurrent threads
341
342              peer_ip
343                The peer address where the request is from
344
345              rq_xid
346                The transmission id in the request
347
348              rq_prog
349                The program number in the request
350
351              rq_vers
352                The program version in the request
353
354              rq_proc
355                The procedure number in the request
356
357              rq_prot
358                The IP protocol of the request
359
360
361       sunrpc.svc.authorise
362              Fires when an RPC client is to be authorised
363
364              Arguments
365
366              sv_name
367                The service name
368
369              peer_ip
370                The peer address where the request is from
371
372              rq_xid
373                The transmission id in the request
374
375              rq_prog
376                The program number in the request
377
378              rq_vers
379                The program version in the request
380
381              rq_proc
382                The procedure number in the request
383
384              rq_prot
385                The IP protocol of the request
386
387
388       sunrpc.svc.recv
389              Fires when the server is to receive  the  next  request  on  any
390              socket
391
392              Arguments
393
394              sv_name
395                The service name
396
397              sv_prog
398                The number of the program
399
400              sv_nrthreads
401                The number of concurrent threads
402
403              timeout
404                The timeout of waiting for data
405
406
407       sunrpc.svc.send
408              Fires when want to return reply to client
409
410              Arguments
411
412              sv_name
413                The service name
414
415              peer_ip
416                The peer address where the request is from
417
418              rq_xid
419                The transmission id in the request
420
421              rq_prog
422                The program number in the request
423
424              rq_vers
425                The program version in the request
426
427              rq_proc
428                The procedure number in the request
429
430              rq_prot
431                The IP protocol of the request
432
433
434       sunrpc.svc.drop
435              Fires when a request is to be dropped
436
437              Arguments
438
439              sv_name
440                The service name
441
442              peer_ip
443                The peer address where the request is from
444
445              rq_xid
446                The transmission id in the request
447
448              rq_prog
449                The program number in the request
450
451              rq_vers
452                The program version in the request
453
454              rq_proc
455                The procedure number in the request
456
457              rq_prot
458                The IP protocol of the request
459
460
461       sunrpc.sched.new_task
462              Fires when a new task is to be created for the specified client
463
464              Arguments xid
465                The transmission id in the RPC call
466
467              prog
468                The program number in the RPC call
469
470              vers
471                The program version in the RPC call
472
473              prot
474                The IP protocol in the RPC call
475
476              tk_flags
477                The flags of the task
478
479
480       sunrpc.sched.release_task
481              Fires  when  all  resources  associated  with  a  task are to be
482              released
483
484              Arguments
485
486              xid
487                The transmission id in the RPC call
488
489              prog
490                The program number in the RPC call
491
492              vers
493                The program version in the RPC call
494
495              prot
496                The IP protocol in the RPC call
497
498              tk_flags
499                The flags of the task
500
501
502       sunrpc.sched.execute
503              Fires when the  RPC  `scheduler'(or  rather,  the  finite  state
504              machine) is to be executed
505
506              Arguments
507
508              xid
509                The transmission id in the RPC call
510
511              prog
512                The program number in the RPC call
513
514              vers
515                The program version in the RPC call
516
517              prot
518                The IP protocol in the RPC call
519
520              tk_pid
521                The debugging id of the task
522
523              tk_flags
524                The flags of the task
525
526
527       sunrpc.sched.delay
528              Fires when a task is to be delayed
529
530              Arguments
531
532              xid
533                The transmission id in the RPC call
534
535              prog
536                The program number in the RPC call
537
538              vers
539                The program version in the RPC call
540
541              prot
542                The IP protocol in the RPC call
543
544              tk_pid
545                The debugging id of the task
546
547              tk_flags
548                The flags of the task
549
550              delay
551                The time delayed
552
553

SEE ALSO

555       stap(1), stapprobes(3stap)
556
557
558
559
560IBM                                                         TAPSET::RPC(3stap)
Impressum