DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

_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