perf_event_open.2: Update description for mmap_data bit

Here's an updated version of [David Ahern's] patch that
expands the "mmap" definition as well as that of "mmap_data".
Also some manpage related formatting improvements from the
original patch.

Link: https://lkml.org/lkml/2013/11/11/505

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Acked-by: David Ahern <dsahern@gmail.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Vince Weaver 2013-11-13 12:59:33 -05:00 committed by Michael Kerrisk
parent a02a1737af
commit 75ee11e514
1 changed files with 18 additions and 3 deletions

View File

@ -796,7 +796,16 @@ If set, don't count when the CPU is idle.
.IR "mmap"
The
.I mmap
bit enables recording of exec mmap events.
bit enables generation of
.I PERF_RECORD_MMAP
samples for every
.BR mmap (2)
call that has
.I PROT_EXEC
set.
This allows tools to notice new executable code being mapped into
a program (dynamic shared libraries for example)
so that addresses can be mapped back to the original code.
.TP
.IR "comm"
The
@ -875,8 +884,14 @@ See also
.IR "mmap_data" " (Since Linux 2.6.36)"
The counterpart of the
.I mmap
field, but enables including data mmap events
in the ring-buffer.
field.
This enables generation of
.I PERF_RECORD_MMAP
samples for
.BR mmap (2)
calls that do not have
.I PROT_EXEC
set (for example data and SysV shared memory).
.TP
.IR "sample_id_all" " (Since Linux 2.6.38)"
If set, then TID, TIME, ID, STREAM_ID, and CPU can