GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
PTHREAD_COND_TIMEDWAIT(3) FreeBSD Library Functions Manual PTHREAD_COND_TIMEDWAIT(3)

pthread_cond_timedwait
wait on a condition variable for a specific amount of time

POSIX Threads Library (libpthread, -lpthread)

#include <pthread.h>

int
pthread_cond_timedwait(pthread_cond_t *cond, pthread_mutex_t *mutex, const struct timespec *abstime);

The pthread_cond_timedwait() function atomically blocks the current thread waiting on the condition variable specified by cond, and releases the mutex specified by mutex. The waiting thread unblocks only after another thread calls pthread_cond_signal(3), or pthread_cond_broadcast(3) with the same condition variable, or if the system time reaches the time specified in abstime, and the current thread reacquires the lock on mutex.

The clock used to measure abstime can be specified during creation of the condition variable using pthread_condattr_setclock(3).

If successful, the pthread_cond_timedwait() function will return zero. Otherwise an error number will be returned to indicate the error.

The pthread_cond_timedwait() function will fail if:
[]
The value specified by cond, mutex or abstime is invalid.
[]
The system time has reached or exceeded the time specified in abstime.
[]
The specified mutex was not locked by the calling thread.

pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_signal(3), pthread_cond_wait(3), pthread_condattr_setclock(3)

The pthread_cond_timedwait() function conforms to ISO/IEC 9945-1:1996 (“POSIX.1”).
May 9, 2010 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.