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 26*ac9be8eeSDavid 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. 332ae3a312SArnaldo Carvalho de Melo 34c24ff998SArnaldo Carvalho de Melo-o:: 35c24ff998SArnaldo Carvalho de Melo--output=:: 36c24ff998SArnaldo Carvalho de Melo Output file name. 37c24ff998SArnaldo Carvalho de Melo 38514f1c67SArnaldo Carvalho de Melo-p:: 39514f1c67SArnaldo Carvalho de Melo--pid=:: 40514f1c67SArnaldo Carvalho de Melo Record events on existing process ID (comma separated list). 41514f1c67SArnaldo Carvalho de Melo 42*ac9be8eeSDavid Ahern-t:: 43514f1c67SArnaldo Carvalho de Melo--tid=:: 44514f1c67SArnaldo Carvalho de Melo Record events on existing thread ID (comma separated list). 45514f1c67SArnaldo Carvalho de Melo 46*ac9be8eeSDavid Ahern-u:: 47514f1c67SArnaldo Carvalho de Melo--uid=:: 48514f1c67SArnaldo Carvalho de Melo Record events in threads owned by uid. Name or number. 49514f1c67SArnaldo Carvalho de Melo 50*ac9be8eeSDavid Ahern-i:: 51514f1c67SArnaldo Carvalho de Melo--no-inherit:: 52514f1c67SArnaldo Carvalho de Melo Child tasks do not inherit counters. 53514f1c67SArnaldo Carvalho de Melo 54*ac9be8eeSDavid Ahern-m:: 55514f1c67SArnaldo Carvalho de Melo--mmap-pages=:: 56514f1c67SArnaldo Carvalho de Melo Number of mmap data pages. Must be a power of two. 57514f1c67SArnaldo Carvalho de Melo 58*ac9be8eeSDavid Ahern-C:: 59514f1c67SArnaldo Carvalho de Melo--cpu:: 60514f1c67SArnaldo Carvalho de MeloCollect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 61514f1c67SArnaldo Carvalho de Melocomma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 62514f1c67SArnaldo Carvalho de MeloIn per-thread mode with inheritance mode on (default), Events are captured only when 63514f1c67SArnaldo Carvalho de Melothe thread executes on the designated CPUs. Default is to monitor all CPUs. 64514f1c67SArnaldo Carvalho de Melo 65ae9ed035SArnaldo Carvalho de Melo--duration: 66ae9ed035SArnaldo Carvalho de Melo Show only events that had a duration greater than N.M ms. 67ae9ed035SArnaldo Carvalho de Melo 681302d88eSArnaldo Carvalho de Melo--sched: 691302d88eSArnaldo Carvalho de Melo Accrue thread runtime and provide a summary at the end of the session. 701302d88eSArnaldo Carvalho de Melo 71514f1c67SArnaldo Carvalho de MeloSEE ALSO 72514f1c67SArnaldo Carvalho de Melo-------- 73514f1c67SArnaldo Carvalho de Melolinkperf:perf-record[1], linkperf:perf-script[1] 74