Content-type: text/html Man page of pthread_cond_signal_int_np

pthread_cond_signal_int_np

Section: C Library Functions (3)
Index Return to Main Contents
 

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 variable. It can only be called from a software interrupt handler routine (that is, from a Tru64 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 priorities.

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 indicating 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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:15 GMT, October 02, 2010