_lwp_cond_signal(2)

NAME

_lwp_cond_signal, _lwp_cond_broadcast − signal a condition variable

SYNOPSIS

#include <sys/lwp.h>

int _lwp_cond_signal(lwp_cond_t ∗cvp);

int _lwp_cond_broadcast(lwp_cond_t ∗cvp);

DESCRIPTION

_lwp_cond_signal() unblocks one LWP that is blocked on the LWP condition variable pointed to by cvp.

_lwp_cond_broadcast() unblocks all LWPs that are blocked on the LWP condition variable pointed to by cvp.

If no LWPs are blocked on the LWP condition variable, then _lwp_cond_signal() and _lwp_cond_broadcast() have no effect.

Both functions should be called under the protection of the same LWP mutex lock that is used with the LWP condition variable being signaled. Otherwise the condition variable may be signalled between the test of the associated condition and blocking in _lwp_cond_wait(). This can cause an infinite wait.

RETURN VALUES

Zero is returned when successful. A non-zero value indicates an error.

ERRORS

If any of the following conditions are detected, _lwp_cond_signal(), and _lwp_cond_broadcast() fail and return the corresponding value:

EINVAL cvp points to an invalid LWP condition variable.

EFAULT cvp points to an invalid address.

Museum