perf_event_open.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
David Prévot 2013-11-17 15:38:44 -04:00 committed by Michael Kerrisk
parent 27f52b5209
commit 8859d3a9e2
1 changed files with 14 additions and 5 deletions

View File

@ -654,7 +654,8 @@ Records a unique ID for the opened event.
Unlike
.B PERF_SAMPLE_ID
the actual ID is returned, not the group leader.
This ID is the same as the one returned by PERF_FORMAT_ID.
This ID is the same as the one returned by
.BR PERF_FORMAT_ID .
.TP
.B PERF_SAMPLE_RAW
Records additional data, if applicable.
@ -689,7 +690,9 @@ This is only available if the underlying hardware
supports this feature.
.TP
.BR PERF_SAMPLE_IDENTIFIER " (Since Linux 3.12)"
Places the SAMPLE_ID value in a fixed position in the record,
Places the
.B SAMPLE_ID
value in a fixed position in the record,
either at the beginning (for sample events) or at the end
(if a non-sample event).
@ -698,7 +701,9 @@ records from various different event sources with different
.I sample_type
settings.
Parsing the event stream properly was not possible because the
format of the record was needed to find SAMPLE_ID, but
format of the record was needed to find
.BR SAMPLE_ID ,
but
the format could not be found without knowing what
event the sample belonged to (causing a circular
dependency).
@ -706,8 +711,12 @@ dependency).
This new
.B PERF_SAMPLE_IDENTIFIER
setting makes the event stream always parsable
by putting SAMPLE_ID in a fixed location, even though
it means having duplicate SAMPLE_ID values in records.
by putting
.B SAMPLE_ID
in a fixed location, even though
it means having duplicate
.B SAMPLE_ID
values in records.
.RE
.TP
.IR "read_format"