NAME

bsemwakeup − wake up waiters for a binary semaphore

SYNOPSIS

#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/bsem.h>
 int bsemwakeup (bsemid)
int bsemid;

DESCRIPTION

Bsemid is a  binary semaphore identifier obtained from a bsemget call.  bsemwakeup awakens all of the processes that are waiting for the binary semaphore to become unlocked.  The invoker of bsemwakeup is expected to set the locked field of the binary semaphore to 0 prior to calling bsemwakeup. 

RETURN VALUE

Upon successful completion a value of 0 is returned.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

ERRORS

bsemwakeup will fail if one or more of the following are true:

­[EPERM] The calling process does not have write access to bsemid. This error will only be checked for and returned on non-real-time systems.

­[EINVAL] bsemid is not a valid binary semaphore identifier. 

NOTES

It is expected that the only use of this system service will be in the unlockbinsem(3C) library routine. 

The interface to this system service is subject to change. 

SEE ALSO

bsemfree(2), bsemget(2), bsemwakeup(2), unlockbinsem(3C)

CX/UX Programmer’s Reference Manual