Debian Codegraph @

testsuite/systemtap.examples/lwtools/rwtime-nd.8

raw
1 .TH rwtime-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 rwtime-nd \- summarize syscall read() and write() times. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B rwtime-nd.stp
6 [execname]
7 .SH DESCRIPTION
8 This traces read() and write() syscalls, producing a histogram summary of their
9 durations (aka latencies).
10 .SH REQUIREMENTS
11 SystemTap.
12 .SH OPTIONS
13 .TP
14 execname
15 An optional argument to specify the process name to trace. All PIDs with this
16 process name will be observed.
17 .SH EXAMPLES
18 .TP
19 Trace all syscall read()s and write()s, showing latency summaries:
20 #
21 .B rwtime-nd.stp
22 .TP
23 Trace all syscall read()s and write()s for processes named "node":
24 .B rwtime-nd.stp
25 node
26 .SH OVERHEAD
27 While these syscalls are frequent, the overhead should be low as this uses
28 in-kernel summaries. Test before use to confirm.
29 .SH SOURCE
30 This is from the SystemTap lwtools collection.
31 .IP
32 https://github.com/brendangregg/systemtap-lwtools
33 .PP
34 Also look under the examples directory for a text file containing example
35 usage, output, and commentary for this tool.
36 .SH OS
37 Linux
38 .SH STABILITY
39 Unstable - in development.
40 .SH AUTHOR
41 Brendan Gregg
42 .SH SEE ALSO
43 strace(1)