pthread_cond_signal(3) — Subroutines
Digital
NAME
pthread_cond_signal − Wakes one thread that is waiting on a condition variable.
SYNOPSIS
#include <pthread.h>
int pthread_cond_signal(
pthread_cond_t ∗cond );
PARAMETERS
condCondition variable signaled.
DESCRIPTION
This routine wakes one thread waiting on a condition variable. Calling this routine implies that data guarded by the associated mutex has changed so that it might be possible for a single waiting thread to proceed. Call this routine when any thread waiting on the specified condition variable might find its predicate true, but only one thread should proceed.
The scheduling policy determines which thread is awakened. For policies SCHED_FIFO, SCHED_RR, and SCHED_OTHER, a blocked thread is chosen in priority order, using SCHED_FIFO (First In, First Out) within priorities.
Call this routine when the associated mutex is either locked or unlocked.
RETURN VALUES
If an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:
| Return | Error | Description |
| 0 | Successful completion. | |
| −1 | [EINVAL] | The value specified by cond is invalid. |
RELATED INFORMATION
pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_timedwait(3), pthread_cond_wait(3)