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 */