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 44--kallsyms=<file>:: 45 kallsyms pathname 46 47--itrace:: 48 Decode Instruction Tracing data, replacing it with synthesized events. 49 Options are: 50 51include::itrace.txt[] 52 53--strip:: 54 Use with --itrace to strip out non-synthesized events. 55 56SEE ALSO 57-------- 58linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-archive[1] 59