ok
On Wed, Apr 28, 2021 at 11:30 PM Sebastian Huber <sebastian.hu...@embedded-brains.de> wrote: > > If only one constraint is present, then use a single sentence, otherwise > use a list for the constraints. Format the constraints so that the line > length limit is maintained. > --- > c-user/config/bdbuf.rst | 94 ++++++++++----- > c-user/config/bsp-related.rst | 22 ++-- > c-user/config/classic-api.rst | 176 ++++++++++++++-------------- > c-user/config/classic-init-task.rst | 28 +++-- > c-user/config/device-driver.rst | 18 +-- > c-user/config/event-record.rst | 11 +- > c-user/config/filesystem.rst | 6 +- > c-user/config/general.rst | 114 ++++++++++-------- > c-user/config/idle-task.rst | 12 +- > c-user/config/mpci.rst | 50 +++++--- > c-user/config/posix-api.rst | 168 +++++++++++++------------- > c-user/config/posix-init-thread.rst | 11 +- > c-user/config/scheduler-general.rst | 28 ++--- > c-user/config/task-stack-alloc.rst | 6 +- > 14 files changed, 414 insertions(+), 330 deletions(-) > > diff --git a/c-user/config/bdbuf.rst b/c-user/config/bdbuf.rst > index 7377bee..c5381e1 100644 > --- a/c-user/config/bdbuf.rst > +++ b/c-user/config/bdbuf.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -76,9 +76,10 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be an integral multiple of > :ref:`CONFIGURE_BDBUF_BUFFER_MIN_SIZE`. > + * It shall be an integral multiple of > + :ref:`CONFIGURE_BDBUF_BUFFER_MIN_SIZE`. > > DESCRIPTION: > The value of this configuration option defines the maximum size of a > buffer > @@ -106,8 +107,13 @@ DEFAULT VALUE: > The default value is 512. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the minimum size of a > buffer > @@ -135,8 +141,13 @@ DEFAULT VALUE: > The default value is 32768. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > DESCRIPTION: > The value of this configuration option defines the size of the cache > memory > @@ -164,8 +175,13 @@ DEFAULT VALUE: > The default value is 0. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum blocks per > @@ -195,8 +211,13 @@ DEFAULT VALUE: > The default value is 16. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum blocks per > write > @@ -225,7 +246,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be a valid Classic API task > - priority. The set of valid task priorities is scheduler-specific. > + priority. The set of valid task priorities depends on the scheduler > + configuration. > > DESCRIPTION: > The value of this configuration option defines the read-ahead task > priority. > @@ -255,15 +277,16 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to > :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > + * It shall be greater than or equal to > + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the task stack size of the > @@ -291,8 +314,13 @@ DEFAULT VALUE: > The default value is 1000. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the swapout task maximum > block > @@ -320,8 +348,13 @@ DEFAULT VALUE: > The default value is 250. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the swapout task swap > period > @@ -350,7 +383,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be a valid Classic API task > - priority. The set of valid task priorities is scheduler-specific. > + priority. The set of valid task priorities depends on the scheduler > + configuration. > > DESCRIPTION: > The value of this configuration option defines the swapout task priority. > @@ -377,8 +411,13 @@ DEFAULT VALUE: > The default value is 0. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the swapout worker task > count. > @@ -406,7 +445,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be a valid Classic API task > - priority. The set of valid task priorities is scheduler-specific. > + priority. The set of valid task priorities depends on the scheduler > + configuration. > > DESCRIPTION: > The value of this configuration option defines the swapout worker task > diff --git a/c-user/config/bsp-related.rst b/c-user/config/bsp-related.rst > index e56cee4..4b6848d 100644 > --- a/c-user/config/bsp-related.rst > +++ b/c-user/config/bsp-related.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -87,12 +87,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > - * It shall be small enough so that the IDLE > - task stack area calculation carried out by ``<rtems/confdefs.h>`` does > not > - overflow an integer of type `size_t > <https://en.cppreference.com/w/c/types/size_t>`_. > + * It shall be small enough so that the IDLE task stack area calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `size_t <https://en.cppreference.com/w/c/types/size_t>`_. > > DESCRIPTION: > If > @@ -165,12 +165,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > - * It shall be small enough so that the > - interrupt stack area calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `size_t > <https://en.cppreference.com/w/c/types/size_t>`_. > + * It shall be small enough so that the interrupt stack area calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `size_t <https://en.cppreference.com/w/c/types/size_t>`_. > > * It shall be aligned according to > :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`. > diff --git a/c-user/config/classic-api.rst b/c-user/config/classic-api.rst > index 74a8257..4643572 100644 > --- a/c-user/config/classic-api.rst > +++ b/c-user/config/classic-api.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -47,18 +47,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -90,18 +90,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -135,18 +135,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -178,18 +178,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -221,18 +221,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -264,18 +264,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -307,18 +307,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -354,22 +354,22 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -414,11 +414,13 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > - * It shall be an integral multiple of > :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT`. > + * It shall be an integral multiple of > + :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT`. > > DESCRIPTION: > If the value of this configuration option is greater than zero, then it > @@ -466,18 +468,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -509,13 +511,13 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > Classic > @@ -543,8 +545,12 @@ DEFAULT VALUE: > The default value is 0. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to :ref:`CONFIGURE_MAXIMUM_TASKS`. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to :ref:`CONFIGURE_MAXIMUM_TASKS`. > > DESCRIPTION: > The value of this configuration option defines the minimum count of > Classic > diff --git a/c-user/config/classic-init-task.rst > b/c-user/config/classic-init-task.rst > index 0743929..9c0435b 100644 > --- a/c-user/config/classic-init-task.rst > +++ b/c-user/config/classic-init-task.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -45,8 +45,8 @@ DEFAULT VALUE: > The default value is 0. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be a valid integer of type > - :c:type:`rtems_task_argument`. > + The value of this configuration option shall be convertible to an integer > + of type :c:type:`rtems_task_argument`. > > DESCRIPTION: > The value of this configuration option defines task argument of the > Classic > @@ -107,10 +107,10 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to > :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > + * It shall be greater than or equal to > + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > > - * It shall be defined using > - :c:func:`RTEMS_TASK_STORAGE_SIZE`. > + * It shall be defined using :c:func:`RTEMS_TASK_STORAGE_SIZE`. > > DESCRIPTION: > The value of this configuration option defines the task storage size of > the > @@ -222,8 +222,8 @@ DEFAULT VALUE: > The default value is ``rtems_build_name( 'U', 'I', '1', ' ' )``. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be a valid integer of type > - :c:type:`rtems_name`. > + The value of this configuration option shall be convertible to an integer > + of type :c:type:`rtems_name`. > > DESCRIPTION: > The value of this configuration option defines the name of the Classic > API > @@ -252,7 +252,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be a valid Classic API task > - priority. The set of valid task priorities is scheduler-specific. > + priority. The set of valid task priorities depends on the scheduler > + configuration. > > DESCRIPTION: > The value of this configuration option defines the initial priority of > the > @@ -283,11 +284,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to > :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > + * It shall be greater than or equal to > + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the task stack size of the > diff --git a/c-user/config/device-driver.rst b/c-user/config/device-driver.rst > index 05ae08a..22002f9 100644 > --- a/c-user/config/device-driver.rst > +++ b/c-user/config/device-driver.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -594,7 +594,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be a valid Classic API task > - priority. The set of valid task priorities is scheduler-specific. > + priority. The set of valid task priorities depends on the scheduler > + configuration. > > DESCRIPTION: > The value of this configuration option defines the ATA task priority. > @@ -661,14 +662,15 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > - * It shall be greater than or equal than the number of statically > configured > - device drivers. > + * It shall be greater than or equal than the number of statically > + configured device drivers. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the number of device > drivers. > diff --git a/c-user/config/event-record.rst b/c-user/config/event-record.rst > index cbe02e3..fa1d011 100644 > --- a/c-user/config/event-record.rst > +++ b/c-user/config/event-record.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2019, 2020 embedded brains GmbH > (http://www.embedded-brains.de) > +.. Copyright (C) 2019, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > > .. This file is part of the RTEMS quality process and was automatically > .. generated. If you find something that needs to be fixed or > @@ -147,13 +147,14 @@ VALUE CONSTRAINTS: > > * It shall be greater than or equal to 16. > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > * It shall be a power of two. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the event record item > count > diff --git a/c-user/config/filesystem.rst b/c-user/config/filesystem.rst > index 5b1b414..05ca826 100644 > --- a/c-user/config/filesystem.rst > +++ b/c-user/config/filesystem.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -739,8 +739,8 @@ DEFAULT VALUE: > The default value is 128. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be > - an element of {16, 32, 64, 128, 256, 512}. > + The value of this configuration option shall be equal to 16, 32, 64, 128, > + 256, or 512. > > DESCRIPTION: > The value of this configuration option defines the block size for > in-memory > diff --git a/c-user/config/general.rst b/c-user/config/general.rst > index 024b5c4..203c3e8 100644 > --- a/c-user/config/general.rst > +++ b/c-user/config/general.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -111,13 +111,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `UINTPTR_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be less than or equal to `UINTPTR_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the RTEMS Workspace size > in > @@ -150,11 +151,11 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the number of bytes the > @@ -221,12 +222,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > - * It shall be small enough so that the > - interrupt stack area calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `size_t > <https://en.cppreference.com/w/c/types/size_t>`_. > + * It shall be small enough so that the interrupt stack area calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `size_t <https://en.cppreference.com/w/c/types/size_t>`_. > > * It shall be aligned according to > :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`. > @@ -306,13 +307,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the maximum number of file > @@ -341,8 +343,12 @@ DEFAULT VALUE: > The default value is 1. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 1 > - and less than or equal to :c:macro:`CPU_MAXIMUM_PROCESSORS`. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to one. > + > + * It shall be less than or equal to :c:macro:`CPU_MAXIMUM_PROCESSORS`. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > @@ -382,13 +388,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the maximum thread name > size > @@ -425,15 +432,15 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the number of kilobytes > the > @@ -472,15 +479,15 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the number of bytes > reserved > @@ -557,9 +564,11 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to a Clock Driver specific value. > + * It shall be greater than or equal to a value defined by the > :term:`Clock > + Driver`. > > - * It shall be less than or equal to a Clock Driver specific value. > + * It shall be less than or equal to a value defined by the :term:`Clock > + Driver`. > > * The resulting clock ticks per second should be an integer. > > @@ -612,12 +621,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > DESCRIPTION: > The value of this configuration option defines the minimum stack size in > @@ -695,8 +704,13 @@ DEFAULT VALUE: > The default value is 50. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the length of the > timeslice > diff --git a/c-user/config/idle-task.rst b/c-user/config/idle-task.rst > index 9330672..1234f42 100644 > --- a/c-user/config/idle-task.rst > +++ b/c-user/config/idle-task.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -129,12 +129,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > - * It shall be small enough so that the IDLE > - task stack area calculation carried out by ``<rtems/confdefs.h>`` does > not > - overflow an integer of type `size_t > <https://en.cppreference.com/w/c/types/size_t>`_. > + * It shall be small enough so that the IDLE task stack area calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `size_t <https://en.cppreference.com/w/c/types/size_t>`_. > > DESCRIPTION: > The value of this configuration option defines the task stack size for an > diff --git a/c-user/config/mpci.rst b/c-user/config/mpci.rst > index 0c967c6..800aa30 100644 > --- a/c-user/config/mpci.rst > +++ b/c-user/config/mpci.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -52,14 +52,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > - * It shall be small enough so that the > - MPCI receive server stack area calculation carried out by > - ``<rtems/confdefs.h>`` does not overflow an integer of type > - `size_t <https://en.cppreference.com/w/c/types/size_t>`_. > + * It shall be small enough so that the MPCI receive server stack area > + calculation carried out by ``<rtems/confdefs.h>`` does not overflow an > + integer of type `size_t > <https://en.cppreference.com/w/c/types/size_t>`_. > > DESCRIPTION: > The value of this configuration option defines the number of bytes the > @@ -119,8 +119,13 @@ DEFAULT VALUE: > The default value is 32. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > @@ -152,8 +157,13 @@ DEFAULT VALUE: > The default value is 2. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > nodes in > @@ -182,8 +192,13 @@ DEFAULT VALUE: > The default value is 32. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > @@ -252,8 +267,13 @@ DEFAULT VALUE: > The default value is ``NODE_NUMBER``. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be greater than or equal to > 0 > - and less than or equal to `UINT32_MAX > <https://en.cppreference.com/w/c/types/integer>`_. > + The value of this configuration option shall satisfy all of the following > + constraints: > + > + * It shall be greater than or equal to zero. > + > + * It shall be less than or equal to `UINT32_MAX > + <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the node number of this > node > diff --git a/c-user/config/posix-api.rst b/c-user/config/posix-api.rst > index 592a1ce..3c2c8a2 100644 > --- a/c-user/config/posix-api.rst > +++ b/c-user/config/posix-api.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -50,18 +50,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -96,18 +96,18 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of key > @@ -142,22 +142,22 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -191,20 +191,19 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It shall be zero if the POSIX API is not > - enabled (e.g. RTEMS was built without the ``--enable-posix`` build > - configuration option). Otherwise a compile time error in the > configuration > - file will occur. > + * It shall be zero if the POSIX API is not enabled (e.g. RTEMS was built > + without the ``RTEMS_POSIX_API = True`` build configuration option). > + Otherwise a compile time error in the configuration file will occur. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -238,22 +237,22 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -290,22 +289,22 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the > - RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` > does > - not overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the RTEMS Workspace size calculation > + carried out by ``<rtems/confdefs.h>`` does not overflow an integer of > + type `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -337,17 +336,17 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -389,23 +388,22 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > * It shall be less than or equal to 65535. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > - * It may be defined through > - :c:func:`rtems_resource_unlimited` the enable unlimited objects for > this > - object class, if the value passed to :c:func:`rtems_resource_unlimited` > - satisfies all other constraints of this configuration option. > + * It may be defined through :c:func:`rtems_resource_unlimited` the enable > + unlimited objects for the object class, if the value passed to > + :c:func:`rtems_resource_unlimited` satisfies all other constraints of > the > + configuration option. > > - * It shall be zero if the POSIX API is not > - enabled (e.g. RTEMS was built without the ``--enable-posix`` build > - configuration option). Otherwise a compile time error in the > configuration > - file will occur. > + * It shall be zero if the POSIX API is not enabled (e.g. RTEMS was built > + without the ``RTEMS_POSIX_API = True`` build configuration option). > + Otherwise a compile time error in the configuration file will occur. > > DESCRIPTION: > The value of this configuration option defines the maximum number of > POSIX > @@ -442,12 +440,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > - * It shall be greater than or equal to a > - BSP-specific and application-specific minimum value. > + * It shall be greater than or equal to a BSP-specific and > + application-specific minimum value. > > DESCRIPTION: > The value of this configuration option defines the minimum stack size in > diff --git a/c-user/config/posix-init-thread.rst > b/c-user/config/posix-init-thread.rst > index 42542e5..8623f2c 100644 > --- a/c-user/config/posix-init-thread.rst > +++ b/c-user/config/posix-init-thread.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -78,11 +78,12 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to > :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > + * It shall be greater than or equal to > + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`. > > - * It shall be small enough so that the task > - stack space calculation carried out by ``<rtems/confdefs.h>`` does not > - overflow an integer of type `uintptr_t > <https://en.cppreference.com/w/c/types/integer>`_. > + * It shall be small enough so that the task stack space calculation > carried > + out by ``<rtems/confdefs.h>`` does not overflow an integer of type > + `uintptr_t <https://en.cppreference.com/w/c/types/integer>`_. > > DESCRIPTION: > The value of this configuration option defines the thread stack size of > the > diff --git a/c-user/config/scheduler-general.rst > b/c-user/config/scheduler-general.rst > index cbdb145..4fe840f 100644 > --- a/c-user/config/scheduler-general.rst > +++ b/c-user/config/scheduler-general.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 2010 Gedare Bloom > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > @@ -69,13 +69,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be greater than or equal to 0. > + * It shall be greater than or equal to zero. > > - * It shall be less than or equal to `SIZE_MAX > <https://en.cppreference.com/w/c/types/limits>`_. > + * It shall be less than or equal to `SIZE_MAX > + <https://en.cppreference.com/w/c/types/limits>`_. > > - * It shall be less than or equal to a > - BSP-specific and application-specific value which depends on the size > of the > - memory available to the application. > + * It shall be less than or equal to a BSP-specific and > application-specific > + value which depends on the size of the memory available to the > + application. > > DESCRIPTION: > The value of this configuration option defines the maximum number > Constant > @@ -106,8 +107,8 @@ DEFAULT VALUE: > The default value is 255. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be > - an element of {3, 7, 31, 63, 127, 255}. > + The value of this configuration option shall be equal to 3, 7, 31, 63, > 127, > + or 255. > > DESCRIPTION: > For the following schedulers > @@ -168,15 +169,14 @@ VALUE CONSTRAINTS: > The value of this configuration option shall satisfy all of the following > constraints: > > - * It shall be a list of the following > - macros: > + * It shall be a list of the following macros: > > * ``RTEMS_SCHEDULER_ASSIGN( processor_index, attributes )`` > > * ``RTEMS_SCHEDULER_ASSIGN_NO_SCHEDULER`` > > - * It shall be a list of exactly > - :ref:`CONFIGURE_MAXIMUM_PROCESSORS` elements. > + * It shall be a list of exactly :ref:`CONFIGURE_MAXIMUM_PROCESSORS` > + elements. > > DESCRIPTION: > The value of this configuration option is used to initialize the initial > @@ -323,8 +323,8 @@ DEFAULT VALUE: > * ``"UPS "`` for the :ref:`SchedulerPrioritySimple`. > > VALUE CONSTRAINTS: > - The value of this configuration option shall be a valid integer of type > - :c:type:`rtems_name`. > + The value of this configuration option shall be convertible to an integer > + of type :c:type:`rtems_name`. > > DESCRIPTION: > The value of this configuration option defines the name of the default > diff --git a/c-user/config/task-stack-alloc.rst > b/c-user/config/task-stack-alloc.rst > index cd174ed..3f779ff 100644 > --- a/c-user/config/task-stack-alloc.rst > +++ b/c-user/config/task-stack-alloc.rst > @@ -1,6 +1,6 @@ > .. SPDX-License-Identifier: CC-BY-SA-4.0 > > -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > +.. Copyright (C) 2020, 2021 embedded brains GmbH > (http://www.embedded-brains.de) > .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) > > .. This file is part of the RTEMS quality process and was automatically > @@ -113,8 +113,8 @@ DEFAULT VALUE: > > VALUE CONSTRAINTS: > The value of this configuration option shall be defined to a valid > function > - pointer of the type ``void ( *initialize )( size_t )`` or to > - `NULL <https://en.cppreference.com/w/c/types/NULL>`_. > + pointer of the type ``void ( *initialize )( size_t )`` or to `NULL > + <https://en.cppreference.com/w/c/types/NULL>`_. > > DESCRIPTION: > The value of this configuration option initializes the stack allocator > -- > 2.26.2 > > _______________________________________________ > devel mailing list > devel@rtems.org > http://lists.rtems.org/mailman/listinfo/devel _______________________________________________ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
