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 29*2ae3a312SArnaldo Carvalho de Melo-e:: 30*2ae3a312SArnaldo Carvalho de Melo--expr:: 31*2ae3a312SArnaldo Carvalho de Melo List of events to show, currently only syscall names. 32*2ae3a312SArnaldo Carvalho de Melo 33514f1c67SArnaldo Carvalho de Melo-p:: 34514f1c67SArnaldo Carvalho de Melo--pid=:: 35514f1c67SArnaldo Carvalho de Melo Record events on existing process ID (comma separated list). 36514f1c67SArnaldo Carvalho de Melo 37514f1c67SArnaldo Carvalho de Melo--tid=:: 38514f1c67SArnaldo Carvalho de Melo Record events on existing thread ID (comma separated list). 39514f1c67SArnaldo Carvalho de Melo 40514f1c67SArnaldo Carvalho de Melo--uid=:: 41514f1c67SArnaldo Carvalho de Melo Record events in threads owned by uid. Name or number. 42514f1c67SArnaldo Carvalho de Melo 43514f1c67SArnaldo Carvalho de Melo--no-inherit:: 44514f1c67SArnaldo Carvalho de Melo Child tasks do not inherit counters. 45514f1c67SArnaldo Carvalho de Melo 46514f1c67SArnaldo Carvalho de Melo--mmap-pages=:: 47514f1c67SArnaldo Carvalho de Melo Number of mmap data pages. Must be a power of two. 48514f1c67SArnaldo Carvalho de Melo 49514f1c67SArnaldo Carvalho de Melo--cpu:: 50514f1c67SArnaldo Carvalho de MeloCollect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 51514f1c67SArnaldo Carvalho de Melocomma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 52514f1c67SArnaldo Carvalho de MeloIn per-thread mode with inheritance mode on (default), Events are captured only when 53514f1c67SArnaldo Carvalho de Melothe thread executes on the designated CPUs. Default is to monitor all CPUs. 54514f1c67SArnaldo Carvalho de Melo 55ae9ed035SArnaldo Carvalho de Melo--duration: 56ae9ed035SArnaldo Carvalho de Melo Show only events that had a duration greater than N.M ms. 57ae9ed035SArnaldo Carvalho de Melo 581302d88eSArnaldo Carvalho de Melo--sched: 591302d88eSArnaldo Carvalho de Melo Accrue thread runtime and provide a summary at the end of the session. 601302d88eSArnaldo Carvalho de Melo 61514f1c67SArnaldo Carvalho de MeloSEE ALSO 62514f1c67SArnaldo Carvalho de Melo-------- 63514f1c67SArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-script[1] 64