#include <semaphore.h> int
sem_destroy (sem_t *sem);
DESCRIPTION
The
sem_destroy ();
function destroys the unnamed semaphore pointed to by
Fa sem .
After a successful call to
sem_destroy (,);
Fa sem
is unusable until re-initialized by another call to
sem_init3.
RETURN VALUES
Rv -std sem_destroy
ERRORS
The
sem_destroy ();
function will fail if:
Bq Er EINVAL
The
Fa sem
argument
points to an invalid semaphore.
Bq Er EBUSY
There are currently threads blocked on the semaphore that
Fa sem
points to.
The
sem_destroy ();
function conforms to
St -p1003.1-96 .
POSIX
does not define the behavior of
sem_destroy ();
if called while there are threads blocked on
Fa sem ,
but this implementation is guaranteed to return -1 and set
errno
to
Er EBUSY
if there are threads blocked on
Fa sem .
