1perf-trace(1)
2=============
3
4NAME
5----
6perf-trace - strace inspired tool
7
8SYNOPSIS
9--------
10[verse]
11'perf trace'
12
13DESCRIPTION
14-----------
15This command will show the events associated with the target, initially
16syscalls, but other system events like pagefaults, task lifetime events,
17scheduling events, etc.
18
19Initially this is a live mode only tool, but eventually will work with
20perf.data files like the other tools, allowing a detached 'record' from
21analysis phases.
22
23OPTIONS
24-------
25
26--all-cpus::
27        System-wide collection from all CPUs.
28
29-p::
30--pid=::
31	Record events on existing process ID (comma separated list).
32
33--tid=::
34        Record events on existing thread ID (comma separated list).
35
36--uid=::
37        Record events in threads owned by uid. Name or number.
38
39--no-inherit::
40	Child tasks do not inherit counters.
41
42--mmap-pages=::
43	Number of mmap data pages. Must be a power of two.
44
45--cpu::
46Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a
47comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
48In per-thread mode with inheritance mode on (default), Events are captured only when
49the thread executes on the designated CPUs. Default is to monitor all CPUs.
50
51--duration:
52	Show only events that had a duration greater than N.M ms.
53
54--sched:
55	Accrue thread runtime and provide a summary at the end of the session.
56
57SEE ALSO
58--------
59linkperf:perf-record[1], linkperf:perf-script[1]
60