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.

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.