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-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       POSIX.1-2008.

GESCHICHTE

       POSIX.1-2001.

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
       Ressourcenlecks 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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                    sem_destroy(3)