Query: sem_destroy
OS: sunos
Section: 3rt
Links: sunos man pages all man pages
Forums: forum home forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
sem_destroy(3RT) Realtime Library Functions sem_destroy(3RT)NAMEsem_destroy - destroy an unnamed semaphoreSYNOPSIScc [ flag... ] file... -lrt [ library... ] #include <semaphore.h> int sem_destroy(sem_t *sem);DESCRIPTIONThe sem_destroy() function is used to destroy the unnamed semaphore indicated by sem. Only a semaphore that was created using sem_init(3RT) 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(3RT). 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 VALUESIf successful, sem_destroy() returns 0, otherwise it returns -1 and sets errno to indicate the error.ERRORSThe 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.ATTRIBUTESSee attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+SEE ALSOsem_init(3RT), sem_open(3RT), attributes(5), standards(5) SunOS 5.10 28 Jun 2002 sem_destroy(3RT)