perf-trace.txt 1.5 KB

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