ИМЯ¶

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 3.7.

СТАНДАРТЫ¶

Данный системный вызов есть только в Linux и только на архитектуре s390. Технические средства времени выполнения доступны начиная с 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>

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

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