Blame - tools/perf/Documentation/perf-trace.txt - kernel/msm-4.19

blob: 7b0497f95a75f0dafdf079742cec136dcff3ffdc [file] [log] [blame]

Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	1	perf-trace(1)
				2	=============
				3
				4	NAME
				5	----
				6	perf-trace - strace inspired tool
				7
				8	SYNOPSIS
				9	--------
				10	[verse]
				11	'perf trace'
David Ahern	5e2485b	2013-09-28 13:13:01 -0600	[diff] [blame]	12	'perf trace record'
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	13
				14	DESCRIPTION
				15	-----------
				16	This command will show the events associated with the target, initially
				17	syscalls, but other system events like pagefaults, task lifetime events,
				18	scheduling events, etc.
				19
David Ahern	5e2485b	2013-09-28 13:13:01 -0600	[diff] [blame]	20	This is a live mode tool in addition to working with perf.data files like
				21	the other perf tools. Files can be generated using the 'perf record' command
				22	but the session needs to include the raw_syscalls events (-e 'raw_syscalls:*').
				23	Alernatively, the 'perf trace record' can be used as a shortcut to
				24	automatically include the raw_syscalls events when writing events to a file.
				25
				26	The following options apply to perf trace; options to perf trace record are
				27	found in the perf record man page.
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	28
				29	OPTIONS
				30	-------
				31
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	32	-a::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	33	--all-cpus::
				34	System-wide collection from all CPUs.
				35
Arnaldo Carvalho de Melo	2ae3a31	2013-08-09 12:28:31 -0300	[diff] [blame]	36	-e::
				37	--expr::
				38	List of events to show, currently only syscall names.
Arnaldo Carvalho de Melo	b059efd	2013-08-21 12:56:21 -0300	[diff] [blame]	39	Prefixing with ! shows all syscalls but the ones specified. You may
				40	need to escape it.
Arnaldo Carvalho de Melo	2ae3a31	2013-08-09 12:28:31 -0300	[diff] [blame]	41
Arnaldo Carvalho de Melo	c24ff99	2013-08-19 12:01:10 -0300	[diff] [blame]	42	-o::
				43	--output=::
				44	Output file name.
				45
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	46	-p::
				47	--pid=::
				48	Record events on existing process ID (comma separated list).
				49
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	50	-t::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	51	--tid=::
				52	Record events on existing thread ID (comma separated list).
				53
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	54	-u::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	55	--uid=::
				56	Record events in threads owned by uid. Name or number.
				57
Arnaldo Carvalho de Melo	7c304ee0	2013-08-22 16:49:54 -0300	[diff] [blame]	58	-v::
				59	--verbose=::
				60	Verbosity level.
				61
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	62	-i::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	63	--no-inherit::
				64	Child tasks do not inherit counters.
				65
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	66	-m::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	67	--mmap-pages=::
Jiri Olsa	27050f5	2013-09-01 12:36:13 +0200	[diff] [blame]	68	Number of mmap data pages (must be a power of two) or size
				69	specification with appended unit character - B/K/M/G. The
				70	size is rounded up to have nearest pages power of two value.
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	71
David Ahern	ac9be8e	2013-08-20 11:15:45 -0600	[diff] [blame]	72	-C::
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	73	--cpu::
				74	Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a
				75	comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
				76	In per-thread mode with inheritance mode on (default), Events are captured only when
				77	the thread executes on the designated CPUs. Default is to monitor all CPUs.
				78
Arnaldo Carvalho de Melo	ae9ed03	2012-10-08 09:56:00 -0300	[diff] [blame]	79	--duration:
				80	Show only events that had a duration greater than N.M ms.
				81
Arnaldo Carvalho de Melo	1302d88	2012-10-17 17:13:12 -0300	[diff] [blame]	82	--sched:
				83	Accrue thread runtime and provide a summary at the end of the session.
				84
David Ahern	6810fc9	2013-08-28 22:29:52 -0600	[diff] [blame]	85	-i
				86	--input
				87	Process events from a given perf data file.
				88
David Ahern	4bb0919	2013-09-04 12:37:43 -0600	[diff] [blame]	89	-T
				90	--time
				91	Print full timestamp rather time relative to first sample.
				92
Arnaldo Carvalho de Melo	50c95cb	2013-09-12 12:35:21 -0300	[diff] [blame]	93	--comm::
				94	Show process COMM right beside its ID, on by default, disable with --no-comm.
				95
David Ahern	bf2575c	2013-10-08 21:26:53 -0600	[diff] [blame]	96	--summary::
				97	Show a summary of syscalls by thread with min, max, and average times (in
				98	msec) and relative stddev.
				99
Arnaldo Carvalho de Melo	c522739	2013-09-27 18:06:19 -0300	[diff] [blame]	100	--tool_stats::
				101	Show tool stats such as number of times fd->pathname was discovered thru
				102	hooking the open syscall return + vfs_getname or via reading /proc/pid/fd, etc.
				103
Arnaldo Carvalho de Melo	514f1c6	2012-09-26 20:05:56 -0300	[diff] [blame]	104	SEE ALSO
				105	--------
				106	linkperf:perf-record[1], linkperf:perf-script[1]