sema_destroy(3scl)sema_destroy(3scl)NAMEsema_destroy - Destroys a semaphore.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <synch.h>
int sema_destroy(
sema_t *semp );
PARAMETERS
Pointer to the semaphore to be destroyed.
DESCRIPTION
This routine destroys the specified semaphore.
SCL IMPLEMENTATION NOTESsema_destroy(3scl) is implemented by calling sem_destroy(3).
On Solaris, sema_destroy() seems to return 0 if the specified semaphore
is invalid (un-initialized). Thus if sem_destroy(3) returns EINVAL,
sema_destroy(3scl) returns 0 and writes an error-mapping message to the
SCL errorlog.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error.
Additional error return information may be written to the SCL error
log. Refer to scl_error_log(4scl) for details.
Possible return values are as follows: Successful completion. Or:
Error EINVAL from sem_destroy(3). An error-mapping message is written
to the SCL errorlog. An internal implementation error occurred. Refer
to the SCL errorlog for additional information.
Note: EFAULT is not returned if semp is an illegal address. An illegal
address generates a SIGSEGV signal, which by default will abort the
process and generate a core dump.
ERRORS
None.
RELATED INFORMATION
Functions: scl_intro(3scl), scl_thread_intro(3scl), sem_destroy(3),
sema_init(3scl), sema_post(3scl), sema_trywait(3scl), sema_wait(3scl)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
sema_destroy(3scl)