1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
24 * Use is subject to license terms.
25 */
26
27#ifndef	_THREAD_H
28#define	_THREAD_H
29
30#pragma ident	"%Z%%M%	%I%	%E% SMI"
31
32/*
33 * thread.h:
34 * definitions needed to use the thread interface except synchronization.
35 * use <synch.h> for thread synchronization.
36 */
37
38#ifndef _ASM
39#include <sys/signal.h>
40#include <sys/time.h>
41#include <synch.h>
42#endif	/* _ASM */
43
44#ifdef __cplusplus
45extern "C" {
46#endif
47
48#ifndef _ASM
49typedef unsigned int thread_t;
50typedef unsigned int thread_key_t;
51#endif /* _ASM */
52
53#ifndef _ASM
54#ifdef __STDC__
55
56extern int thr_create(void *, size_t, void *(*)(void *), void *, long,
57			thread_t *);
58extern int thr_join(thread_t, thread_t *, void **);
59extern int thr_setconcurrency(int);
60extern int thr_getconcurrency(void);
61extern void thr_exit(void *) __NORETURN;
62extern thread_t thr_self(void);
63
64/*
65 * the definition of thr_sigsetmask() is not strict ansi-c since sigset_t is
66 * not in the strict ansi-c name space. Hence, include the prototype for
67 * thr_sigsetmask() only if strict ansi-c conformance is not turned on.
68 */
69#if !defined(_STRICT_STDC) || defined(__EXTENSIONS__)
70extern int thr_sigsetmask(int, const sigset_t *, sigset_t *);
71#endif
72
73/*
74 * the definition of thr_stksegment() is not strict ansi-c since stack_t is
75 * not in the strict ansi-c name space. Hence, include the prototype for
76 * thr_stksegment() only if strict ansi-c conformance is not turned on.
77 */
78#if !defined(_STRICT_STDC) || defined(__EXTENSIONS__)
79extern int thr_stksegment(stack_t *);
80#endif
81
82extern int thr_main(void);
83extern int thr_kill(thread_t, int);
84extern int thr_suspend(thread_t);
85extern int thr_continue(thread_t);
86extern void thr_yield(void);
87extern int thr_setprio(thread_t, int);
88extern int thr_getprio(thread_t, int *);
89extern int thr_keycreate(thread_key_t *, void(*)(void *));
90extern int thr_keycreate_once(thread_key_t *, void(*)(void *));
91extern int thr_setspecific(thread_key_t, void *);
92extern int thr_getspecific(thread_key_t, void **);
93extern size_t thr_min_stack(void);
94
95#else /* __STDC */
96
97extern int thr_create();
98extern int thr_join();
99extern int thr_setconcurrency();
100extern int thr_getconcurrency();
101extern void thr_exit();
102extern thread_t	thr_self();
103extern int thr_sigsetmask();
104extern int thr_stksegment();
105extern int thr_main();
106extern int thr_kill();
107extern int thr_suspend();
108extern int thr_continue();
109extern void thr_yield();
110extern int thr_setprio();
111extern int thr_getprio();
112extern int thr_keycreate();
113extern int thr_keycreate_once();
114extern int thr_setspecific();
115extern int thr_getspecific();
116extern size_t thr_min_stack();
117
118#endif /* __STDC */
119#endif /* _ASM */
120
121#define	THR_MIN_STACK	thr_min_stack()
122/*
123 * thread flags (one word bit mask)
124 */
125/*
126 * POSIX.1c Note:
127 * THR_BOUND is defined same as PTHREAD_SCOPE_SYSTEM in <pthread.h>
128 * THR_DETACHED is defined same as PTHREAD_CREATE_DETACHED in <pthread.h>
129 * Any changes in these definitions should be reflected in <pthread.h>
130 */
131#define	THR_BOUND		0x00000001	/* = PTHREAD_SCOPE_SYSTEM */
132#define	THR_NEW_LWP		0x00000002
133#define	THR_DETACHED		0x00000040	/* = PTHREAD_CREATE_DETACHED */
134#define	THR_SUSPENDED		0x00000080
135#define	THR_DAEMON		0x00000100
136
137/*
138 * The key to be created by thr_keycreate_once()
139 * must be statically initialized with THR_ONCE_KEY.
140 * This must be the same as PTHREAD_ONCE_KEY_NP in <pthread.h>
141 */
142#define	THR_ONCE_KEY	(thread_key_t)(-1)
143
144/*
145 * The available register states returned by thr_getstate().
146 */
147#define	TRS_VALID	0
148#define	TRS_NONVOLATILE	1
149#define	TRS_LWPID	2
150#define	TRS_INVALID	3
151
152#ifdef __cplusplus
153}
154#endif
155
156#endif	/* _THREAD_H */
157