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 26514f1c67SArnaldo Carvalho de Melo--all-cpus:: 27514f1c67SArnaldo Carvalho de Melo System-wide collection from all CPUs. 28514f1c67SArnaldo Carvalho de Melo 292ae3a312SArnaldo Carvalho de Melo-e:: 302ae3a312SArnaldo Carvalho de Melo--expr:: 312ae3a312SArnaldo Carvalho de Melo List of events to show, currently only syscall names. 322ae3a312SArnaldo Carvalho de Melo 33*c24ff998SArnaldo Carvalho de Melo-o:: 34*c24ff998SArnaldo Carvalho de Melo--output=:: 35*c24ff998SArnaldo Carvalho de Melo Output file name. 36*c24ff998SArnaldo Carvalho de Melo 37514f1c67SArnaldo Carvalho de Melo-p:: 38514f1c67SArnaldo Carvalho de Melo--pid=:: 39514f1c67SArnaldo Carvalho de Melo Record events on existing process ID (comma separated list). 40514f1c67SArnaldo Carvalho de Melo 41514f1c67SArnaldo Carvalho de Melo--tid=:: 42514f1c67SArnaldo Carvalho de Melo Record events on existing thread ID (comma separated list). 43514f1c67SArnaldo Carvalho de Melo 44514f1c67SArnaldo Carvalho de Melo--uid=:: 45514f1c67SArnaldo Carvalho de Melo Record events in threads owned by uid. Name or number. 46514f1c67SArnaldo Carvalho de Melo 47514f1c67SArnaldo Carvalho de Melo--no-inherit:: 48514f1c67SArnaldo Carvalho de Melo Child tasks do not inherit counters. 49514f1c67SArnaldo Carvalho de Melo 50514f1c67SArnaldo Carvalho de Melo--mmap-pages=:: 51514f1c67SArnaldo Carvalho de Melo Number of mmap data pages. Must be a power of two. 52514f1c67SArnaldo Carvalho de Melo 53514f1c67SArnaldo Carvalho de Melo--cpu:: 54514f1c67SArnaldo Carvalho de MeloCollect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 55514f1c67SArnaldo Carvalho de Melocomma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 56514f1c67SArnaldo Carvalho de MeloIn per-thread mode with inheritance mode on (default), Events are captured only when 57514f1c67SArnaldo Carvalho de Melothe thread executes on the designated CPUs. Default is to monitor all CPUs. 58514f1c67SArnaldo Carvalho de Melo 59ae9ed035SArnaldo Carvalho de Melo--duration: 60ae9ed035SArnaldo Carvalho de Melo Show only events that had a duration greater than N.M ms. 61ae9ed035SArnaldo Carvalho de Melo 621302d88eSArnaldo Carvalho de Melo--sched: 631302d88eSArnaldo Carvalho de Melo Accrue thread runtime and provide a summary at the end of the session. 641302d88eSArnaldo Carvalho de Melo 65514f1c67SArnaldo Carvalho de MeloSEE ALSO 66514f1c67SArnaldo Carvalho de Melo-------- 67514f1c67SArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-script[1] 68