НАИМЕНОВАНИЕ

       s390_runtime_instr - включает/выключает технические средства ЦП s390 времени выполнения

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <asm/runtime_instr.h> /* определения констант S390_* */
       #include <sys/syscall.h>       /* определения констант SYS_* */
       #include <unistd.h>

       int syscall(SYS_s390_runtime_instr, int command, int signum);

       Note: glibc provides no wrapper for s390_runtime_instr(), necessitating the use of syscall(2).

ОПИСАНИЕ

       Системный  вызов  s390_runtime_instr()  запускает  или  останавливает  технические  средства  ЦП  времени
       выполнения для вызывающей нити.

       В  аргументе  command  указывается,  что  технические  средства  времени   выполнения   нужно   запустить
       (S390_RUNTIME_INSTR_START, 1) или остановить (S390_RUNTIME_INSTR_STOP, 2) для вызывающей нити.

       The  signum  argument  specifies  the  number of a real-time signal.  This argument was used to specify a
       signal number that should be delivered to the thread if the run-time instrumentation buffer was  full  or
       if the run-time-instrumentation-halted interrupt had occurred.  This feature was never used, and in Linux
       4.4 support for this feature was removed; thus, in current kernels, this argument is ignored.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       On  success,  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 indicate the error.

ОШИБКИ

       EINVAL The value specified in command is not a valid command.

       EINVAL The value specified in signum is not a real-time signal  number.   From  Linux  4.4  onwards,  the
              signum argument has no effect, so that an invalid signal number will not result in an error.

       ENOMEM Не удалось выделить память под блок управления техническими средствами времени выполнения.

       EOPNOTSUPP
              Технические средства времени выполнения недоступны.

СТАНДАРТЫ

       Linux на s390.

ИСТОРИЯ

       Linux 3.7.  System z EC12.

ПРИМЕЧАНИЯ

       Заголовочный файл asm/runtime_instr.h доступен в Linux начиная с версии 4.16.

       Starting  with  Linux 4.4, support for signalling was removed, as was the check whether signum is a valid
       real-time signal.  For backwards compatibility with older kernels, it is  recommended  to  pass  a  valid
       real-time signal number in signum and install a handler for that signal.

СМОТРИТЕ ТАКЖЕ

       syscall(2), signal(7)

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства разработал(и) Alexander Golubev <fatzer2@gmail.com>, Azamat
       Hackimov  <azamat.hackimov@gmail.com>,  Hotellook,   Nikita   <zxcvbnm3230@mail.ru>,   Spiros   Georgaras
       <sng@hellug.gr>,  Vladislav  <ivladislavefimov@gmail.com>,  Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                            s390_runtime_instr(2)