diff options
| author | Alejandro Colomar <alx@kernel.org> | 2024-05-30 17:25:09 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-05-31 17:09:32 +0200 |
| commit | 65ee133dc03a262085173a3bb549c16de18180c8 (patch) | |
| tree | 5df0e127314e2682589e4481b2df670b5acc6ea1 | |
| parent | 9bc15afb36425da3f22cd41c86d1d93425b57511 (diff) | |
| download | man-pages-65ee133dc03a262085173a3bb549c16de18180c8.tar.gz | |
prctl.2, PR_TASK_PERF_EVENTS_{EN,DIS}ABLE.2const: Split PR_TASK_PERF_EVENTS_* from prctl(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
| -rw-r--r-- | man/man2/prctl.2 | 39 | ||||
| -rw-r--r-- | man/man2const/PR_TASK_PERF_EVENTS_DISABLE.2const | 61 | ||||
| -rw-r--r-- | man/man2const/PR_TASK_PERF_EVENTS_ENABLE.2const | 1 |
3 files changed, 68 insertions, 33 deletions
diff --git a/man/man2/prctl.2 b/man/man2/prctl.2 index 778ec59750..8e1578e082 100644 --- a/man/man2/prctl.2 +++ b/man/man2/prctl.2 @@ -16,8 +16,6 @@ .\" PR_SET_UNALIGN, PR_GET_UNALIGN, .\" 2008-06-13 Erik Bosman, <ejbosman@cs.vu.nl> .\" Document PR_GET_TSC and PR_SET_TSC. -.\" 2012-04-25 Michael Kerrisk, Document PR_TASK_PERF_EVENTS_DISABLE and -.\" PR_TASK_PERF_EVENTS_ENABLE .\" 2012-10-25 Michael Kerrisk, Document PR_SET_TIMERSLACK and .\" PR_GET_TIMERSLACK .\" @@ -137,37 +135,10 @@ The first argument can be: .B PR_SET_TAGGED_ADDR_CTRL .TQ .B PR_GET_TAGGED_ADDR_CTRL -.\" prctl PR_TASK_PERF_EVENTS_DISABLE -.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 Linux kernel source file -.IR tools/perf/design.txt . -.IP -Originally called -.BR PR_TASK_PERF_COUNTERS_DISABLE ; -.\" commit 1d1c7ddbfab358445a542715551301b7fc363e28 -renamed (retaining the same numerical value) -in Linux 2.6.32. -.\" -.\" prctl PR_TASK_PERF_EVENTS_ENABLE -.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. -.\" +.TQ +.B PR_TASK_PERF_EVENTS_DISABLE +.TQ +.B PR_TASK_PERF_EVENTS_ENABLE .\" prctl PR_SET_THP_DISABLE .TP .BR PR_SET_THP_DISABLE " (since Linux 3.15)" @@ -517,4 +488,6 @@ glibc 2.0.6 .BR PR_SET_SYSCALL_USER_DISPATCH (2const), .BR PR_SET_TAGGED_ADDR_CTRL (2const), .BR PR_GET_TAGGED_ADDR_CTRL (2const), +.BR PR_TASK_PERF_EVENTS_DISABLE (2const), +.BR PR_TASK_PERF_EVENTS_ENABLE (2const), .BR core (5) diff --git a/man/man2const/PR_TASK_PERF_EVENTS_DISABLE.2const b/man/man2const/PR_TASK_PERF_EVENTS_DISABLE.2const new file mode 100644 index 0000000000..1b618e4fba --- /dev/null +++ b/man/man2const/PR_TASK_PERF_EVENTS_DISABLE.2const @@ -0,0 +1,61 @@ +.\" Copyright 2012, 2013, 2015, Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.\" 2012-04-25 Michael Kerrisk, Document PR_TASK_PERF_EVENTS_DISABLE and +.\" PR_TASK_PERF_EVENTS_ENABLE +.\" +.TH PR_TASK_PERF_EVENTS_DISABLE 2 (date) "Linux man-pages (unreleased)" +.SH NAME +PR_TASK_PERF_EVENTS_DISABLE, +PR_TASK_PERF_EVENTS_ENABLE +\- +disable or enable performance counters attached to the calling process +.SH LIBRARY +Standard C library +.RI ( libc ", " \-lc ) +.SH SYNOPSIS +.nf +.B #include <sys/prctl.h> +.P +.BI "int prctl(int " op ", ...);" +.fi +.SH DESCRIPTION +.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 Linux kernel source file +.IR tools/perf/design.txt . +.IP +Originally called +.BR PR_TASK_PERF_COUNTERS_DISABLE ; +.\" commit 1d1c7ddbfab358445a542715551301b7fc363e28 +renamed (retaining the 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. +.SH RETURN VALUE +On success, +0 is returned. +On error, \-1 is returned, and +.I errno +is set to indicate the error. +.SH STANDARDS +Linux. +.SH HISTORY +.SH SEE ALSO +.BR prctl (2) diff --git a/man/man2const/PR_TASK_PERF_EVENTS_ENABLE.2const b/man/man2const/PR_TASK_PERF_EVENTS_ENABLE.2const new file mode 100644 index 0000000000..d32f086499 --- /dev/null +++ b/man/man2const/PR_TASK_PERF_EVENTS_ENABLE.2const @@ -0,0 +1 @@ +.so man2const/PR_TASK_PERF_EVENTS_DISABLE.2const |