1S390_RUNTIME_INSTR(2)         System Calls Manual        S390_RUNTIME_INSTR(2)
2
3
4

NAME

6       s390_runtime_instr - enable/disable s390 CPU run-time instrumentation
7

SYNOPSIS

9       #include <asm/runtime_instr.h>
10
11       int s390_runtime_instr(int command, int signum);
12

DESCRIPTION

14       The  s390_runtime_instr()  system  call  starts  or  stops CPU run-time
15       instrumentation for the calling thread.
16
17       The command  argument  controls  whether  run-time  instrumentation  is
18       started    (S390_RUNTIME_INSTR_START,    1)   or   stopped   (S390_RUN‐
19       TIME_INSTR_STOP, 2) for the calling thread.
20
21       The signum argument specifies the number of a  real-time  signal.   The
22       real-time  signal is sent to the thread if the run-time instrumentation
23       buffer is full  or  if  the  run-time-instrumentation-halted  interrupt
24       occurred.
25

RETURN VALUE

27       On  success,  s390_runtime_instr() returns 0 and enables the thread for
28       run-time instrumentation by assigning the  thread  a  default  run-time
29       instrumentation control block.  The caller can then read and modify the
30       control block and start the run-time instrumentation.  On error, -1  is
31       returned and errno is set to one of the error codes listed below.
32

ERRORS

34       EINVAL The  value  specified  in  command is not a valid command or the
35              value specified in signum is not a real-time signal number.
36
37       ENOMEM Allocating memory for the run-time instrumentation control block
38              failed.
39
40       EOPNOTSUPP
41              The run-time instrumentation facility is not available.
42

VERSIONS

44       This system call is available since Linux 3.7.
45

CONFORMING TO

47       This Linux-specific system call is available only on the s390 architec‐
48       ture.  The run-time instrumentation  facility  is  available  beginning
49       with System z EC12.
50

NOTES

52       Glibc  does  not provide a wrapper for this system call, use syscall(2)
53       to call it.
54

SEE ALSO

56       syscall(2), signal(7)
57

COLOPHON

59       This page is part of release 4.16 of the Linux  man-pages  project.   A
60       description  of  the project, information about reporting bugs, and the
61       latest    version    of    this    page,    can     be     found     at
62       https://www.kernel.org/doc/man-pages/.
63
64
65
66Linux Programmer's Manual         2017-09-15             S390_RUNTIME_INSTR(2)
Impressum