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=:: 62*27050f53SJiri Olsa Number of mmap data pages (must be a power of two) or size 63*27050f53SJiri Olsa specification with appended unit character - B/K/M/G. The 64*27050f53SJiri Olsa size is rounded up to have nearest pages power of two value. 65514f1c67SArnaldo Carvalho de Melo 66ac9be8eeSDavid Ahern-C:: 67514f1c67SArnaldo Carvalho de Melo--cpu:: 68514f1c67SArnaldo Carvalho de MeloCollect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 69514f1c67SArnaldo Carvalho de Melocomma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 70514f1c67SArnaldo Carvalho de MeloIn per-thread mode with inheritance mode on (default), Events are captured only when 71514f1c67SArnaldo Carvalho de Melothe thread executes on the designated CPUs. Default is to monitor all CPUs. 72514f1c67SArnaldo Carvalho de Melo 73ae9ed035SArnaldo Carvalho de Melo--duration: 74ae9ed035SArnaldo Carvalho de Melo Show only events that had a duration greater than N.M ms. 75ae9ed035SArnaldo Carvalho de Melo 761302d88eSArnaldo Carvalho de Melo--sched: 771302d88eSArnaldo Carvalho de Melo Accrue thread runtime and provide a summary at the end of the session. 781302d88eSArnaldo Carvalho de Melo 796810fc91SDavid Ahern-i 806810fc91SDavid Ahern--input 816810fc91SDavid Ahern Process events from a given perf data file. 826810fc91SDavid Ahern 834bb09192SDavid Ahern-T 844bb09192SDavid Ahern--time 854bb09192SDavid Ahern Print full timestamp rather time relative to first sample. 864bb09192SDavid Ahern 8750c95cbdSArnaldo Carvalho de Melo--comm:: 8850c95cbdSArnaldo Carvalho de Melo Show process COMM right beside its ID, on by default, disable with --no-comm. 8950c95cbdSArnaldo Carvalho de Melo 90514f1c67SArnaldo Carvalho de MeloSEE ALSO 91514f1c67SArnaldo Carvalho de Melo-------- 92514f1c67SArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-script[1] 93