− enable/disable s390 CPU run-time instrumentation
s390_runtime_instr(int command, int
s390_runtime_instr() system call starts or stops CPU
run-time instrumentation for the calling thread.
command argument controls whether run-time
instrumentation is started (S390_RUNTIME_INSTR_START,
1) or stopped (S390_RUNTIME_INSTR_STOP, 2) for the
signum argument specifies the number of a real-time
signal. The real-time signal is sent to the thread if the
run-time instrumentation buffer is full or if the
run-time-instrumentation-halted interrupt occurred.
s390_runtime_instr() returns 0 and enables the thread
for run-time instrumentation by assigning the thread a
default run-time instrumentation control block. The caller
can then read and modify the control block and start the
run-time instrumentation. On error, −1 is returned and
errno is set to one of the error codes listed
The value specified in
command is not a valid command or the value specified
in signum is not a real-time signal number.
Allocating memory for the run-time instrumentation
control block failed.
The run-time instrumentation
facility is not available.
call is available since Linux 3.7.
Linux-specific system call is available only on the s390
architecture. The run-time instrumentation facility is
available beginning with System z EC12.
Glibc does not
provide a wrapper for this system call, use
syscall(2) to call it.
This page is
part of release 4.04 of the Linux man-pages project.
A description of the project, information about reporting
bugs, and the latest version of this page, can be found at