unified MX27, MX25, MX37 trees
[karo-tx-redboot.git] / packages / compat / posix / v2_0 / cdl / pthread.cdl
1 # ====================================================================
2 #
3 #      pthread.cdl
4 #
5 #      POSIX pthread configuration data
6 #
7 # ====================================================================
8 #####ECOSGPLCOPYRIGHTBEGIN####
9 ## -------------------------------------------
10 ## This file is part of eCos, the Embedded Configurable Operating System.
11 ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
12 ##
13 ## eCos is free software; you can redistribute it and/or modify it under
14 ## the terms of the GNU General Public License as published by the Free
15 ## Software Foundation; either version 2 or (at your option) any later version.
16 ##
17 ## eCos is distributed in the hope that it will be useful, but WITHOUT ANY
18 ## WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
20 ## for more details.
21 ##
22 ## You should have received a copy of the GNU General Public License along
23 ## with eCos; if not, write to the Free Software Foundation, Inc.,
24 ## 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
25 ##
26 ## As a special exception, if other files instantiate templates or use macros
27 ## or inline functions from this file, or you compile this file and link it
28 ## with other works to produce a work based on this file, this file does not
29 ## by itself cause the resulting work to be covered by the GNU General Public
30 ## License. However the source code for this file must still be made available
31 ## in accordance with section (3) of the GNU General Public License.
32 ##
33 ## This exception does not invalidate any other reasons why a work based on
34 ## this file might be covered by the GNU General Public License.
35 ##
36 ## Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
37 ## at http://sources.redhat.com/ecos/ecos-license/
38 ## -------------------------------------------
39 #####ECOSGPLCOPYRIGHTEND####
40 # ====================================================================
41 ######DESCRIPTIONBEGIN####
42 #
43 # Author(s):      nickg
44 # Contributors:   jlarmour
45 # Date:           2000-3-28
46 #
47 #####DESCRIPTIONEND####
48 #
49 # ====================================================================
50
51 cdl_option CYGPKG_POSIX_PTHREAD_REQUIREMENTS {
52         display         "Generic requirements of pthread package"
53         flavor          bool
54         calculated      1
55         implements      CYGINT_ISO_PTHREADTYPES
56         implements      CYGINT_ISO_PTHREAD_IMPL
57         requires        CYGPKG_POSIX_SCHED
58         requires        CYGSEM_KERNEL_SCHED_TIMESLICE_ENABLE
59         requires        CYGSEM_KERNEL_SCHED_ASR_SUPPORT
60         requires        CYGSEM_KERNEL_SCHED_ASR_GLOBAL
61         requires        !CYGSEM_KERNEL_SCHED_ASR_DATA_GLOBAL
62         requires        CYGFUN_KERNEL_THREADS_STACK_LIMIT
63         requires        { CYGBLD_ISO_PTHREADTYPES_HEADER == \
64                           "<cyg/posix/types.h>" }
65         requires        { CYGBLD_ISO_PTHREAD_IMPL_HEADER == \
66                           "<cyg/posix/pthread.h>" }
67         description     "This option exists merely to carry the pthread
68                          package requirements."
69
70 }
71
72 # ====================================================================
73
74 cdl_component CYGPKG_POSIX_PTHREAD_VALUES {
75     display          "Constant values used in pthread package"
76     flavor           bool
77     calculated       1
78     description      "These are values that are either configurable, or derived
79                      from system parameters."
80
81     cdl_option CYGNUM_POSIX_PTHREAD_DESTRUCTOR_ITERATIONS {
82         display          "Maximum number of iterations of key destructors"
83         flavor           data
84         legal_values     4 to 100
85         default_value    4
86         description      "Maximum number of iterations of key destructors allowed."
87     }
88
89     cdl_option CYGNUM_POSIX_PTHREAD_KEYS_MAX {
90         display          "Maximum number of per-thread data keys allowed"
91         flavor           data
92         legal_values     128 to 65535
93         default_value    128
94         description      "Number of per-thread data keys supported."
95     }
96
97         cdl_option CYGNUM_POSIX_PTHREAD_THREADS_MAX {
98         display          "Maximum number of threads allowed"
99         flavor           data
100         legal_values     64 to 1024
101         default_value    64
102         description      "Maximum number of threads supported."
103     }
104
105 }
106
107 # ====================================================================
108
109 cdl_component CYGPKG_POSIX_PTHREAD_FEATURES {
110         display         "Fixed Feature test macros for POSIX"
111         flavor          bool
112         calculated      1
113         description     "These options define POSIX feature test macros that
114                          describe the eCos implementation of pthreads. These
115                          are not changeable configuration options."
116
117     cdl_option _POSIX_THREADS {
118         display         "POSIX thread support feature test macro"
119         flavor          bool
120         calculated      1
121         requires        CYGSEM_KERNEL_SCHED_TIMESLICE
122         requires        CYGVAR_KERNEL_THREADS_DATA
123         description     "This option defines the POSIX feature test macro
124                         for thread support."
125     }
126
127     cdl_option _POSIX_THREAD_PRIORITY_SCHEDULING {
128         display         "POSIX thread priority scheduling feature test macro"
129         flavor          bool
130         calculated      1
131         requires        CYGSEM_KERNEL_SCHED_MLQUEUE
132         requires      _POSIX_THREADS
133         description     "This option defines the POSIX feature test macro
134                         for thread priority scheduling support."
135     }
136
137     cdl_option _POSIX_THREAD_ATTR_STACKADDR {
138         display         "POSIX stack address attribute feature test macro"
139         flavor          bool
140         calculated      1
141         description     "This option defines the POSIX feature test macro
142                         for supporting the thread stack address in the thread
143                         attribute object."
144     }
145
146     cdl_option _POSIX_THREAD_ATTR_STACKSIZE {
147         display         "POSIX stack size attribute feature test macro"
148         flavor          bool
149         calculated      1
150         description     "This option defines the POSIX feature test macro
151                         for supporting the thread stack size in the thread
152                         attribute object."
153     }
154
155     cdl_option _POSIX_THREAD_PROCESS_SHARED {
156         display         "POSIX process shared attribute feature test macro"
157         flavor          bool
158         calculated      0
159         description     "This option defines the POSIX feature test macro
160                         for supporting process shared mutexes. Since eCos
161                         does not have processes, this attribute is undefined."
162     }
163
164 }
165
166 # ====================================================================
167
168 cdl_component CYGPKG_POSIX_MAIN_THREAD {
169         display         "Main thread configuration"
170         flavor          bool
171         calculated      1
172         requires        { 0 != CYGPKG_LIBC_STARTUP }
173         requires        CYGSEM_LIBC_STARTUP_MAIN_OTHER
174         implements      CYGINT_LIBC_STARTUP_EXTERNAL_INVOKE_MAIN_POSSIBLE
175         description     "These options control the thread used to
176                          run the main() application entry routine."
177                          
178         cdl_option CYGNUM_POSIX_MAIN_DEFAULT_PRIORITY {
179              display        "main()'s default thread priority"
180              flavor         data
181              legal_values   0 to 31
182              default_value  16
183              description    "
184                 POSIX compatibility requires that the application's
185                 main() function be invoked in a thread.
186                 This option controls the priority of that thread. This
187                 priority is the POSIX priority and is NOT the same as
188                 an eCos thread priority. With POSIX thread priorities,
189                 lower numbers are lower priority, and higher numbers are
190                 higher priority."
191         }
192 }
193
194 # ====================================================================
195 # End of pthread.cdl