Commit | Line | Data |
---|---|---|
984263bc MD |
1 | .\" Copyright (c) 1997 Brian Cully <shmit@kublai.com> |
2 | .\" All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. Neither the name of the author nor the names of any co-contributors | |
13 | .\" may be used to endorse or promote products derived from this software | |
14 | .\" without specific prior written permission. | |
15 | .\" | |
16 | .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND | |
17 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
18 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
19 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
20 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
21 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
22 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
23 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
24 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
25 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
26 | .\" SUCH DAMAGE. | |
27 | .\" | |
15acf97d | 28 | .\" $FreeBSD: src/share/man/man3/pthread_cond_timedwait.3,v 1.21 2007/10/22 10:08:00 ru Exp $ |
984263bc | 29 | .\" |
bb5b9bec | 30 | .Dd February 22, 2018 |
984263bc MD |
31 | .Dt PTHREAD_COND_TIMEDWAIT 3 |
32 | .Os | |
33 | .Sh NAME | |
34 | .Nm pthread_cond_timedwait | |
35 | .Nd "wait on a condition variable for a specific amount of time" | |
36 | .Sh LIBRARY | |
9964d5ef | 37 | .Lb libpthread |
984263bc MD |
38 | .Sh SYNOPSIS |
39 | .In pthread.h | |
40 | .Ft int | |
bb5b9bec | 41 | .Fn pthread_cond_timedwait "pthread_cond_t * restrict cond" "pthread_mutex_t * restrict mutex" "const struct timespec * restrict abstime" |
984263bc MD |
42 | .Sh DESCRIPTION |
43 | The | |
44 | .Fn pthread_cond_timedwait | |
45 | function atomically blocks the current thread waiting on the condition | |
46 | variable specified by | |
47 | .Fa cond , | |
15acf97d | 48 | and releases the mutex specified by |
984263bc MD |
49 | .Fa mutex . |
50 | The waiting thread unblocks only after another thread calls | |
51 | .Xr pthread_cond_signal 3 , | |
52 | or | |
53 | .Xr pthread_cond_broadcast 3 | |
54 | with the same condition variable, or if the system time reaches the | |
55 | time specified in | |
56 | .Fa abstime , | |
57 | and the current thread reacquires the lock on | |
58 | .Fa mutex . | |
59 | .Sh RETURN VALUES | |
60 | If successful, the | |
61 | .Fn pthread_cond_timedwait | |
62 | function will return zero. | |
63 | Otherwise an error number will be returned to | |
64 | indicate the error. | |
65 | .Sh ERRORS | |
15acf97d | 66 | The |
984263bc | 67 | .Fn pthread_cond_timedwait |
15acf97d | 68 | function will fail if: |
984263bc MD |
69 | .Bl -tag -width Er |
70 | .It Bq Er EINVAL | |
71 | The value specified by | |
72 | .Fa cond , | |
73 | .Fa mutex | |
74 | or | |
75 | .Fa abstime | |
76 | is invalid. | |
77 | .It Bq Er ETIMEDOUT | |
78 | The system time has reached or exceeded the time specified in | |
79 | .Fa abstime . | |
15acf97d SW |
80 | .\".It Bq Er EPERM |
81 | .\"The specified | |
82 | .\".Fa mutex | |
83 | .\"was not locked by the calling thread. | |
984263bc MD |
84 | .El |
85 | .Sh SEE ALSO | |
86 | .Xr pthread_cond_broadcast 3 , | |
87 | .Xr pthread_cond_destroy 3 , | |
88 | .Xr pthread_cond_init 3 , | |
89 | .Xr pthread_cond_signal 3 , | |
90 | .Xr pthread_cond_wait 3 | |
91 | .Sh STANDARDS | |
15acf97d | 92 | The |
984263bc | 93 | .Fn pthread_cond_timedwait |
15acf97d | 94 | function conforms to |
984263bc | 95 | .St -p1003.1-96 . |