perf_event_open.2: Document the PERF_EVENT_IOC_MODIFY_ATTRIBUTES ioctl

The PERF_EVENT_IOC_MODIFY_ATTRIBUTES ioctl was introduced in
Linux 4.17.  It currently only works on breakpoint events.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Vince Weaver 2018-08-13 16:20:39 +02:00 committed by Michael Kerrisk
parent 06a61b360b
commit 8496491d55
1 changed files with 10 additions and 0 deletions

View File

@ -2943,6 +2943,16 @@ even though the ring-buffer remains empty.
The argument is an unsigned 32-bit integer.
A nonzero value pauses the ring-buffer, while a
zero value resumes the ring-buffer.
.TP
.BR PERF_EVENT_MODIFY_ATTRIBUTES " (since Linux 4.17)"
.\" commit 32ff77e8cc9e66cc4fb38098f64fd54cc8f54573
This allows modifying an existing event without the overhead
of closing and reopening a new event.
Currently this is only supported for breakpoint events.
.IP
The argument is a pointer to a
.I perf_event_attr
structure containing the updated event settings.
.\"
.SS Using prctl(2)
A process can enable or disable all currently open event groups