BEZEICHNUNG

       sem_destroy - Eine unbenannte Semaphore zerstören

BIBLIOTHEK

       POSIX-Threads-Bibliothek (libpthread, -lpthread)

ÜBERSICHT

       #include <semaphore.h>

       int sem_destroy(sem_t *sem);

BESCHREIBUNG

       sem_destroy() zerstört eine unbenannte Semaphore an der Adresse, auf die sem zeigt.

       Nur eine mit sem_init(3) initialisierte Semaphore sollte mit sem_destroy() zerstört werden.

       Zerstören  einer  Semaphore,  von  der  andere  Prozesse  oder Threads derzeit (in sem_wait(3)) blockiert
       werden, führt zu nicht definiertem Verhalten.

       Die Verwendung einer zerstörten Sempaphore führt zu nicht definierten Ergebnissen, bis die Semaphore  mit
       sem_init(3) wieder initialisiert wurde.

RÜCKGABEWERT

       sem_destroy()  liefert  im  Erfolgsfall  0  zurück;  im Fehlerfall wird -1 zurückgeliefert und errno wird
       gesetzt, um den Fehler anzuzeigen.

FEHLER

       EINVAL sem ist keine zulässige Semaphore.

ATTRIBUTE

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

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

ANMERKUNGEN

       Eine namenslose Semaphore sollte mit sem_destroy() zerstört werden, bevor der Speicher, in dem  sie  sich
       befindet,  wieder  freigegeben  wird. Erfolgt dies nicht, kann dies bei einigen Implementierungen zu Res‐
       sourcenlecks führen.

SIEHE AUCH

       sem_init(3), sem_post(3), sem_wait(3), sem_overview(7)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von 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 die
       Mailingliste der Übersetzer.

Linux man-pages 6.03                            15. Dezember 2022                                 sem_destroy(3)