1perf-trace(1) 2============= 3 4NAME 5---- 6perf-trace - strace inspired tool 7 8SYNOPSIS 9-------- 10[verse] 11'perf trace' 12 13DESCRIPTION 14----------- 15This command will show the events associated with the target, initially 16syscalls, but other system events like pagefaults, task lifetime events, 17scheduling events, etc. 18 19Initially this is a live mode only tool, but eventually will work with 20perf.data files like the other tools, allowing a detached 'record' from 21analysis phases. 22 23OPTIONS 24------- 25 26-a:: 27--all-cpus:: 28 System-wide collection from all CPUs. 29 30-e:: 31--expr:: 32 List of events to show, currently only syscall names. 33 Prefixing with ! shows all syscalls but the ones specified. You may 34 need to escape it. 35 36-o:: 37--output=:: 38 Output file name. 39 40-p:: 41--pid=:: 42 Record events on existing process ID (comma separated list). 43 44-t:: 45--tid=:: 46 Record events on existing thread ID (comma separated list). 47 48-u:: 49--uid=:: 50 Record events in threads owned by uid. Name or number. 51 52-i:: 53--no-inherit:: 54 Child tasks do not inherit counters. 55 56-m:: 57--mmap-pages=:: 58 Number of mmap data pages. Must be a power of two. 59 60-C:: 61--cpu:: 62Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 63comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 64In per-thread mode with inheritance mode on (default), Events are captured only when 65the thread executes on the designated CPUs. Default is to monitor all CPUs. 66 67--duration: 68 Show only events that had a duration greater than N.M ms. 69 70--sched: 71 Accrue thread runtime and provide a summary at the end of the session. 72 73SEE ALSO 74-------- 75linkperf:perf-record[1], linkperf:perf-script[1] 76