xref: /titanic_51/usr/src/head/thread.h (revision 989f28072d20c73ae0955d6a1e3e2fc74831cb39)
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
45  extern "C" {
46  #endif
47  
48  #ifndef _ASM
49  typedef unsigned int thread_t;
50  typedef unsigned int thread_key_t;
51  #endif /* _ASM */
52  
53  #ifndef _ASM
54  #ifdef __STDC__
55  
56  extern int thr_create(void *, size_t, void *(*)(void *), void *, long,
57  			thread_t *);
58  extern int thr_join(thread_t, thread_t *, void **);
59  extern int thr_setconcurrency(int);
60  extern int thr_getconcurrency(void);
61  extern void thr_exit(void *) __NORETURN;
62  extern 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__)
70  extern 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__)
79  extern int thr_stksegment(stack_t *);
80  #endif
81  
82  extern int thr_main(void);
83  extern int thr_kill(thread_t, int);
84  extern int thr_suspend(thread_t);
85  extern int thr_continue(thread_t);
86  extern void thr_yield(void);
87  extern int thr_setprio(thread_t, int);
88  extern int thr_getprio(thread_t, int *);
89  extern int thr_keycreate(thread_key_t *, void(*)(void *));
90  extern int thr_keycreate_once(thread_key_t *, void(*)(void *));
91  extern int thr_setspecific(thread_key_t, void *);
92  extern int thr_getspecific(thread_key_t, void **);
93  extern size_t thr_min_stack(void);
94  
95  #else /* __STDC */
96  
97  extern int thr_create();
98  extern int thr_join();
99  extern int thr_setconcurrency();
100  extern int thr_getconcurrency();
101  extern void thr_exit();
102  extern thread_t	thr_self();
103  extern int thr_sigsetmask();
104  extern int thr_stksegment();
105  extern int thr_main();
106  extern int thr_kill();
107  extern int thr_suspend();
108  extern int thr_continue();
109  extern void thr_yield();
110  extern int thr_setprio();
111  extern int thr_getprio();
112  extern int thr_keycreate();
113  extern int thr_keycreate_once();
114  extern int thr_setspecific();
115  extern int thr_getspecific();
116  extern 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