BEZEICHNUNG

       setjmp - Stapelspeicher-Zusammenhang für nicht lokale Verzweigung sichern

ÜBERSICHT

       #include <setjmp.h>

       int setjmp(jmp_buf env);

       int sigsetjmp(sigjmp_buf env, int savesigs);

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       setjmp(): siehe ANMERKUNGEN
       sigsetjmp(): _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_C_SOURCE

BESCHREIBUNG

       setjmp()  und  longjmp(3)  sind nützlich für die Behandlung von Fehlern und Unterbrechungen, die in einem
       Unterprogramm niedriger Stufe eines Programms auftreten. setjmp() sichert den Stapelspeicher-Zusammenhang
       bzw.   die   Stapelspeicher-Umgebung   in   env   für   spätere   Benutzung   durch    longjmp(3).    Der
       Stapelspeicher-Zusammenhang wird ungültig, wenn die Funktion, die setjmp() aufgerufen hat, beendet wird.

       sigsetjmp()  ist  setjmp()  ähnlich.  Nur wenn savesigs nicht Null ist, wird die aktuelle Signalmaske des
       Prozesses in env gespeichert  und  wiederhergestellt,  wenn  später  mit  diesem  env  ein  siglongjmp(3)
       durchgeführt wird.

RÜCKGABEWERT

       setjmp()  und  sigsetjmp()  geben  0  zurück, falls sie sofort zurückkehren, und nicht Null, wenn sie von
       longjmp(3) oder siglongjmp(3) zurückkehren und den gesicherten Zusammenhang benutzen.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle         │ Attribut              │ Wert    │
       ├───────────────────────┼───────────────────────┼─────────┤
       │ setjmp(), sigsetjmp() │ Multithread-Fähigkeit │ MT-Safe │
       └───────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

       setjmp(): POSIX.1-2001, POSIX.1-2008, C89, C99.

       sigsetjmp(): POSIX.1-2001, POSIX.1-2008.

ANMERKUNGEN

       POSIX spezifiziert nicht, ob setjmp() die Signalmaske sichern wird  (um  sie  später  während  longjmp(3)
       wieder  herzustellen).  In  System-V  wird es dies nicht tun. In 4.3BSD wird es dies tun und dort gibt es
       eine Funktion _setjmp, die es nicht tut.  Unter  Linux  mit  Glibc-Versionen  vor  2.19  folgte  setjmp()
       standardmäßig  dem  Verhalten  von  System  V,  aber  das  BSD-Verhalten  wird  bereitgestellt,  wenn das
       _BSD_SOURCE-Feature-Test-Macro definiert ist und  weder  _POSIX_SOURCE,  _POSIX_C_SOURCE,  _XOPEN_SOURCE,
       _XOPEN_SOURCE_EXTENDED,  _GNU_SOURCE  noch  _SVID_SOURCE definiert ist. Seit Glibc 2.19 stellt <setjmp.h>
       nur die System-V-Version von setjmp() bereit. Programme, die die BSD-Semantik benötigen, sollten  Aufrufe
       von  setjmp() durch Aufrufe von sigsetjmp(), bei denen das Argument savesigs ungleich numerisch Null ist,
       ersetzen.

       Falls Sie portable Signalmasken für das Speichern und Wiederherstellen möchten, benutzen Sie  sigsetjmp()
       und siglongjmp(3).

       setjmp()  und  sigsetjmp()  erschweren  das Verständnis und die Verwaltung von Programmen. Falls möglich,
       sollte eine Alternative benutzt werden.

SIEHE AUCH

       longjmp(3), siglongjmp(3)

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  4.04  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 http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite wurde von Patrick Rother <krd@gulu.net> und Chris Leick
       <c.leick@vollbio.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>.

                                                 8. August 2015                                        SETJMP(3)