[patch 06/11] perf_event_open.2: 4.1 add AUX sample support

* [patch 06/11] perf_event_open.2: 4.1 add AUX sample support
@ 2015-07-23 17:13 ` Vince Weaver
  0 siblings, 0 replies; 4+ messages in thread
From: Vince Weaver @ 2015-07-23 17:13 UTC (permalink / raw)
  To: Michael Kerrisk (man-pages)
  Cc: linux-man, linux-kernel, Peter Zijlstra, Ingo Molnar,
	Arnaldo Carvalho de Melo, Stephane Eranian, Alexander Shishkin,
	Borislav Petkov, Frederic Weisbecker, H. Peter Anvin, Kaixu Xia,
	Linus Torvalds, Mike Galbraith, Robert Richter, Thomas Gleixner,
	adrian.hunter, kan.liang, markus.t.metzger, mathieu.poirier,
	Vince Weaver


This manpage patch relates to the addition of the AUX sample type
as added in the following commit:

	commit 68db7e98c3a6ebe7284b6cf14906ed7c55f3f7f0
	Author: Alexander Shishkin <alexander.shishkin@linux.intel.com>

	perf: Add AUX record

	Signed-off-by: Alexander Shishkin <alexander.shishkin@linux.intel.com>
	Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
	Cc: Arnaldo Carvalho de Melo <acme@infradead.org>
	Cc: Borislav Petkov <bp@alien8.de>
	Cc: Frederic Weisbecker <fweisbec@gmail.com>
	Cc: H. Peter Anvin <hpa@zytor.com>
	Cc: Kaixu Xia <kaixu.xia@linaro.org>
	Cc: Linus Torvalds <torvalds@linux-foundation.org>
	Cc: Mike Galbraith <efault@gmx.de>
	Cc: Paul Mackerras <paulus@samba.org>
	Cc: Robert Richter <rric@kernel.org>
	Cc: Stephane Eranian <eranian@google.com>
	Cc: Thomas Gleixner <tglx@linutronix.de>
	Cc: adrian.hunter@intel.com
	Cc: kan.liang@intel.com
	Cc: markus.t.metzger@intel.com
	Cc: mathieu.poirier@linaro.org
	Link: http://lkml.kernel.org/r/1421237903-181015-7-git-send-email-alexander.shishkin@linux.intel.com
	Signed-off-by: Ingo Molnar <mingo@kernel.org>


Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index bd6c4c9..dfb0b64 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -2445,6 +2445,39 @@ is the flags information.
 .I filename
 is a string describing the backing of the allocated memory.
 .RE
+.TP
+.BR PERF_RECORD_AUX " (since Linux 4.1)"
+\" commit 68db7e98c3a6ebe7284b6cf14906ed7c55f3f7f0
+This record reports that new data is available in the separate
+AUX buffer region.
+
+.in +4n
+.nf
+struct {
+    struct perf_event_header header;
+    u64 aux_offset;
+    u64 aux_size;
+    u64 flags;
+    struct sample_id sample_id;
+};
+.fi
+.RS
+.TP
+.I aux_offset
+offset in the AUX mmap region where the new data begins.
+.TP
+.I aux_size
+size of the data made available.
+.TP
+.I flags
+describes the aux update.
+.RS
+.TP
+.B PERF_AUX_FLAG_TRUNCATED
+if set then the data returned was truncated to fit the available
+buffer size.
+.RE
+.RE
 .RE
 .SS Overflow handling
 Events can be set to notify when a threshold is crossed,

^ permalink raw reply related	[flat|nested] 4+ messages in thread