While at it, update the synopsis to include options. Cc: Ingo Molnar <mi...@kernel.org> Cc: Namhyung Kim <namhy...@gmail.com> Cc: Arnaldo Carvalho de Melo <a...@ghostprotocols.net> Cc: David Ahern <dsah...@gmail.com> Signed-off-by: Ramkumar Ramachandra <artag...@gmail.com> --- tools/perf/Documentation/perf-trace.txt | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-)
diff --git a/tools/perf/Documentation/perf-trace.txt b/tools/perf/Documentation/perf-trace.txt index daccd2c..978c6c2 100644 --- a/tools/perf/Documentation/perf-trace.txt +++ b/tools/perf/Documentation/perf-trace.txt @@ -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] -- 1.8.4.477.g5d89aa9 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/