signal(2)

BEZEICHNUNG
signal - Handhabung von Signalen in ANSI C

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <signal.h>

typedef typeof(void (int))  *sighandler_t;

sighandler_t signal(int signum, sighandler_t handler);

BESCHREIBUNG
WARNUNG: Das Verhalten von signal() unterscheidet sich zwischen UNIX-Versionen und hat sich historisch auch zwischen verschiedenen Linux-Versionen geändert. Vermeiden Sie den Einsatz dieser Funktion und verwenden Sie stattdessen sigaction(2); siehe Portabilität weiter unten.

signal() ordnet dem Signal signum den handler zu. Das ist entweder SIG_IGN, SIG_DFL oder die Adresse einer vom Programmierer definierten Funktion (eines »Signal Handlers«).

Falls dem Prozess das Signal signum zugestellt wird, wird einer der folgenden Fälle eintreten:

*   Falls SIG_IGN zugeordnet wurde, wird das Signal ignoriert.

*   Falls SIG_DFL zugeordnet wurde, wird die standardmäßig dem Signal zugewiesene Aktion ausgeführt, wenn das Signal eintrift (siehe signal(7)).

*   Falls eine Funktion zugeordnet wurde, dann wird zuerst entweder die Zuweisung auf SIG_DFL zurückgesetzt oder das Signal wird blockiert (siehe Portability unten) und anschließend handler mit dem Argument signum aufgerufen. Falls der Aufruf des Handlers ein Blockieren des Signals verursachte, wird die Blockade nach der Rückkehr aus dem Handler aufgehoben.

Die Signale SIGKILL und SIGSTOP können nicht abgefangen oder ignoriert werden.

RÜCKGABEWERT
signal() liefert den vorherigen Signal Handler zurück oder im Fehlerfall SIG_ERR. Im Fehlerfall wird errno gesetzt, um den Fehler anzuzeigen.

FEHLER

EINVAL
    signum ist ungültig.

VERSIONEN
Die Verwendung von sighandler_t ist eine GNU-Erweiterung, die durch die Definition von _GNU_SOURCE verfügbar wird; Glibc definiert zusätzlich (das von BSD abgeleitete) sig_t, wenn _BSD_SOURCE (Glibc 2.19 und älter) oder _DEFAULT_SOURCE (Glibc 2.19 und neuer) definiert wird. Die Standard-Definition von signal() lautet:

    typeof(void (int)) *signal(int signum, typeof(void (int)) *handler);

  Portabilität
Die einzige portable Verwendung von signal() ist die Zuordnung von SIG_DFL oder SIG_IGN zu einem Signal. Die Semantik bei der Einrichtung eines Signal Handlers mittels signal() unterscheidet sich zwischen Systemen (und POSIX.1 erlaubt diese Unterschiede explizit); verwenden Sie die Funktion nicht für diesen Zweck.

POSIX.1 löste das Portabilitätschaos durch die Beschreibung von sigaction(2), die eine explizite Kontrolle der Semantik beim Aufruf eines Signal-Handlers ermöglicht; verwenden Sie diese Schnittstelle anstatt von signal().

STANDARDS
C11, POSIX.1-2024.

GESCHICHTE
C89, POSIX.1-2001.

In den ursprünglichen UNIX-Systemen wurde beim Aufruf eines mittels signal() zugeordneten Handlers die Signalbearbeitung wieder auf SIG_DFL zurückgesetzt und das System blockierte weitere Instanzen des Signals nicht mehr. Dies ist äquivalent zum Aufruf von sigaction(2) mit den folgenden Schaltern:

    sa.sa_flags = SA_RESETHAND | SA_NODEFER;

Auch System V bietet diese Semantik für signal(). Das war schlecht, weil das Signal wieder eintreffen konnte, bevor der Signal Handler Gelegenheit hatte, sich erneut einzurichten. Darüber hinaus konnten schnell aufeinander folgende Zustellungen des gleichen Signals zu rekursiven Aufrufen des Handlers führen.

BSD verbesserte die Situation, änderte aber unglücklicherweise dabei auch die Semantik der bestehenden signal()-Schnittstelle. Unter BSD wird beim Aufruf eines Signal-Handlers dieser für das Signal beibehalten und die Zustellung weiterer Instanzen des Signals wird blockiert, solange der Handler noch läuft. Desweiteren werden bestimmte blockierende Systemaufrufe automatisch neu gestartet, falls sie durch einen Signal-Handler (siehe signal(7)) unterbrochen wurden. Die BSD-Semantik ist äquivalent zum Aufruf von sigaction(2) mit den folgenden Schaltern:

    sa.sa_flags = SA_RESTART;

Die Situation unter Linux ist wie folgt:

•   Das signal()-System des Kernels stellt System-V-Semantik bereit.

•   Standardmäßig nutzt in Glibc 2 und neuer die signal()-Wrapper-Funktion nicht den Kernel-Systemaufruf. Stattdessen ruft sie sigaction (2) mit Schaltern auf, welche BSD-Semantik bereitstellen. Dieses Standardverhalten wird so lange bereitgestellt, solange ein geeignetes Feature-Test-Makro definiert ist: _BSD_SOURCE unter Glibc 2.19 und älter oder _DEFAULT_SOURCE unter Glibc 2.19 und neuer. (Standardmäßig werden diese Makros definiert; siehe feature_test_macros(7) für Details.) Falls ein solches Feature-Test-Makro nicht definiert ist, wird signal() die System-V-Semantik bereitstellen.

ANMERKUNGEN
Die Auswirkungen von signal() in einem Multithread-Prozess sind nicht spezifiziert.

Laut POSIX ist das Verhalten eines Prozesses undefiniert, nachdem er ein Signal SIGFPE, SIGILL oder SIGSEGV ignoriert hat, das nicht von kill(2) oder raise(3) erstellt wurde. Ganzzahldivision durch Null hat ein undefiniertes Ergebnis. Auf einigen Architekturen wird dies ein Signal SIGFPE hervorrufen. (Auch kann die Division der größten negativen Ganzzahl durch -1 SIGFPE hervorrufen.) Wird dieses Signal ignoriert, kann eine Endlosschleife auftreten.

Siehe sigaction(2) für Einzelheiten des Geschehens, wenn die Zuordnung SIGCHLD auf SIG_IGN gesetzt wird.

Siehe signal-safety(7) für eine Liste von Funktionen, die sicher mit asynchronen Signalen umgehen können und daher sicher aus einem Signal Handler heraus aufgerufen werden können.

SIEHE AUCH
kill(1), alarm(2), kill(2), pause(2), sigaction(2), signalfd(2), sigpending(2), sigprocmask(2), sigsuspend(2), bsd_signal(3), killpg(3), raise(3), siginterrupt(3), sigqueue(3), sigsetops(3), sigvec(3), sysv_signal(3), signal(7)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von René Tschirley <gremlin@cs.tu-berlin.de>, Martin Schulze <joey@infodrom.org>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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 die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.