2015-04-16 18:13:35

by Vince Weaver

[permalink] [raw]
Subject: [patch 08/10] perf_event_open.2: 4.1 add aux_watermark


This manpage patch relates to the addition of the aux_watermark attr
field in the following commit:

commit 1a5941312414c71dece6717da9a0fa1303127afa
Author: Alexander Shishkin <[email protected]>

perf: Add wakeup watermark control to the AUX area

Signed-off-by: Alexander Shishkin <[email protected]>
Signed-off-by: Peter Zijlstra (Intel) <[email protected]>
Cc: Borislav Petkov <[email protected]>
Cc: Frederic Weisbecker <[email protected]>
Cc: H. Peter Anvin <[email protected]>
Cc: Kaixu Xia <[email protected]>
Cc: Linus Torvalds <[email protected]>
Cc: Mike Galbraith <[email protected]>
Cc: Paul Mackerras <[email protected]>
Cc: Robert Richter <[email protected]>
Cc: Stephane Eranian <[email protected]>
Cc: Thomas Gleixner <[email protected]>
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Link: http://lkml.kernel.org/r/1421237903-181015-10-git-send-email-alexander.shishkin@linux.intel.com
Signed-off-by: Ingo Molnar <[email protected]>

Signed-off-by: Vince Weaver <[email protected]>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index 01ee579..fa6f6c5 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -256,6 +256,8 @@ struct perf_event_attr {
__u32 sample_stack_user; /* size of stack to dump on
samples */
__u32 __reserved_2; /* Align to u64 */
+ __u32 aux_watermark;
+ __u32 __reserved_2; /* align to u64 */

};
.fi
@@ -350,6 +352,11 @@ and
.I sample_stack_user
in Linux 3.7.
.\" commit 1659d129ed014b715b0b2120e6fd929bdd33ed03
+.B PERF_ATTR_SIZE_VER5
+is 112 corresponding to the addition of
+.I aux_watermak
+.\" commit 1a5941312414c71dece6717da9a0fa1303127afa
+in Linux 4.1.
.TP
.I "config"
This specifies which event you want, in conjunction with
@@ -1218,6 +1225,12 @@ described in the kernel header
This defines the size of the user stack to dump if
.B PERF_SAMPLE_STACK_USER
is specified.
+.TP
+.IR "aux_watermark" " (since Linux 4.1)"
+.\" commit 1a5941312414c71dece6717da9a0fa1303127afa
+This specifies how much data is required to trigger a
+.B PERF_RECORD_AUX
+sample.
.SS Reading results
Once a
.BR perf_event_open ()