aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVince Weaver <vincent.weaver@maine.edu>2016-10-17 10:50:40 -0400
committerMichael Kerrisk <mtk.manpages@gmail.com>2016-10-18 08:15:30 +0200
commitffbc7c027313f0c5572c1d94399445cf44036e12 (patch)
tree73c505733f599233a964a84a8a1bf301335088ae
parent2046b8ac01beb4732191b1d17660b7951f78e3a5 (diff)
downloadman-pages-ffbc7c027313f0c5572c1d94399445cf44036e12.tar.gz
perf_event_open.2: Document PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT
Linux 4.2 reserved a new bit from the misc field in the perf_event_open() mmap sample buffer: PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT Despite being reserved in the public include/uapi/linux/perf_event.h header file, this bit is never set by the kernel. Rather, it is used internally by the user-space "perf" utility to indicate that, when attempting to parse all of the /proc/xxx/maps files for the sample, it ended up taking too long so the scan was aborted. Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
-rw-r--r--man2/perf_event_open.28
1 files changed, 8 insertions, 0 deletions
diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index fa8b1bd379..59ad28959e 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -1822,6 +1822,14 @@ See also
.BR PERF_RECORD_MISC_EXT_RESERVED " (since Linux 2.6.35)"
.\" commit 1676b8a077c352085d52578fb4f29350b58b6e74
This indicates there is extended data available (currently not used).
+.TP
+.B PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT
+.\" commit 930e6fcd2bcce9bcd9d4aa7e755678d33f3fe6f4
+This bit is not set by the kernel.
+It is reserved for the userspace perf utility to indicate that
+.I /proc/xxx/maps
+parsing was taking too long and stopped and thus the mmap
+records may be truncated.
.RE
.TP
.I type