PR_TASK_PERF_EVENTS_DISABLE(2)

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.