sem_destroy(3) | Library Functions Manual | sem_destroy(3) |
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
Ü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.
2. Mai 2024 | Linux man-pages 6.8 |