perf_event_open.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-14 12:46:12 +02:00
parent 974cb9565b
commit dc9ec146ab
1 changed files with 16 additions and 11 deletions

View File

@ -240,7 +240,8 @@ struct perf_event_attr {
exclude_callchain_user : 1,
/* exclude user callchains */
mmap2 : 1, /* include mmap with inode data */
comm_exec : 1, /* flag comm events that are due to exec */
comm_exec : 1, /* flag comm events that are
due to exec */
use_clockid : 1, /* use clockid for time fields */
__reserved_1 : 38;
@ -983,20 +984,16 @@ with how small this can be.
The values of this are the following:
.RS
.TP
0 -
.IP 0 3
.B SAMPLE_IP
can have arbitrary skid.
.TP
1 -
.IP 1
.B SAMPLE_IP
must have constant skid.
.TP
2 -
.IP 2
.B SAMPLE_IP
requested to have 0 skid.
.TP
3 -
.IP 3
.B SAMPLE_IP
must have 0 skid.
See also
@ -1034,6 +1031,7 @@ This may lead to the
value appearing twice.
The layout is described by this pseudo-structure:
.in +4n
.nf
struct sample_id {
@ -2004,7 +2002,8 @@ struct {
/* if PERF_SAMPLE_REGS_USER */
u64 size; /* if PERF_SAMPLE_STACK_USER */
char data[size]; /* if PERF_SAMPLE_STACK_USER */
u64 dyn_size; /* if PERF_SAMPLE_STACK_USER && size != 0 */
u64 dyn_size; /* if PERF_SAMPLE_STACK_USER &&
size != 0 */
u64 weight; /* if PERF_SAMPLE_WEIGHT */
u64 data_src; /* if PERF_SAMPLE_DATA_SRC */
u64 transaction;/* if PERF_SAMPLE_TRANSACTION */
@ -2756,6 +2755,7 @@ process has created on other processes.
It enables or disables only
the group leaders, not any other members in the groups.
.SS perf_event related configuration files
Files in
.I /proc/sys/kernel/
.RS 4
@ -2764,6 +2764,8 @@ Files in
The
.I perf_event_paranoid
file can be set to restrict access to the performance counters.
.PD 0
.RS
.IP 2 4
allow only user-space measurements (default since Linux 4.6).
@ -2775,6 +2777,7 @@ allow access to CPU-specific data but not raw tracepoint samples.
.IP \-1
no restrictions.
.RE
.PD
.IP
The existence of the
.I perf_event_paranoid
@ -2799,8 +2802,10 @@ Maximum number of pages an unprivileged user can
.BR mlock (2).
The default is 516 (kB).
.RE
Files in
.I /sys/bus/event_source/devices/
.RS 4
Since Linux 2.6.34, the kernel supports having multiple PMUs
available for monitoring.
@ -3047,7 +3052,7 @@ It was renamed in Linux 2.6.32.
.SH CONFORMING TO
This
.BR perf_event_open ()
system call Linux- specific
system call Linux-specific
and should not be used in programs intended to be portable.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using