1514f1c67SArnaldo Carvalho de Meloperf-trace(1) 2514f1c67SArnaldo Carvalho de Melo============= 3514f1c67SArnaldo Carvalho de Melo 4514f1c67SArnaldo Carvalho de MeloNAME 5514f1c67SArnaldo Carvalho de Melo---- 6514f1c67SArnaldo Carvalho de Meloperf-trace - strace inspired tool 7514f1c67SArnaldo Carvalho de Melo 8514f1c67SArnaldo Carvalho de MeloSYNOPSIS 9514f1c67SArnaldo Carvalho de Melo-------- 10514f1c67SArnaldo Carvalho de Melo[verse] 11514f1c67SArnaldo Carvalho de Melo'perf trace' 12514f1c67SArnaldo Carvalho de Melo 13514f1c67SArnaldo Carvalho de MeloDESCRIPTION 14514f1c67SArnaldo Carvalho de Melo----------- 15514f1c67SArnaldo Carvalho de MeloThis command will show the events associated with the target, initially 16514f1c67SArnaldo Carvalho de Melosyscalls, but other system events like pagefaults, task lifetime events, 17514f1c67SArnaldo Carvalho de Meloscheduling events, etc. 18514f1c67SArnaldo Carvalho de Melo 19514f1c67SArnaldo Carvalho de MeloInitially this is a live mode only tool, but eventually will work with 20514f1c67SArnaldo Carvalho de Meloperf.data files like the other tools, allowing a detached 'record' from 21514f1c67SArnaldo Carvalho de Meloanalysis phases. 22514f1c67SArnaldo Carvalho de Melo 23514f1c67SArnaldo Carvalho de MeloOPTIONS 24514f1c67SArnaldo Carvalho de Melo------- 25514f1c67SArnaldo Carvalho de Melo 26ac9be8eeSDavid Ahern-a:: 27514f1c67SArnaldo Carvalho de Melo--all-cpus:: 28514f1c67SArnaldo Carvalho de Melo System-wide collection from all CPUs. 29514f1c67SArnaldo Carvalho de Melo 302ae3a312SArnaldo Carvalho de Melo-e:: 312ae3a312SArnaldo Carvalho de Melo--expr:: 322ae3a312SArnaldo Carvalho de Melo List of events to show, currently only syscall names. 33b059efdfSArnaldo Carvalho de Melo Prefixing with ! shows all syscalls but the ones specified. You may 34b059efdfSArnaldo Carvalho de Melo need to escape it. 352ae3a312SArnaldo Carvalho de Melo 36c24ff998SArnaldo Carvalho de Melo-o:: 37c24ff998SArnaldo Carvalho de Melo--output=:: 38c24ff998SArnaldo Carvalho de Melo Output file name. 39c24ff998SArnaldo Carvalho de Melo 40514f1c67SArnaldo Carvalho de Melo-p:: 41514f1c67SArnaldo Carvalho de Melo--pid=:: 42514f1c67SArnaldo Carvalho de Melo Record events on existing process ID (comma separated list). 43514f1c67SArnaldo Carvalho de Melo 44ac9be8eeSDavid Ahern-t:: 45514f1c67SArnaldo Carvalho de Melo--tid=:: 46514f1c67SArnaldo Carvalho de Melo Record events on existing thread ID (comma separated list). 47514f1c67SArnaldo Carvalho de Melo 48ac9be8eeSDavid Ahern-u:: 49514f1c67SArnaldo Carvalho de Melo--uid=:: 50514f1c67SArnaldo Carvalho de Melo Record events in threads owned by uid. Name or number. 51514f1c67SArnaldo Carvalho de Melo 527c304ee0SArnaldo Carvalho de Melo-v:: 537c304ee0SArnaldo Carvalho de Melo--verbose=:: 547c304ee0SArnaldo Carvalho de Melo Verbosity level. 557c304ee0SArnaldo Carvalho de Melo 56ac9be8eeSDavid Ahern-i:: 57514f1c67SArnaldo Carvalho de Melo--no-inherit:: 58514f1c67SArnaldo Carvalho de Melo Child tasks do not inherit counters. 59514f1c67SArnaldo Carvalho de Melo 60ac9be8eeSDavid Ahern-m:: 61514f1c67SArnaldo Carvalho de Melo--mmap-pages=:: 62514f1c67SArnaldo Carvalho de Melo Number of mmap data pages. Must be a power of two. 63514f1c67SArnaldo Carvalho de Melo 64ac9be8eeSDavid Ahern-C:: 65514f1c67SArnaldo Carvalho de Melo--cpu:: 66514f1c67SArnaldo Carvalho de MeloCollect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 67514f1c67SArnaldo Carvalho de Melocomma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 68514f1c67SArnaldo Carvalho de MeloIn per-thread mode with inheritance mode on (default), Events are captured only when 69514f1c67SArnaldo Carvalho de Melothe thread executes on the designated CPUs. Default is to monitor all CPUs. 70514f1c67SArnaldo Carvalho de Melo 71ae9ed035SArnaldo Carvalho de Melo--duration: 72ae9ed035SArnaldo Carvalho de Melo Show only events that had a duration greater than N.M ms. 73ae9ed035SArnaldo Carvalho de Melo 741302d88eSArnaldo Carvalho de Melo--sched: 751302d88eSArnaldo Carvalho de Melo Accrue thread runtime and provide a summary at the end of the session. 761302d88eSArnaldo Carvalho de Melo 776810fc91SDavid Ahern-i 786810fc91SDavid Ahern--input 796810fc91SDavid Ahern Process events from a given perf data file. 806810fc91SDavid Ahern 814bb09192SDavid Ahern-T 824bb09192SDavid Ahern--time 834bb09192SDavid Ahern Print full timestamp rather time relative to first sample. 844bb09192SDavid Ahern 85*50c95cbdSArnaldo Carvalho de Melo--comm:: 86*50c95cbdSArnaldo Carvalho de Melo Show process COMM right beside its ID, on by default, disable with --no-comm. 87*50c95cbdSArnaldo Carvalho de Melo 88514f1c67SArnaldo Carvalho de MeloSEE ALSO 89514f1c67SArnaldo Carvalho de Melo-------- 90514f1c67SArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-script[1] 91