From 06afe6739ca88daec10a67522a750d05f07d48ec Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 25 Apr 2012 04:38:04 +1200 Subject: [PATCH] prctl.2: Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE Add some basic documentation of these operations, with a pointer to tools/perf/design.txt for more information. Signed-off-by: Michael Kerrisk --- man2/prctl.2 | 36 ++++++++++++++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) diff --git a/man2/prctl.2 b/man2/prctl.2 index c358b3752..7d96ee479 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -38,10 +38,9 @@ .\" Document PR_GET_TSC and PR_SET_TSC. .\" 2008-06-15 mtk, Document PR_SET_SECCOMP, PR_GET_SECCOMP .\" 2009-10-03 Andi Kleen, document PR_MCE_KILL_* +.\" 2012-04 Cyrill Gorcunov, Document PR_SET_MM .\" .\" FIXME: Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK (new in 2.6.28) -.\" FIXME: Document PR_TASK_PERF_EVENTS_DISABLE and -.\" PR_TASK_PERF_EVENTS_ENABLE (new in 2.6.32) .\" .TH PRCTL 2 2012-04-23 "Linux" "Linux Programmer's Manual" .SH NAME @@ -298,6 +297,39 @@ is not currently implemented .BR PR_GET_TIMING " (since Linux 2.6.0-test4)" Return (as the function result) which process timing method is currently in use. +.\" FIXME: Document PR_TASK_PERF_EVENTS_DISABLE and +.\" PR_TASK_PERF_EVENTS_ENABLE (new in 2.6.32) +.\" Was PR_TASK_PERF_COUNTERS_DISABLE/PR_TASK_PERF_COUNTERS_ENABLE +.\" commit: 1d1c7ddbfab358445a542715551301b7fc363e28 +.\" (new in 2.6.31) +.\" Renamed with commit cdd6c482c9ff9c55475ee7392ec8f672eddb7be6 +.TP +.BR PR_TASK_PERF_EVENTS_DISABLE " (since Linux 2.6.31)" +Disable all performance counters attached to the calling process, +regardless of whether the counters were created by +this process or another process. +Performance counters created by the calling process for other +processes are unaffected. +For more information on performance counters, see the kernel source file +.IR tools/perf/design.txt . +.IP +Originally called +.BR PR_TASK_PERF_COUNTERS_DISABLE ; +.\" commit 1d1c7ddbfab358445a542715551301b7fc363e28 +renamed (with same numerical value) +in Linux 2.6.32. +.TP +.BR PR_TASK_PERF_EVENTS_ENABLE " (since Linux 2.6.31)" +The converse of +.BR PR_TASK_PERF_EVENTS_DISABLE ; +enable performance counters attached to the calling process. +.IP +Originally called +.BR PR_TASK_PERF_COUNTERS_ENABLE ; +.\" commit 1d1c7ddbfab358445a542715551301b7fc363e28 +renamed +.\" commit cdd6c482c9ff9c55475ee7392ec8f672eddb7be6 +in Linux 2.6.32. .TP .BR PR_SET_TSC " (since Linux 2.6.26, x86 only)" Set the state of the flag determining whether the timestamp counter