1 | .. SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
2 | |
---|
3 | .. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de) |
---|
4 | .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) |
---|
5 | |
---|
6 | .. This file is part of the RTEMS quality process and was automatically |
---|
7 | .. generated. If you find something that needs to be fixed or |
---|
8 | .. worded better please post a report or patch to an RTEMS mailing list |
---|
9 | .. or raise a bug report: |
---|
10 | .. |
---|
11 | .. https://www.rtems.org/bugs.html |
---|
12 | .. |
---|
13 | .. For information on updating and regenerating please refer to the How-To |
---|
14 | .. section in the Software Requirements Engineering chapter of the |
---|
15 | .. RTEMS Software Engineering manual. The manual is provided as a part of |
---|
16 | .. a release. For development sources please refer to the online |
---|
17 | .. documentation at: |
---|
18 | .. |
---|
19 | .. https://docs.rtems.org |
---|
20 | |
---|
21 | .. Generated from spec:/acfg/if/group-posixinit |
---|
22 | |
---|
23 | POSIX Initialization Thread Configuration |
---|
24 | ========================================= |
---|
25 | |
---|
26 | This section describes configuration options related to the POSIX |
---|
27 | initialization thread. |
---|
28 | |
---|
29 | .. Generated from spec:/acfg/if/posix-init-thread-entry-point |
---|
30 | |
---|
31 | .. raw:: latex |
---|
32 | |
---|
33 | \clearpage |
---|
34 | |
---|
35 | .. index:: CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT |
---|
36 | |
---|
37 | .. _CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT: |
---|
38 | |
---|
39 | CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT |
---|
40 | --------------------------------------- |
---|
41 | |
---|
42 | .. rubric:: CONSTANT: |
---|
43 | |
---|
44 | ``CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT`` |
---|
45 | |
---|
46 | .. rubric:: OPTION TYPE: |
---|
47 | |
---|
48 | This configuration option is an initializer define. |
---|
49 | |
---|
50 | .. rubric:: DEFAULT VALUE: |
---|
51 | |
---|
52 | The default value is ``POSIX_Init``. |
---|
53 | |
---|
54 | .. rubric:: DESCRIPTION: |
---|
55 | |
---|
56 | The value of this configuration option initializes the entry point of the |
---|
57 | POSIX API initialization thread. |
---|
58 | |
---|
59 | .. rubric:: NOTES: |
---|
60 | |
---|
61 | The application shall provide the function referenced by this configuration |
---|
62 | option. |
---|
63 | |
---|
64 | .. rubric:: CONSTRAINTS: |
---|
65 | |
---|
66 | The value of the configuration option shall be defined to a valid function |
---|
67 | pointer of the type ``void *( *entry_point )( void * )``. |
---|
68 | |
---|
69 | .. Generated from spec:/acfg/if/posix-init-thread-stack-size |
---|
70 | |
---|
71 | .. raw:: latex |
---|
72 | |
---|
73 | \clearpage |
---|
74 | |
---|
75 | .. index:: CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE |
---|
76 | |
---|
77 | .. _CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE: |
---|
78 | |
---|
79 | CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE |
---|
80 | -------------------------------------- |
---|
81 | |
---|
82 | .. rubric:: CONSTANT: |
---|
83 | |
---|
84 | ``CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE`` |
---|
85 | |
---|
86 | .. rubric:: OPTION TYPE: |
---|
87 | |
---|
88 | This configuration option is an integer define. |
---|
89 | |
---|
90 | .. rubric:: DEFAULT VALUE: |
---|
91 | |
---|
92 | The default value is :ref:`CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE`. |
---|
93 | |
---|
94 | .. rubric:: DESCRIPTION: |
---|
95 | |
---|
96 | The value of this configuration option defines the thread stack size of the |
---|
97 | POSIX API initialization thread. |
---|
98 | |
---|
99 | .. rubric:: CONSTRAINTS: |
---|
100 | |
---|
101 | The following constraints apply to this configuration option: |
---|
102 | |
---|
103 | * The value of the configuration option shall be greater than or equal to |
---|
104 | :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. |
---|
105 | |
---|
106 | * The value of the configuration option shall be small enough so that the task |
---|
107 | stack space calculation carried out by ``<rtems/confdefs.h>`` does not |
---|
108 | overflow an integer of type `uintptr_t |
---|
109 | <https://en.cppreference.com/w/c/types/integer>`_. |
---|
110 | |
---|
111 | .. Generated from spec:/acfg/if/posix-init-thread-table |
---|
112 | |
---|
113 | .. raw:: latex |
---|
114 | |
---|
115 | \clearpage |
---|
116 | |
---|
117 | .. index:: CONFIGURE_POSIX_INIT_THREAD_TABLE |
---|
118 | |
---|
119 | .. _CONFIGURE_POSIX_INIT_THREAD_TABLE: |
---|
120 | |
---|
121 | CONFIGURE_POSIX_INIT_THREAD_TABLE |
---|
122 | --------------------------------- |
---|
123 | |
---|
124 | .. rubric:: CONSTANT: |
---|
125 | |
---|
126 | ``CONFIGURE_POSIX_INIT_THREAD_TABLE`` |
---|
127 | |
---|
128 | .. rubric:: OPTION TYPE: |
---|
129 | |
---|
130 | This configuration option is a boolean feature define. |
---|
131 | |
---|
132 | .. rubric:: DEFAULT CONFIGURATION: |
---|
133 | |
---|
134 | If this configuration option is undefined, then the described feature is not |
---|
135 | enabled. |
---|
136 | |
---|
137 | .. rubric:: DESCRIPTION: |
---|
138 | |
---|
139 | In case this configuration option is defined, then exactly one POSIX |
---|
140 | initialization thread is configured. |
---|
141 | |
---|
142 | .. rubric:: NOTES: |
---|
143 | |
---|
144 | The application shall define exactly one of the following configuration |
---|
145 | options |
---|
146 | |
---|
147 | * :ref:`CONFIGURE_RTEMS_INIT_TASKS_TABLE`, |
---|
148 | |
---|
149 | * ``CONFIGURE_POSIX_INIT_THREAD_TABLE``, or |
---|
150 | |
---|
151 | * :ref:`CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION` |
---|
152 | |
---|
153 | otherwise a compile time error in the configuration file will occur. |
---|