RESTART_SYSCALL(2)

ИМЯ
restart_syscall - перезапускает системный вызов после прерывания сигналом останова

ОБЗОР
int restart_syscall(void);

Замечание: В glibc нет обёрточной функции для данного системного вызова; смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ
Системный вызов restart_syscall() предназначен для перезапуска некоторых системных вызовов после того, как процесс, остановленный сигналом (например, SIGSTOP или SIGTSTP), продолжил выполнение после получения сигнала SIGCONT. Этот системный вызов создан только для внутреннего использования ядром.

Вызов restart_syscall() используется только для тех системных вызовов, которые при перезапуске должны обновить свои параметры, относящиеся к времени, а именно — poll(2) (начиная с Linux 2.6.24), nanosleep(2) (начиная с Linux 2.6), clock_nanosleep(2) (начиная с Linux 2.6), futex(2) при использовании с FUTEX_WAIT (начиная с Linux 2.6.22) и FUTEX_WAIT_BITSET (начиная с Linux 2.6.31). Вызов restart_syscall() перезапускает прерванный системный вызов с аргументом времени, который позволят рассчитать прошедшее время (включая время, когда процесс был остановлен сигналом). Без механизма restart_syscall() при перезапуске этих системных вызовов было бы невозможно вычесть правильное время, прошедшее на момент продолжения выполнение процесса.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Возвращаемым значением restart_syscall() является возвращаемое значение перезапущенного системного вызова.

ОШИБКИ
Значение errno устанавливается в соответствии с ошибками системного вызова, перезапущенного restart_systemcall().

ВЕРСИИ
Системный вызов restart_systemcall() появился в Linux 2.6.

СООТВЕТСТВИЕ СТАНДАРТАМ
Данный вызов есть только в Linux.

ЗАМЕЧАНИЯ
Для этого системного вызова в glibc нет обёрточной функции, потому что он используется только ядром и не должен вызываться приложениями.

Ядро использует restart_syscall() для гарантии того, что когда системный вызов перезапускается после остановки процесса по сигналу и затем возобновляется по SIGCONT, время, которое процесс пробыл в остановленном состоянии будет учтено в интервале ожидания, заданного в первоначальном системном вызове. У системных вызовов, у которых есть аргумент интервала ожидания и которые автоматически перезапускаются после сигнала останова плюс SIGCONT, но которые не имеют встроенного механизма restart_syscall(2), после возобновления работы процесса время, которое процесс пробыл в остановленном состоянии, не учитывается в значении интервала ожидания. Весомыми примерам системных вызовов, которые подвержены этой проблеме, являются ppoll(2), select(2) и pselect(2).

Из пользовательского пространства работа restart_syscall(), в большинстве случаев, невидима: процессу, выполняющему системный вызов, который перезапускался, кажется, что системный вызов выполнился как обычно.

СМОТРИТЕ ТАКЖЕ
sigaction(2), sigreturn(2), signal(7)