table of contents
other versions
- wheezy-backports 3.16.7-ckt20-1~bpo70+2
- jessie 3.16.7-ckt20-1
PERF_3.16-TRACE(1) | perf Manual | PERF_3.16-TRACE(1) |
NAME¶
perf-trace - strace inspired toolSYNOPSIS¶
perf trace perf trace record
DESCRIPTION¶
This command will show the events associated with the target, initially syscalls, but other system events like pagefaults, task lifetime events, scheduling events, etc.OPTIONS¶
-a, --all-cpusSystem-wide collection from all CPUs.
-e, --expr
List of events to show, currently only syscall
names. Prefixing with ! shows all syscalls but the ones specified. You may
need to escape it.
-o, --output=
Output file name.
-p, --pid=
Record events on existing process ID (comma
separated list).
-t, --tid=
Record events on existing thread ID (comma
separated list).
-u, --uid=
Record events in threads owned by uid. Name or
number.
-v, --verbose=
Verbosity level.
-i, --no-inherit
Child tasks do not inherit counters.
-m, --mmap-pages=
Number of mmap data pages (must be a power of
two) or size specification with appended unit character - B/K/M/G. The size is
rounded up to have nearest pages power of two value.
-C, --cpu
Collect samples only on the list of CPUs
provided. Multiple CPUs can be provided as a comma-separated list with no
space: 0,1. Ranges of CPUs are specified with -: 0-2. In per-thread mode with
inheritance mode on (default), Events are captured only when the thread
executes on the designated CPUs. Default is to monitor all CPUs.
Show process COMM right beside its ID, on by
default, disable with --no-comm.
-s, --summary
Show only a summary of syscalls by thread with
min, max, and average times (in msec) and relative stddev.
-S, --with-summary
Show all syscalls followed by a summary by
thread with min, max, and average times (in msec) and relative stddev.
--tool_stats
Show tool stats such as number of times
fd→pathname was discovered thru hooking the open syscall return +
vfs_getname or via reading /proc/pid/fd, etc.
SEE ALSO¶
perf_3.16-record(1), perf_3.16-script(1)02/24/2016 | perf |