From d5a24378f93b4f4c8546855385b4d25fb3219dc2 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 19 Oct 2016 08:59:31 +0200 Subject: [PATCH] perf_event_open.2: Minor tweaks to Vince Weaver's patch Signed-off-by: Michael Kerrisk --- man2/perf_event_open.2 | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 04a0cf5ca..d64adafd9 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -1120,10 +1120,10 @@ This enables the generation of records when a context switch occurs. It also enables the generation of .B PERF_RECORD_SWITCH_CPU_WIDE -records when sampling in cpu-wide mode. +records when sampling in CPU-wide mode. This functionality is in addition to existing tracepoint and software events for measuring context switches. -The advantage of this method is that it will give full +The advantage of this method is that it will give a full information event with strict .I perf_event_paranoid settings. @@ -1808,8 +1808,8 @@ Sample happened in guest user code. .RE .RS -The following three statuses are generated by -different record types so they alias to the same bit: +Since the following three statuses are generated by +different record types, they alias to the same bit: .TP .BR PERF_RECORD_MISC_MMAP_DATA " (since Linux 3.10)" .\" commit 2fe85427e3bf65d791700d065132772fc26e4d75 @@ -1828,10 +1828,12 @@ system call. .BR PERF_RECORD_MISC_SWITCH_OUT " (since Linux 4.3)" .\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 When a -.BR PERF_RECORD_SWITCH " or " PERF_RECORD_SWITCH_CPU_WIDE -record is generated this bit indicates that the +.BR PERF_RECORD_SWITCH +or +.BR PERF_RECORD_SWITCH_CPU_WIDE +record is generated, this bit indicates that the context switch is away from the current process -(instead of in to the current process). +(instead of into the current process). .RE .RS @@ -2633,7 +2635,7 @@ struct { As with .B PERF_RECORD_SWITCH this record indicates a context switch has happened, -but it only occurs when sampling in cpu-wide mode +but it only occurs when sampling in CPU-wide mode and provides additional information on the process being switched to/from. The @@ -2655,11 +2657,11 @@ struct { .RS .TP .I next_prev_pid -The process id of the previous (if switching in) +The process ID of the previous (if switching in) or next (if switching out) process on the CPU. .TP .I next_prev_tid -The thread id of the previous (if switching in) +The thread ID of the previous (if switching in) or next (if switching out) thread on the CPU. .RE .RE