ИМЯ

sigreturn, rt_sigreturn - выполняет возврат из обработчика сигнала и очищает кадр стека

ОБЗОР

int sigreturn(...);

ОПИСАНИЕ

Если ядро Linux обнаруживает, что неблокированный сигнал ожидает обработки процессом, то при
следующем переключении в пользовательский режим в этом процессе (например, при возврате из
системного вызова или когда процесс перепланируется на ЦП), оно создаёт новый кадр в стеке
пользовательского пространства, где сохраняет различные части контекста процесса (состояние
слова процессора, регистры, маску сигналов и настройки стека сигналов).

Также ядро делает так, что при переходе в пользовательский режим вызывается обработчик
сигналов и при возврате из обработчика управление передаётся части кода пользовательского
пространства, называемого «сигнальным батутом»(signal trampoline). Код сигнального батута, в
свою очередь, вызывает sigreturn().

Вызов sigreturn() очищает всё что накопилось — изменяет маску сигнала процесса, переключает
стеки сигналов (см. sigaltstack(2)) — чтобы вызвать обработчик сигнала. Используя
информацию, которая была ранее сохранена в стеке пользовательского пространства, sigreturn()
восстанавливает маску сигналов процесса, переключает стеки и восстанавливает контекст
процесса (регистры и флаги процессора, включая указатель стека и инструкций), так что
процесс непосредственно возобновляет исполнение с точки где был прерван сигналом.

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

Вызов sigreturn() не возвращает значений.

СООТВЕТСТВИЕ СТАНДАРТАМ

Во многих системах UNIX есть системный вызов sigreturn() или его эквивалент. Однако этот
вызов отсутствует в POSIX, и в разных системах он работает по-разному.

ЗАМЕЧАНИЯ

Вызов sigreturn() существует только для реализации обработчиков сигналов. Никогда не
вызывайте его напрямую (на самом деле, простая обёртка sigreturn() в библиотеке GNU C просто
вернёт -1 и присвоит errno значение ENOSYS). Содержимое аргументов (если есть), передаваемое
sigreturn(), для каждой архитектуры своё (на некоторых архитектурах, например x86-64, у
sigreturn() нет аргументов, так как вся требуемая информация доступна из кадра стека,
который был создан ядром ранее в стеке пользовательского пространства).

Когда-то системы UNIX помещали код сигнального перехода в пользовательский стек. В настоящее
время страницы пользовательского стека защищены и в них невозможно выполнить код. Поэтому в
современных системах Linux, в зависимости от архитектуры, код хранится в vdso(7) или в
библиотеке C. В последнем случае обёрточная функция sigaction(2) библиотеки C информирует
ядро о расположении кода помещая его адрес в поле sa_restorer структуры sigaction и
устанавливает флаг SA_RESTORER в поле sa_flags.

Сохранённая информация контекста процесса помещается в структуру ucontext_t (смотрите
<sys/ucontext.h>). Эта структура видима внутри обработчика сигнала как третий аргумент
обработчика, установленного sigaction(2) с флагом SA_SIGINFO.

В некоторых других системах UNIX работа сигнального батута несколько отличается. В
частности, в некоторых системах при переходе в пользовательский режим ядро передаёт
управление батуту (а не обработчику сигнала) и код батута вызывает обработчик сигнала (и
затем вызывает sigreturn() после завершения работы обработчика).