SEM_DESTROY(3C) Standard C Library Functions SEM_DESTROY(3C)

NAME

sem_destroy - destroy an unnamed semaphore

SYNOPSIS

#include <semaphore.h>

int sem_destroy(sem_t *sem);

DESCRIPTION

The sem_destroy() function is used to destroy the unnamed semaphore
indicated by sem. Only a semaphore that was created using
sem_init(3C) may be destroyed using sem_destroy(); the effect of
calling sem_destroy() with a named semaphore is undefined. The effect
of subsequent use of the semaphore sem is undefined until sem is re-
initialized by another call to sem_init(3C).


It is safe to destroy an initialised semaphore upon which no threads
are currently blocked. The effect of destroying a semaphore upon
which other threads are currently blocked is undefined.

RETURN VALUES

If successful, sem_destroy() returns 0, otherwise it returns -1 and
sets errno to indicate the error.

ERRORS

The sem_destroy() function will fail if:

EINVAL
The sem argument is not a valid semaphore.


The sem_destroy() function may fail if:

EBUSY
There are currently processes (or LWPs or threads) blocked
on the semaphore.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Committed |
+--------------------+-------------------+
|MT-Level | MT-Safe |
+--------------------+-------------------+
|Standard | See standards(7). |
+--------------------+-------------------+

SEE ALSO

sem_init(3C), sem_open(3C), attributes(7), standards(7)

February 5, 2008 SEM_DESTROY(3C)