Manual Page Result
0
Command: pthread_cond_signal_int_np | Section: 3 | Source: Digital UNIX | File: pthread_cond_signal_int_np.3.gz
pthread_co...nal_int_np(3) Library Functions Manual pthread_co...nal_int_np(3)
NAME
pthread_cond_signal_int_np - Wakes one thread that is waiting on the
specified condition variable (called from interrupt level only).
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
int pthread_cond_signal_int_np(
pthread_cond_t *cond);
STANDARDS
None
PARAMETERS
Condition variable to be signaled.
DESCRIPTION
This routine wakes one thread waiting on the specified condition vari-
able. It can only be called from a software interrupt handler routine
(that is, from a DIGITAL UNIX signal handler or OpenVMS AST). Calling
this routine implies that it might be possible for a single waiting
thread to proceed.
The scheduling policies of the waiting threads determine which thread
is awakened. For policies SCHED_FIFO and SCHED_RR, a blocked thread is
chosen in priority order, using first-in/first-out (FIFO) within prior-
ities.
This routine does not cause a thread blocked on a condition variable to
resume execution immediately. A thread resumes execution at some time
after the interrupt handler routine returns.
You can call this routine regardless of whether the associated mutex is
locked (by some other thread). Never lock a mutex from an interrupt
handler routine.
Note
This routine allows you to signal a thread from a software interrupt
handler. Do not call this routine from noninterrupt code. To signal a
thread from the normal noninterrupt level, use pthread_cond_signal(3).
RETURN VALUES
If an error condition occurs, this routine returns an integer value in-
dicating the type of error. Possible return values are as follows:
Successful completion. The value specified by cond is invalid.
ERRORS
None
RELATED INFORMATION
Functions: pthread_cond_broadcast(3), pthread_cond_signal(3),
pthread_cond_timedwait(3), pthread_cond_wait(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
pthread_co...nal_int_np(3)