linux-kernel - [patch 02/11] perf_event_open.2: 4.1 clockid support

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Date:	Thu, 23 Jul 2015 13:09:26 -0400 (EDT)
From:	Vince Weaver <vincent.weaver@...ne.edu>
To:	"Michael Kerrisk (man-pages)" <mtk.manpages@...il.com>
cc:	linux-man@...r.kernel.org, linux-kernel@...r.kernel.org,
	Peter Zijlstra <a.p.zijlstra@...llo.nl>,
	Ingo Molnar <mingo@...hat.com>,
	Arnaldo Carvalho de Melo <acme@...nel.org>,
	Stephane Eranian <eranian@...gle.com>,
	Andrew Morton <akpm@...ux-foundation.org>,
	David Ahern <dsahern@...il.com>, Jiri Olsa <jolsa@...hat.com>,
	John Stultz <john.stultz@...aro.org>,
	Linus Torvalds <torvalds@...ux-foundation.org>,
	Thomas Gleixner <tglx@...utronix.de>,
	Vince Weaver <vincent.weaver@...ned.edu>
Subject: [patch 02/11] 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@...radead.org>

	perf: Add per event clockid support

	Signed-off-by: Peter Zijlstra (Intel) <peterz@...radead.org>
	Cc: Andrew Morton <akpm@...ux-foundation.org>
	Cc: Arnaldo Carvalho de Melo <acme@...hat.com>
	Cc: David Ahern <dsahern@...il.com>
	Cc: Jiri Olsa <jolsa@...hat.com>
	Cc: John Stultz <john.stultz@...aro.org>
	Cc: Linus Torvalds <torvalds@...ux-foundation.org>
	Cc: Peter Zijlstra <peterz@...radead.org>
	Cc: Stephane Eranian <eranian@...gle.com>
	Cc: Thomas Gleixner <tglx@...utronix.de>
	Signed-off-by: Ingo Molnar <mingo@...nel.org>


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

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index 71bfb17..a6b90ec 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 */
     __u64 sample_regs_intr;     /* regs to dump on samples */
 };
 .fi
@@ -1086,6 +1088,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 )
@@ -1260,6 +1271,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 ()
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/