xref: /linux/tools/perf/Documentation/perf-inject.txt (revision b889fcf63cb62e7fdb7816565e28f44dbe4a76a5)
1perf-inject(1)
2==============
3
4NAME
5----
6perf-inject - Filter to augment the events stream with additional information
7
8SYNOPSIS
9--------
10[verse]
11'perf inject <options>'
12
13DESCRIPTION
14-----------
15perf-inject reads a perf-record event stream and repipes it to stdout.  At any
16point the processing code can inject other events into the event stream - in
17this case build-ids (-b option) are read and injected as needed into the event
18stream.
19
20Build-ids are just the first user of perf-inject - potentially anything that
21needs userspace processing to augment the events stream with additional
22information could make use of this facility.
23
24OPTIONS
25-------
26-b::
27--build-ids=::
28        Inject build-ids into the output stream
29-v::
30--verbose::
31	Be more verbose.
32-i::
33--input=::
34	Input file name. (default: stdin)
35-o::
36--output=::
37	Output file name. (default: stdout)
38-s::
39--sched-stat::
40	Merge sched_stat and sched_switch for getting events where and how long
41	tasks slept. sched_switch contains a callchain where a task slept and
42	sched_stat contains a timeslice how long a task slept.
43
44SEE ALSO
45--------
46linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-archive[1]
47