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--all-cpus:: 27 System-wide collection from all CPUs. 28 29-e:: 30--expr:: 31 List of events to show, currently only syscall names. 32 33-o:: 34--output=:: 35 Output file name. 36 37-p:: 38--pid=:: 39 Record events on existing process ID (comma separated list). 40 41--tid=:: 42 Record events on existing thread ID (comma separated list). 43 44--uid=:: 45 Record events in threads owned by uid. Name or number. 46 47--no-inherit:: 48 Child tasks do not inherit counters. 49 50--mmap-pages=:: 51 Number of mmap data pages. Must be a power of two. 52 53--cpu:: 54Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a 55comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 56In per-thread mode with inheritance mode on (default), Events are captured only when 57the thread executes on the designated CPUs. Default is to monitor all CPUs. 58 59--duration: 60 Show only events that had a duration greater than N.M ms. 61 62--sched: 63 Accrue thread runtime and provide a summary at the end of the session. 64 65SEE ALSO 66-------- 67linkperf:perf-record[1], linkperf:perf-script[1] 68