DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

sem_destroy(S)


sem_destroy -- destroy an unnamed semaphore

Syntax

cc . . . -lsuds
#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 which was created using sem_init(S) may be destroyed using sem_destroy.

Return values

Upon successful completion, a value of zero is returned. Otherwise, a value of -l is returned and errno is set to indicate the error.

Diagnostics

If the following condition occurs, the sem_destroy function returns -1 and sets errno to the corresponding value:

[EINVAL]
The sem argument is not a valid semaphore.
If the following condition is detected, the sem_destroy function returns -1 and sets errno to the corresponding value:

[EBUSY]
There are currently processes blocked on the semaphore.

See also

semaphore(FP), sem_init(S), sem_open(S)

Standards conformance

Text reprinted and/or adapted from IEEE Std 1003.1b-1993, IEEE Standard for Information Technology, POSIX Part 1: System Application Program Interface (API) Amendment 1: Realtime Extensions [C Language], copyright © 1993 by the Institute of Electrical and Electronics Engineers, Inc. The IEEE takes no responsibility for and will assume no liability for damages resulting from the reader's misinterpretation of said information resulting from the placement and context in this publication. Information is reproduced with the permission of the IEEE.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003