111d232ecSArnaldo Carvalho de Meloperf-inject(1) 211d232ecSArnaldo Carvalho de Melo============== 311d232ecSArnaldo Carvalho de Melo 411d232ecSArnaldo Carvalho de MeloNAME 511d232ecSArnaldo Carvalho de Melo---- 611d232ecSArnaldo Carvalho de Meloperf-inject - Filter to augment the events stream with additional information 711d232ecSArnaldo Carvalho de Melo 811d232ecSArnaldo Carvalho de MeloSYNOPSIS 911d232ecSArnaldo Carvalho de Melo-------- 1011d232ecSArnaldo Carvalho de Melo[verse] 1111d232ecSArnaldo Carvalho de Melo'perf inject <options>' 1211d232ecSArnaldo Carvalho de Melo 1311d232ecSArnaldo Carvalho de MeloDESCRIPTION 1411d232ecSArnaldo Carvalho de Melo----------- 1511d232ecSArnaldo Carvalho de Meloperf-inject reads a perf-record event stream and repipes it to stdout. At any 1611d232ecSArnaldo Carvalho de Melopoint the processing code can inject other events into the event stream - in 1711d232ecSArnaldo Carvalho de Melothis case build-ids (-b option) are read and injected as needed into the event 1811d232ecSArnaldo Carvalho de Melostream. 1911d232ecSArnaldo Carvalho de Melo 2011d232ecSArnaldo Carvalho de MeloBuild-ids are just the first user of perf-inject - potentially anything that 2111d232ecSArnaldo Carvalho de Meloneeds userspace processing to augment the events stream with additional 2211d232ecSArnaldo Carvalho de Meloinformation could make use of this facility. 2311d232ecSArnaldo Carvalho de Melo 2411d232ecSArnaldo Carvalho de MeloOPTIONS 2511d232ecSArnaldo Carvalho de Melo------- 2611d232ecSArnaldo Carvalho de Melo-b:: 2711d232ecSArnaldo Carvalho de Melo--build-ids=:: 2811d232ecSArnaldo Carvalho de Melo Inject build-ids into the output stream 2911d232ecSArnaldo Carvalho de Melo-v:: 3011d232ecSArnaldo Carvalho de Melo--verbose:: 3111d232ecSArnaldo Carvalho de Melo Be more verbose. 32e558a5bdSAndrew Vagin-i:: 33e558a5bdSAndrew Vagin--input=:: 34e558a5bdSAndrew Vagin Input file name. (default: stdin) 35e558a5bdSAndrew Vagin-o:: 36e558a5bdSAndrew Vagin--output=:: 37e558a5bdSAndrew Vagin Output file name. (default: stdout) 3826a031e1SAndrew Vagin-s:: 3926a031e1SAndrew Vagin--sched-stat:: 4026a031e1SAndrew Vagin Merge sched_stat and sched_switch for getting events where and how long 4126a031e1SAndrew Vagin tasks slept. sched_switch contains a callchain where a task slept and 4226a031e1SAndrew Vagin sched_stat contains a timeslice how long a task slept. 4311d232ecSArnaldo Carvalho de Melo 44a7a2b8b4SAdrian Hunter--kallsyms=<file>:: 45a7a2b8b4SAdrian Hunter kallsyms pathname 46a7a2b8b4SAdrian Hunter 470f0aa5e0SAdrian Hunter--itrace:: 480f0aa5e0SAdrian Hunter Decode Instruction Tracing data, replacing it with synthesized events. 490f0aa5e0SAdrian Hunter Options are: 500f0aa5e0SAdrian Hunter 5160b88d87SAdrian Hunterinclude::itrace.txt[] 520f0aa5e0SAdrian Hunter 53f56fb986SAdrian Hunter--strip:: 54f56fb986SAdrian Hunter Use with --itrace to strip out non-synthesized events. 55f56fb986SAdrian Hunter 569b07e27fSStephane Eranian-j:: 579b07e27fSStephane Eranian--jit:: 589b07e27fSStephane Eranian Process jitdump files by injecting the mmap records corresponding to jitted 599b07e27fSStephane Eranian functions. This option also generates the ELF images for each jitted function 609b07e27fSStephane Eranian found in the jitdumps files captured in the input perf.data file. Use this option 619b07e27fSStephane Eranian if you are monitoring environment using JIT runtimes, such as Java, DART or V8. 629b07e27fSStephane Eranian 6352186b8aSSihyeon Jang-f:: 6452186b8aSSihyeon Jang--force:: 6552186b8aSSihyeon Jang Don't complain, do it. 6652186b8aSSihyeon Jang 6711d232ecSArnaldo Carvalho de MeloSEE ALSO 6811d232ecSArnaldo Carvalho de Melo-------- 6911d232ecSArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-archive[1] 70