perf-trace.txt 1.7 KB

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