SIGRETURN(2)

BEZEICHNUNG
sigreturn, rt_sigreturn - Rückkehr vom Signal-Handler und Aufräumen des Stacks

ÜBERSICHT
int sigreturn(…);

BESCHREIBUNG
If the Linux kernel determines that an unblocked signal is pending for a process, then, at the next transition back to user mode in that process (e.g., upon return from a system call or when the process is rescheduled onto the CPU), it creates a new frame on the user-space stack where it saves various pieces of process context (processor status word, registers, signal mask, and signal stack settings).

Der Kernel sorgt auch dafür, dass während des Übergangs in den Benutzerraum der Signal-Handler aufgerufen wird und dass nach der Rückkehr aus dem Handler die Steuerung an ein Codestück im Benutzerraum abgegeben wird, der häufig »Signaltrampolin« genannt wird. Der Signaltrampolincode ruft dann wiederum sigreturn() auf.

Dieser Aufruf von sigreturn() macht alle Aktionen für den Aufruf des Signal Handlers – die Änderung der Signalmaske des Prozesses, Umschalten der Signal-Stacks (siehe sigaltstack(2)) – rückgängig. Mittels der Informationen, die früher auf dem Benutzer-Stack gespeichert wurden, stellt sigreturn() die Signalmaske des Prozesses wieder her, schaltet die Stacks um und stellt den Prozesskontext (Prozessorschalter und -register, darunter den Stack-Zeiger und den Instruktions-Zeiger) wieder her, so dass die Ausführung des Prozesses an dem Punkt fortgesetzt wird, wo er von dem Signal unterbrochen wurde.

RÜCKGABEWERT
sigreturn() kehrt nie zurück.

KONFORM ZU
Viele UNIX-artige Systeme haben einen Systemaufruf sigreturn() oder etwas nah verwandtes. Allerdings wird dieser Aufruf nicht in POSIX spezifiziert und die Details seines Verhaltens unterscheiden sich von System zu System.

ANMERKUNGEN
sigreturn() exists only to allow the implementation of signal handlers. It should never be called directly. (Indeed, a simple sigreturn() wrapper in the GNU C library simply returns -1, with errno set to ENOSYS.) Details of the arguments (if any) passed to sigreturn() vary depending on the architecture. (On some architectures, such as x86-64, sigreturn() takes no arguments, since all of the information that it requires is available in the stack frame that was previously created by the kernel on the user-space stack.)

Früher platzierten UNIX-Systeme den Signaltrampolincode in dem Benutzerstack. Heutzutage sind die Seiten des Benutzer-Stacks so geschützt, dass Code-Ausführung verweigert wird. Daher befindet sich der Signaltrampolincode auf aktuellen Linux-Systemen, abhängig von der Architektur, entweder im vdso(7) oder in der C-Bibliothek. In letzterem Falle informiert die Wrapperfunktion sigaction(2) der C-Bibliothek den Kernel über den Ort des Trampolincodes, indem es dessen Adresse in dem Feld sa_restorer der Struktur sigaction ablegt und den Schalter SA_RESTORER im Feld sa_flags setzt.

Die gespeicherte Prozesskontextinformation wird in einer Struktur ucontext_t (siehe <sys/ucontext.h>) abgelegt. Diese Struktur ist innerhalb des Signal-Handlers als drittes Argument eines Handlers, der über sigaction(2) mit dem Schalter SA_SIGINFO etabliert wurde, sichtbar.

Auf einigen anderen UNIX-Systemen unterscheidet sich die Aktion des Signaltrampolins ein bisschen. Insbesondere übergibt der Kernel auf einigen Systemen die Steuerung bei der Rückkehr in den Benutzerraummodus an das Trampolin (statt an den Signal-Handler) und der Trampolincode ruft den Signal-Handler auf (und ruft dann sigreturn() auf, sobald der Handler zurückkehrt).

  Unterschiede C-Bibliothek/Kernel
Der ursprüngliche Systemaufruf hieß sigreturn(). Mit der Hinzunahme von Echtzeitsignalen in Linux 2.2 wurde allerdings ein neuer Systemaufruf rt_sigreturn() zur Unterstützung eines vergrößerten Typs sigset_t hinzugefügt. Die GNU-C-Bibliothek versteckt diese Details und setzt rt_sigreturn() transparent ein, wenn der Kernel dies bereitstellt.

SIEHE AUCH
kill(2), restart_syscall(2), sigaltstack(2), signal(2), getcontext(3), signal(7), vdso(7)

KOLOPHON
Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org>, René Tschirley <gremlin@cs.tu-berlin.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Mario Blättermann <mario.blaettermann@gmail.com>, Dr. Tobias Quathamer <toddy@debian.org> und Helge Kreutzmann <debian@helgefjell.de> erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.