Commit 69abaccd authored by ShelbyFrances's avatar ShelbyFrances

tools: Document use of -I <path> in trace, argdist

parent f5dbbdbb
...@@ -363,6 +363,7 @@ optional arguments: ...@@ -363,6 +363,7 @@ optional arguments:
below) below)
-I header, --include header -I header, --include header
additional header files to include in the BPF program additional header files to include in the BPF program
as either full path, or relative to '/usr/include'
Probe specifier syntax: Probe specifier syntax:
{p,r,t,u}:{[library],category}:function(signature)[:type[,type...]:expr[,expr...][:filter]][#label] {p,r,t,u}:{[library],category}:function(signature)[:type[,type...]:expr[,expr...][:filter]][#label]
......
...@@ -2,8 +2,8 @@ Demonstrations of trace. ...@@ -2,8 +2,8 @@ Demonstrations of trace.
trace probes functions you specify and displays trace messages if a particular trace probes functions you specify and displays trace messages if a particular
condition is met. You can control the message format to display function condition is met. You can control the message format to display function
arguments and return values. arguments and return values.
For example, suppose you want to trace all commands being exec'd across the For example, suppose you want to trace all commands being exec'd across the
system: system:
...@@ -174,8 +174,12 @@ PID TID COMM FUNC - ...@@ -174,8 +174,12 @@ PID TID COMM FUNC -
777 785 automount SyS_nanosleep sleep for 500000000 ns 777 785 automount SyS_nanosleep sleep for 500000000 ns
^C ^C
Remember to use the -I argument include the appropriate header file. We didn't
need to do that here because `struct timespec` is used internally by the tool,
so it always includes this header file.
As a final example, let's trace open syscalls for a specific process. By
As a final example, let's trace open syscalls for a specific process. By
default, tracing is system-wide, but the -p switch overrides this: default, tracing is system-wide, but the -p switch overrides this:
# trace -p 2740 'do_sys_open "%s", arg2' -T # trace -p 2740 'do_sys_open "%s", arg2' -T
...@@ -225,6 +229,7 @@ optional arguments: ...@@ -225,6 +229,7 @@ optional arguments:
-U, --user-stack output user stack trace -U, --user-stack output user stack trace
-I header, --include header -I header, --include header
additional header files to include in the BPF program additional header files to include in the BPF program
as either full path, or relative to '/usr/include'
EXAMPLES: EXAMPLES:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment