perf tool: add example to perf-trace documentation
PATCH v2 1/1 perf tool: add example to perf-trace documentation
While at it, update the synopsis to include options.
Cc Ingo Molnar <[email protected]>
Cc Namhyung Kim <[email protected]>
Cc Arnaldo Carvalho de Melo <[email protected]>
Cc David Ahern <[email protected]>
Signed-off-by Ramkumar Ramachandra <[email protected]>
--- tools/perf/Documentation/perf-trace.txt | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-)
tools/perf/Documentation/perf-trace.txt +28 -1
@@ -8,7 +8,7 @@ perf-trace - strace inspired tool SYNOPSIS -------- [verse] -'perf trace' +'perf trace' [<options>] DESCRIPTION -----------
@@ -78,6 +78,33 @@ the thread executes on the designated CPUs. Default is to monitor all CPUs. --input Process events from a given perf data file. +EXAMPLES +-------- + +$ perf trace -a -e mmap git status + + 0.791 ( 0.003 ms): 32657 mmap(addr: 0, len: 121652, prot: READ, flags: PRIVATE, fd: 3, off: 0 ) = 0xa7659000 + 0.814 ( 0.002 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7658000 + 0.820 ( 0.003 ms): 32657 mmap(addr: 0, len: 2380712, prot: EXEC|READ, flags: PRIVATE|DENYWRITE, fd: 3, off: 0) = 0xa7212000 + 0.830 ( 0.004 ms): 32657 mmap(addr: 0x7f7ca744e000, len: 32768, prot: READ|WRITE, flags: PRIVATE|DENYWRITE|FIXED, fd: 3, off: 245760) = 0xa744e000 + 0.836 ( 0.002 ms): 32657 mmap(addr: 0x7f7ca7456000, len: 5032, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS|FIXED, fd: 4294967295, off: 0) = 0xa7456000 + 0.862 ( 0.003 ms): 32657 mmap(addr: 0, len: 2484168, prot: EXEC|READ, flags: PRIVATE|DENYWRITE, fd: 3, off: 0) = 0xa6fb3000 + 0.870 ( 0.003 ms): 32657 mmap(addr: 0x7f7ca720c000, len: 24576, prot: READ|WRITE, flags: PRIVATE|DENYWRITE|FIXED, fd: 3, off: 364544) = 0xa720c000 + 0.899 ( 0.003 ms): 32657 mmap(addr: 0, len: 2109712, prot: EXEC|READ, flags: PRIVATE|DENYWRITE, fd: 3, off: 0) = 0xa6daf000 + 0.909 ( 0.004 ms): 32657 mmap(addr: 0x7f7ca6fb1000, len: 8192, prot: READ|WRITE, flags: PRIVATE|DENYWRITE|FIXED, fd: 3, off: 8192) = 0xa6fb1000 + 0.934 ( 0.002 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7657000 + 0.940 ( 0.003 ms): 32657 mmap(addr: 0, len: 3844624, prot: EXEC|READ, flags: PRIVATE|DENYWRITE, fd: 3, off: 0) = 0xa6a04000 + 0.951 ( 0.004 ms): 32657 mmap(addr: 0x7f7ca6da5000, len: 24576, prot: READ|WRITE, flags: PRIVATE|DENYWRITE|FIXED, fd: 3, off: 1708032) = 0xa6da5000 + 0.957 ( 0.002 ms): 32657 mmap(addr: 0x7f7ca6dab000, len: 14864, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS|FIXED, fd: 4294967295, off: 0) = 0xa6dab000 + 0.977 ( 0.002 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7656000 + 0.981 ( 0.001 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7655000 + 0.985 ( 0.001 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7654000 + 0.936 ( 0.003 ms): 32655 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xb7192000 + 1.327 ( 0.004 ms): 32657 mmap(addr: 0, len: 1607632, prot: READ, flags: PRIVATE, fd: 3, off: 0 ) = 0xa74cb000 + 1.401 ( 0.002 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7676000 + 1.545 ( 0.002 ms): 32657 mmap(addr: 0, len: 4096, prot: READ|WRITE, flags: PRIVATE|ANONYMOUS, fd: 4294967295, off: 0) = 0xa7676000 + + SEE ALSO -------- linkperf:perf-record[1], linkperf:perf-script[1]
Signature · 1 line
1.8.4.477.g5d89aa9