BEZEICHNUNG

       on_exit - registriert eine Funktion für den Aufruf bei normalem Abschluss des Prozesses

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <stdlib.h>

       int on_exit(void (*funktion)(int, void *), void *arg);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       on_exit():
           Seit Glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 und älter:
               _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Die  Funktion  on_exit()  registriert  die  angegebene  Funktion funktion, damit diese bei
       normaler Prozessbeendigung aufgerufen wird. Also durch exit(3)  oder  nach  Verlassen  der
       main-Funktion  des  Programms.  Der Funktion funktion wird das Argument status des letzten
       Aufrufes von exit(3) und das Argument arg von on_exit() übergeben.

       Die  gleiche  Funktion  kann  mehrfach  registriert  werden:  sie  wird  einmal  für  jede
       Registrierung aufgerufen.

       Wenn  mittels  fork(2)  ein  Kindprozess erstellt wird, erbt er Kopien der Registrierungen
       seines Elternprozesses. Nach  einem  erfolgreichen  Aufruf  einer  der  exec(3)-Funktionen
       werden alle Registrierungen entfernt.

RÜCKGABEWERT

       Die  Funktion  on_exit()  gibt  im Erfolgsfall 0 zurück, anderenfalls ist der Rückgabewert
       ungleich 0.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌─────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │Schnittstelle                                        │ Attribut              │ Wert      │
       ├─────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │on_exit()                                            │ Multithread-Fähigkeit │ MT-Sicher │
       └─────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       Keine.

GESCHICHTE

       SunOS 4, Glibc. Wurde in  Solaris  (SunOS  5)  entfernt.  Verwenden  Sie  stattdessen  den
       Standard atexit(3).

WARNUNGEN

       Zum  Zeitpunkt  der  Ausführung  von  funktion  könnten Stack-Variablen (auto) bereits den
       Geltungsbereich verlassen haben. Daher sollte arg  kein  Zeiger  auf  eine  Stack-Variable
       sein;  er  kann  allerdings  ein  Zeiger auf eine Heap-Variable oder eine globale Variable
       sein.

SIEHE AUCH

       _exit(2), atexit(3), exit(3)

ÜBERSETZUNG

       Die   deutsche   Übersetzung    dieser    Handbuchseite    wurde    von    Stefan    Janke
       <gonzo@burg.studfb.unibw-muenchen.de>,  Martin  Eberhard Schauer <Martin.E.Schauer@gmx.de>
       und Mario Blättermann <mario.blaettermann@gmail.com> 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⟩.