Provided by: manpages-ja-dev_0.5.0.0.20210215+dfsg-1_all bug

名前

       sigreturn - シグナルハンドラーから返り、スタックを掃除する

書式

       int sigreturn(...);

説明

       Linux  カーネルがプロセスに対してブロックされていないシグナルが処理待ちと判定した場合、 そ
       のプロセスの次回のユーザーモードへの遷移 (すなわち、システムコールからのリターン時やそのプ
       ロセスが  CPU  に再スケジュールされる際)、  カーネルはプロセスコンテキストの種々の値 (プロ
       セッサーのステータスワード、 レジスター、  シグナルマスク、  シグナルスタック設定)  をユー
       ザー空間のスタックに保存する。

       また、  カーネルは、 ユーザーモードへの遷移時にシグナルハンドラーが呼び出され、 ハンドラー
       からのリターン時に、 制御が "signal trampoline" と呼ばれるユーザー空間コードブロックに渡さ
       れるように、準備を行う。 signal trampoline のコードが sigreturn() を呼び出す。

       sigreturn()  は、シグナルハンドラーを起動するために行ったことの全て — プロセスのシグナルマ
       スクの変更、 シグナルスタックの切り替え (sigaltstack(2)  参照) — の取り消しを行う。 プロセ
       スのシグナルマスクの復元、 スタックの切り替え、 プロセスのコンテキスト (プロセッサフラグ、
       レジスター (スタックポインター、 命令ポインターを含む)) の復元を行い、  プロセスがシグナル
       により割り込まれた場所から実行を再開できるようにする。

返り値

       sigreturn()  が返ることはない。

準拠

       多くの  UNIX 系のシステムには sigreturn() システムコールか似たようなシステムコールがある。
       しかしながら、 このシステムコールは POSIX には規定されておらず、  その動作の詳細はシステム
       により異なる。

注意

       sigreturn()  はシグナルハンドラーを実装するためだけに存在している。 これらを直接呼び出すの
       は決して行うべきではない。 sigreturn()  に渡される引き数の詳細はアーキテクチャーにより異な
       る。

       かつて、 UNIX システムでは signal trampoline コードがユーザースタックに置かれていた。 今日
       では、 ユーザースタックのページは保護され、 コードの実行は禁止されている。 したがって、 現
       代の  Linux  システムでは、  アーキテクチャー依存ではあるが、  signal  trampoline コードは
       vdso(7) 内もしくは C ライブラリ内に置かれる。 後者の場合、 C ライブラリは trampoline  code
       の場所を  sigaction(2)  に渡される sigaction 構造体の sa_restorer フィールドを使って渡し、
       sa_flags フィールドの SA_RESTORER フラグをセットする。

       保存されたプロセスコンテキスト情報は ucontext_t構造体に置かれる (<sys/ucontext.h>  参照)。
       この構造体は、  SA_SIGINFO フラグを付けて設定されたシグナルハンドラーの第 3 引き数としてシ
       ングルハンドラー内で参照できる。

       他のいくつかの UNIX システムでは、 signal trampoline の扱いは少し異なる。 特に、  いくつか
       のシステムでは、  ユーザーモードに戻る際に、 カーネルは制御を (シグナルハンドラーではなく)
       trampoline に渡し、 trampoline コードがシグナルハンドラーを呼び出す  (その後ハンドラーが返
       ると sigreturn() を呼び出す)。

関連項目

       kill(2), restart_syscall(2), sigaltstack(2), signal(2), getcontext(3), signal(7)

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 3.79 の一部である。 プロジェクト
       の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。