Debian Codegraph @

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

raw
1 .TH opensnoop-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 opensnoop-nd \- trace process open() with arguments. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B opensnoop-nd.stp
6 .SH DESCRIPTION
7 This traces the open() syscall system-wide, to show which files are being
8 opened, and by who.
9
10 This is a basic version of opensnoop.
11 .SH REQUIREMENTS
12 SystemTap.
13 .SH EXAMPLES
14 .TP
15 Trace all open() syscalls, showing process and file details:
16 #
17 .B opensnoop-nd.stp
18 .SH FIELDS
19 .TP
20 UID
21 User ID.
22 .TP
23 PID
24 Process ID.
25 .TP
26 PPID
27 Parent process ID.
28 .TP
29 COMM
30 Process name.
31 .TP
32 FD
33 Return value of the open() syscall, which is either the resulting file descriptor
34 (positive) or error code (negative).
35 .TP
36 PATH
37 File pathname provided to the open() syscall.
38 .SH OVERHEAD
39 This reads and processes open() events and prints a line of output for each.
40 If your applications perform a high rate of open()s, the overhead of this
41 tool may become noticeable.
42 .SH SOURCE
43 This is from the SystemTap lwtools collection.
44 .IP
45 https://github.com/brendangregg/systemtap-lwtools
46 .PP
47 Also look under the examples directory for a text file containing example
48 usage, output, and commentary for this tool.
49 .SH OS
50 Linux
51 .SH STABILITY
52 Unstable - in development.
53 .SH AUTHOR
54 Brendan Gregg
55 .SH SEE ALSO
56 strace(1)