Home | History | Annotate | Download | only in Documentation
      1 perf-inject(1)
      2 ==============
      3 
      4 NAME
      5 ----
      6 perf-inject - Filter to augment the events stream with additional information
      7 
      8 SYNOPSIS
      9 --------
     10 [verse]
     11 'perf inject <options>'
     12 
     13 DESCRIPTION
     14 -----------
     15 perf-inject reads a perf-record event stream and repipes it to stdout.  At any
     16 point the processing code can inject other events into the event stream - in
     17 this case build-ids (-b option) are read and injected as needed into the event
     18 stream.
     19 
     20 Build-ids are just the first user of perf-inject - potentially anything that
     21 needs userspace processing to augment the events stream with additional
     22 information could make use of this facility.
     23 
     24 OPTIONS
     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 SEE ALSO
     45 --------
     46 linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-archive[1]
     47