PR_TASK_PERF_EVENTS_ENABLE - disable or enable performance counters attached to the calling process

NAME  LIBRARY  SYNOPSIS  DESCRIPTION  RETURN VALUE  STANDARDS  HISTORY  SEE ALSO 

---

NAME

PR_TASK_PERF_EVENTS_DISABLE, PR_TASK_PERF_EVENTS_ENABLE − disable or enable performance counters attached to the calling process

LIBRARY

Standard C library (libc, −lc)

SYNOPSIS

#include <linux/prctl.h> /* Definition of PR_* constants */
#include <sys/prctl.h>

int prctl(PR_TASK_PERF_EVENTS_DISABLE);
int prctl(PR_TASK_PERF_EVENTS_ENABLE);

DESCRIPTION

PR_TASK_PERF_EVENTS_DISABLE

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.

PR_TASK_PERF_EVENTS_ENABLE

The converse of PR_TASK_PERF_EVENTS_DISABLE; enable performance counters attached to the calling process.

RETURN VALUE

On success, 0 is returned. On error, −1 is returned, and errno is set to indicate the error.

STANDARDS

Linux.

HISTORY

Linux 2.6.31.

Originally called PR_TASK_PERF_COUNTERS_DISABLE and PR_TASK_PERF_COUNTERS_ENABLE; renamed (retaining the same numerical value) in Linux 2.6.32.

SEE ALSO

prctl(2)

For more information on performance counters, see the Linux kernel source file tools/perf/design.txt.

---