_lwp_cond_signal(S)
_lwp_cond_signal --
wake up a single LWP waiting on a condition variable
Synopsis
#include <synch.h>
int _lwp_cond_signal(lwp_cond_t *cond);
Parameters
cond-
pointer to condition variable to be signaled
Description
_lwp_cond_signal wakes up a single lightweight process (LWP),
if one exists, waiting on the condition cond.
If more than one LWP is waiting on a condition, the scheduling
policy determines which LWP is awakened.
_lwp_cond_signal has no effect if there are no LWPs waiting on the
indicated condition.
cond parameter
The condition variable denoted by cond
must previously have been statically initialized (zero-filled).
Return values
_lwp_cond_signal returns zero for success
and an error number for failure, as described below.
Errors
If any of the following conditions is detected,
_lwp_cond_signal returns the corresponding value:
EINVAL-
Invalid argument specified.
EFAULT-
The cond parameter points to an illegal address.
(This error may not be detected; a SIGSEGV signal may be posted to the
faulting LWP if an illegal address is used.)
Usage
See the description of how to use condition variables
under USAGE on
cond_init(SYNCH).
References
_lwp_cond_broadcast(S),
_lwp_cond_timedwait(S),
_lwp_cond_wait(S),
cond_broadcast(SYNCH),
cond_destroy(SYNCH),
cond_init(SYNCH),
cond_signal(SYNCH),
cond_timedwait(SYNCH),
cond_wait(SYNCH)
Notices
Lightweight processes (LWPs) are internal interfaces and are subject
to change. Their use should be avoided.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 01 June 2005