thread.h revision 290001
1/*
2 * Copyright (C) 2004, 2005, 2007  Internet Systems Consortium, Inc. ("ISC")
3 * Copyright (C) 1998-2001  Internet Software Consortium.
4 *
5 * Permission to use, copy, modify, and/or distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
8 *
9 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 * PERFORMANCE OF THIS SOFTWARE.
16 */
17
18/* $Id: thread.h,v 1.26 2007/06/19 23:47:18 tbox Exp $ */
19
20#ifndef ISC_THREAD_H
21#define ISC_THREAD_H 1
22
23/*! \file */
24
25#include <pthread.h>
26
27#include <isc/lang.h>
28#include <isc/result.h>
29
30ISC_LANG_BEGINDECLS
31
32typedef pthread_t isc_thread_t;
33typedef void * isc_threadresult_t;
34typedef void * isc_threadarg_t;
35typedef isc_threadresult_t (*isc_threadfunc_t)(isc_threadarg_t);
36typedef pthread_key_t isc_thread_key_t;
37
38isc_result_t
39isc_thread_create(isc_threadfunc_t, isc_threadarg_t, isc_thread_t *);
40
41void
42isc_thread_setconcurrency(unsigned int level);
43
44/* XXX We could do fancier error handling... */
45
46#define isc_thread_join(t, rp) \
47	((pthread_join((t), (rp)) == 0) ? \
48	 ISC_R_SUCCESS : ISC_R_UNEXPECTED)
49
50#define isc_thread_self \
51	(unsigned long)pthread_self
52
53#define isc_thread_key_create pthread_key_create
54#define isc_thread_key_getspecific pthread_getspecific
55#define isc_thread_key_setspecific pthread_setspecific
56#define isc_thread_key_delete pthread_key_delete
57
58ISC_LANG_ENDDECLS
59
60#endif /* ISC_THREAD_H */
61