Content-type: text/html Man page of sem_destroy

sem_destroy

Section: Realtime Library Functions (3RT)
Updated: 28 Jun 2002
Index Return to Main Contents
 

NAME

sem_destroy - destroy an unnamed semaphore  

SYNOPSIS

cc [ flag... ] file... -lrt [ library... ]
#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(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 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(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelMT-Safe

 

SEE ALSO

sem_init(3RT), sem_open(3RT), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:04 GMT, October 02, 2010