Gitiles
Code Review Sign In
gerrit-public.fairphone.software / kernel / msm-4.9 / 50c95cbd70808aa2e5ba8d79e503456f1da37aeb / . / tools / perf / Documentation / perf-trace.txt
blob: 37773854d5c49ca7acf7e0e8ed6f4ebf2433b1b9 [file] [log] [blame]
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]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
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]26-a::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]27--all-cpus::
28 System-wide collection from all CPUs.
29
Arnaldo Carvalho de Melo2ae3a312013-08-09 12:28:31 -0300[diff] [blame]30-e::
31--expr::
32 List of events to show, currently only syscall names.
Arnaldo Carvalho de Melob059efd2013-08-21 12:56:21 -0300[diff] [blame]33 Prefixing with ! shows all syscalls but the ones specified. You may
34 need to escape it.
Arnaldo Carvalho de Melo2ae3a312013-08-09 12:28:31 -0300[diff] [blame]35
Arnaldo Carvalho de Meloc24ff992013-08-19 12:01:10 -0300[diff] [blame]36-o::
37--output=::
38 Output file name.
39
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]40-p::
41--pid=::
42 Record events on existing process ID (comma separated list).
43
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]44-t::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]45--tid=::
46 Record events on existing thread ID (comma separated list).
47
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]48-u::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]49--uid=::
50 Record events in threads owned by uid. Name or number.
51
Arnaldo Carvalho de Melo7c304ee02013-08-22 16:49:54 -0300[diff] [blame]52-v::
53--verbose=::
54 Verbosity level.
55
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]56-i::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]57--no-inherit::
58 Child tasks do not inherit counters.
59
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]60-m::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]61--mmap-pages=::
62 Number of mmap data pages. Must be a power of two.
63
David Ahernac9be8e2013-08-20 11:15:45 -0600[diff] [blame]64-C::
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]65--cpu::
66Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a
67comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
68In per-thread mode with inheritance mode on (default), Events are captured only when
69the thread executes on the designated CPUs. Default is to monitor all CPUs.
70
Arnaldo Carvalho de Meloae9ed032012-10-08 09:56:00 -0300[diff] [blame]71--duration:
72 Show only events that had a duration greater than N.M ms.
73
Arnaldo Carvalho de Melo1302d882012-10-17 17:13:12 -0300[diff] [blame]74--sched:
75 Accrue thread runtime and provide a summary at the end of the session.
76
David Ahern6810fc92013-08-28 22:29:52 -0600[diff] [blame]77-i
78--input
79 Process events from a given perf data file.
80
David Ahern4bb09192013-09-04 12:37:43 -0600[diff] [blame]81-T
82--time
83 Print full timestamp rather time relative to first sample.
84
Arnaldo Carvalho de Melo50c95cb2013-09-12 12:35:21 -0300[diff] [blame^]85--comm::
86 Show process COMM right beside its ID, on by default, disable with --no-comm.
87
Arnaldo Carvalho de Melo514f1c62012-09-26 20:05:56 -0300[diff] [blame]88SEE ALSO
89--------
90linkperf:perf-record[1], linkperf:perf-script[1]