lkml.org 
[lkml]   [2015]   [Apr]   [16]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
Patch in this message
/
From
Date
Subject[patch 02/10] perf_event_open.2: 4.1 clockid support

This manpage patch relates to the addition of the clockid
functionaliry added in the following commit:

commit 34f439278cef7b1177f8ce24f9fc81dfc6221d3b
Author: Peter Zijlstra <peterz@infradead.org>

perf: Add per event clockid support

Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: David Ahern <dsahern@gmail.com>
Cc: Jiri Olsa <jolsa@redhat.com>
Cc: John Stultz <john.stultz@linaro.org>
Cc: Linus Torvalds <torvalds@linux-foundation.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Stephane Eranian <eranian@google.com>
Cc: Thomas Gleixner <tglx@linutronix.de>
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 01ee579..d879651 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -233,7 +233,9 @@ struct perf_event_attr {
/* exclude user callchains */
mmap2 : 1, /* include mmap with inode data */
comm_exec : 1, /* flag comm events that are due to exec */
- __reserved_1 : 39;
+ use_clockid : 1, /* use clockid for time fields */
+
+ __reserved_1 : 38;

union {
__u32 wakeup_events; /* wakeup every n events */
@@ -255,7 +257,7 @@ struct perf_event_attr {
__u64 sample_regs_user; /* user regs to dump on samples */
__u32 sample_stack_user; /* size of stack to dump on
samples */
- __u32 __reserved_2; /* Align to u64 */
+ __s32 clockid; /* clock to use for time fields */

};
.fi
@@ -1049,6 +1051,15 @@ reported was caused by a call to
This allows tools to distinguish between the various
types of process renaming.
.TP
+.IR "use_clockid" " (since Linux 4.1)"
+.\" commit 34f439278cef7b1177f8ce24f9fc81dfc6221d3b
+This allows selecting which internal Linux clock to use
+when generating timestamps via the
+.I clockid
+field.
+This can make it easier to correlate perf sample times with
+timestamps generated by other tools.
+.TP
.IR "wakeup_events" ", " "wakeup_watermark"
This union sets how many samples
.RI ( wakeup_events )
@@ -1218,6 +1229,19 @@ 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 "clockid" " (since Linux 4.1)"
+.\" commit 34f439278cef7b1177f8ce24f9fc81dfc6221d3b
+If
+.I use_clockid
+is set, then this field selects which internal Linux timer to
+use for timestamps.
+The available timers are defined in
+.IR linux/time.h ,
+with
+.BR CLOCK_MONOTONIC , CLOCK_MONOTONIC_RAW , CLOCK_REALTIME ,
+.BR CLOCK_BOOTTIME ", and " CLOCK_TAI
+currently supported.
.SS Reading results
Once a
.BR perf_event_open ()

\
 
 \ /
  Last update: 2015-04-16 20:21    [W:0.032 / U:1.628 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site