Sync usage with man page.
[netbsd-mini2440.git] / external / bsd / ntp / dist / lib / isc / pthreads / condition.c
blobf219c27880eae15a6ea7d4203a9b1e4f8b15f5d3
1 /* $NetBSD$ */
3 /*
4 * Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
5 * Copyright (C) 1998-2001 Internet Software Consortium.
7 * Permission to use, copy, modify, and/or distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
11 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
12 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
13 * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
14 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
16 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17 * PERFORMANCE OF THIS SOFTWARE.
20 /* Id: condition.c,v 1.36 2007/06/19 23:47:18 tbox Exp */
22 /*! \file */
24 #include <config.h>
26 #include <errno.h>
28 #include <isc/condition.h>
29 #include <isc/msgs.h>
30 #include <isc/strerror.h>
31 #include <isc/string.h>
32 #include <isc/time.h>
33 #include <isc/util.h>
35 isc_result_t
36 isc_condition_waituntil(isc_condition_t *c, isc_mutex_t *m, isc_time_t *t) {
37 int presult;
38 isc_result_t result;
39 struct timespec ts;
40 char strbuf[ISC_STRERRORSIZE];
42 REQUIRE(c != NULL && m != NULL && t != NULL);
45 * POSIX defines a timespec's tv_sec as time_t.
47 result = isc_time_secondsastimet(t, &ts.tv_sec);
48 if (result != ISC_R_SUCCESS)
49 return (result);
51 /*!
52 * POSIX defines a timespec's tv_nsec as long. isc_time_nanoseconds
53 * ensures its return value is < 1 billion, which will fit in a long.
55 ts.tv_nsec = (long)isc_time_nanoseconds(t);
57 do {
58 #if ISC_MUTEX_PROFILE
59 presult = pthread_cond_timedwait(c, &m->mutex, &ts);
60 #else
61 presult = pthread_cond_timedwait(c, m, &ts);
62 #endif
63 if (presult == 0)
64 return (ISC_R_SUCCESS);
65 if (presult == ETIMEDOUT)
66 return (ISC_R_TIMEDOUT);
67 } while (presult == EINTR);
69 isc__strerror(presult, strbuf, sizeof(strbuf));
70 UNEXPECTED_ERROR(__FILE__, __LINE__,
71 "pthread_cond_timedwait() %s %s",
72 isc_msgcat_get(isc_msgcat, ISC_MSGSET_GENERAL,
73 ISC_MSG_RETURNED, "returned"),
74 strbuf);
75 return (ISC_R_UNEXPECTED);