Debian Codegraph @

EXAMPLES/lwtools/accept2close-nd.8

raw
1 .TH accept2close-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 accept2close-nd \- trace process signals. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B accept2close-nd.stp
6 [min_ms]
7 .SH DESCRIPTION
8 This traces socket duration from the accept() syscall to close(), and provides
9 details on the lifespan of these passive connections.
10
11 NOTE: This will miss sockets that are opened by one process, and then closed
12 by another (eg, sshd).
13 .SH REQUIREMENTS
14 SystemTap.
15 .SH OPTIONS
16 .TP
17 min_ms
18 Minimum lifespan threshold, in milliseconds. This is an optional argument that
19 can be used to focus on outliers.
20 .SH EXAMPLES
21 .TP
22 Trace all passive socket connections, and show event details and a summary:
23 #
24 .B accept2close-nd.stp
25 .TP
26 Trace all passive socket connections equal to or slower than 5 milliseconds:
27 #
28 .B accept2close-nd.stp 5
29 .SH FIELDS
30 .TP
31 TIME
32 Time of socket close, human readable.
33 .TP
34 PID
35 Server process ID
36 .TP
37 COMM
38 Server process name.
39 .TP
40 FD
41 File descriptor for socket.
42 .TP
43 DURATION
44 Duration of socket connection (lifespan), in milliseconds.
45 .SH OVERHEAD
46 Should be low. Test first.
47 .SH SOURCE
48 This is from the SystemTap lwtools collection.
49 .IP
50 https://github.com/brendangregg/systemtap-lwtools
51 .PP
52 Also look under the examples directory for a text file containing example
53 usage, output, and commentary for this tool.
54 .SH OS
55 Linux
56 .SH STABILITY
57 Unstable - in development.
58 .SH AUTHOR
59 Brendan Gregg
60 .SH SEE ALSO
61 strace(1)