[rtems-docs commit] c-user: Generate API type documentation
Sebastian Huber
sebh at rtems.org
Fri May 19 05:21:25 UTC 2023
Module: rtems-docs
Branch: master
Commit: e33eae15a79e9b58c381554a674905f371d9e1ec
Changeset: http://git.rtems.org/rtems-docs/commit/?id=e33eae15a79e9b58c381554a674905f371d9e1ec
Author: Sebastian Huber <sebastian.huber at embedded-brains.de>
Date: Tue May 9 12:53:20 2023 +0200
c-user: Generate API type documentation
Close #4901.
---
c-user/barrier/directives.rst | 12 +-
c-user/clock/directives.rst | 6 +-
c-user/config/classic-init-task.rst | 2 +-
c-user/config/device-driver.rst | 4 +-
c-user/config/general.rst | 2 +-
c-user/dual-ported-memory/directives.rst | 12 +-
c-user/interrupt/directives.rst | 28 +-
c-user/io/directives.rst | 2 +-
c-user/message/directives.rst | 19 +-
c-user/object-services/directives.rst | 8 +-
c-user/partition/directives.rst | 12 +-
c-user/rate-monotonic/directives.rst | 16 +-
c-user/region/directives.rst | 12 +-
c-user/rtems_data_types.rst | 1862 +++++++++++++++++++++++++----
c-user/scheduling-concepts/directives.rst | 26 +-
c-user/semaphore/directives.rst | 19 +-
c-user/task/directives.rst | 41 +-
c-user/timer/directives.rst | 14 +-
c-user/user-extensions/directives.rst | 12 +-
19 files changed, 1759 insertions(+), 350 deletions(-)
diff --git a/c-user/barrier/directives.rst b/c-user/barrier/directives.rst
index 59abc51..c51974c 100644
--- a/c-user/barrier/directives.rst
+++ b/c-user/barrier/directives.rst
@@ -67,9 +67,9 @@ Creates a barrier.
barrier.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created barrier will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created barrier
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -175,9 +175,9 @@ Identifies a barrier by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/clock/directives.rst b/c-user/clock/directives.rst
index d531918..e99c44e 100644
--- a/c-user/clock/directives.rst
+++ b/c-user/clock/directives.rst
@@ -137,7 +137,7 @@ Gets the time of day associated with the current :term:`CLOCK_REALTIME`.
.. rubric:: PARAMETERS:
``time_of_day``
- This parameter is the pointer to an :c:type:`rtems_time_of_day` object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTimeOfDay` object.
When the directive call is successful, the time of day associated with the
:term:`CLOCK_REALTIME` at some point during the directive call will be
stored in this object.
@@ -1086,8 +1086,8 @@ Gets the seconds elapsed since the :term:`RTEMS epoch` and the current
.. rubric:: PARAMETERS:
``seconds_since_rtems_epoch``
- This parameter is the pointer to an :c:type:`rtems_interval` object. When
- the directive call is successful, the seconds elapsed since the
+ This parameter is the pointer to an :ref:`InterfaceRtemsInterval` object.
+ When the directive call is successful, the seconds elapsed since the
:term:`RTEMS epoch` and the :term:`CLOCK_REALTIME` at some point during the
directive call will be stored in this object.
diff --git a/c-user/config/classic-init-task.rst b/c-user/config/classic-init-task.rst
index 4974356..2f3059e 100644
--- a/c-user/config/classic-init-task.rst
+++ b/c-user/config/classic-init-task.rst
@@ -59,7 +59,7 @@ API initialization task.
.. rubric:: CONSTRAINTS:
The value of the configuration option shall be convertible to an integer of
-type :c:type:`rtems_task_argument`.
+type :ref:`InterfaceRtemsTaskArgument`.
.. Generated from spec:/acfg/if/init-task-attributes
diff --git a/c-user/config/device-driver.rst b/c-user/config/device-driver.rst
index 971bb9e..9d46211 100644
--- a/c-user/config/device-driver.rst
+++ b/c-user/config/device-driver.rst
@@ -114,7 +114,7 @@ placement of application device driver initializers.
.. rubric:: CONSTRAINTS:
The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_driver_address_table`.
+structures of type :ref:`InterfaceRtemsDriverAddressTable`.
.. Generated from spec:/acfg/if/appl-needs-ata-driver
@@ -718,7 +718,7 @@ of application device driver initializers.
.. rubric:: CONSTRAINTS:
The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_driver_address_table`.
+structures of type :ref:`InterfaceRtemsDriverAddressTable`.
.. Generated from spec:/acfg/if/ata-driver-task-priority
diff --git a/c-user/config/general.rst b/c-user/config/general.rst
index e175ca1..65e8d36 100644
--- a/c-user/config/general.rst
+++ b/c-user/config/general.rst
@@ -328,7 +328,7 @@ initial user extensions.
.. rubric:: CONSTRAINTS:
The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_extensions_table`.
+structures of type :ref:`InterfaceRtemsExtensionsTable`.
.. Generated from spec:/acfg/if/interrupt-stack-size
diff --git a/c-user/dual-ported-memory/directives.rst b/c-user/dual-ported-memory/directives.rst
index 869fd4b..7b216a4 100644
--- a/c-user/dual-ported-memory/directives.rst
+++ b/c-user/dual-ported-memory/directives.rst
@@ -71,9 +71,9 @@ Creates a port.
This parameter is the length in bytes of the memory area.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created port will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created port will
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -158,9 +158,9 @@ Identifies a port by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/interrupt/directives.rst b/c-user/interrupt/directives.rst
index ee3e121..22d2c9b 100644
--- a/c-user/interrupt/directives.rst
+++ b/c-user/interrupt/directives.rst
@@ -63,9 +63,10 @@ Establishes an interrupt service routine.
This parameter is the interrupt vector number.
``old_isr_handler``
- This parameter is the pointer to an :c:type:`rtems_isr_entry` object. When
- the directive call is successful, the previous interrupt service routine
- established for this interrupt vector will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsIsrEntry` object.
+ When the directive call is successful, the previous interrupt service
+ routine established for this interrupt vector will be stored in this
+ object.
.. rubric:: DESCRIPTION:
@@ -133,8 +134,8 @@ Disables the maskable interrupts on the current processor.
.. rubric:: PARAMETERS:
``isr_cookie``
- This parameter is a variable of type :c:type:`rtems_interrupt_level` which
- will be used to save the previous interrupt level.
+ This parameter is a variable of type :ref:`InterfaceRtemsInterruptLevel`
+ which will be used to save the previous interrupt level.
.. rubric:: DESCRIPTION:
@@ -343,8 +344,8 @@ Disables the maskable interrupts on the current processor.
.. rubric:: PARAMETERS:
``isr_cookie``
- This parameter is a variable of type :c:type:`rtems_interrupt_level` which
- will be used to save the previous interrupt level.
+ This parameter is a variable of type :ref:`InterfaceRtemsInterruptLevel`
+ which will be used to save the previous interrupt level.
.. rubric:: DESCRIPTION:
@@ -2188,9 +2189,10 @@ Gets the attributes of the interrupt vector.
This parameter is the interrupt vector number.
``attributes``
- This parameter is the pointer to an :c:type:`rtems_interrupt_attributes`
- object. When the directive call is successful, the attributes of the
- interrupt vector will be stored in this object.
+ This parameter is the pointer to an
+ :ref:`InterfaceRtemsInterruptAttributes` object. When the directive call
+ is successful, the attributes of the interrupt vector will be stored in
+ this object.
.. rubric:: RETURN VALUES:
@@ -2418,9 +2420,9 @@ Creates an interrupt server.
``control``
This parameter is the pointer to an
- :c:type:`rtems_interrupt_server_control` object. When the directive call
- was successful, the ownership of the object was transferred from the caller
- of the directive to the interrupt server management.
+ :ref:`InterfaceRtemsInterruptServerControl` object. When the directive
+ call was successful, the ownership of the object was transferred from the
+ caller of the directive to the interrupt server management.
``config``
This parameter is the interrupt server configuration.
diff --git a/c-user/io/directives.rst b/c-user/io/directives.rst
index d308944..dcf0fc7 100644
--- a/c-user/io/directives.rst
+++ b/c-user/io/directives.rst
@@ -64,7 +64,7 @@ table and device major number in the Device Driver Table.
This parameter is the device driver address table.
``registered_major``
- This parameter is the pointer to an :c:type:`rtems_device_major_number`
+ This parameter is the pointer to an :ref:`InterfaceRtemsDeviceMajorNumber`
object. When the directive call is successful, the device major number of
the registered device will be stored in this object.
diff --git a/c-user/message/directives.rst b/c-user/message/directives.rst
index a13e4c7..d6e6eea 100644
--- a/c-user/message/directives.rst
+++ b/c-user/message/directives.rst
@@ -72,9 +72,9 @@ Creates a message queue.
This parameter is the attribute set of the message queue.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created message queue
- will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created message
+ queue will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -230,11 +230,12 @@ Constructs a message queue from the specified the message queue configuration.
.. rubric:: PARAMETERS:
``config``
- This parameter is the message queue configuration.
+ This parameter is the pointer to an :ref:`InterfaceRtemsMessageQueueConfig`
+ object. It configures the message queue.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the constructed message
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the constructed message
queue will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -361,9 +362,9 @@ Identifies a message queue by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/object-services/directives.rst b/c-user/object-services/directives.rst
index ba23add..b6f1dbe 100644
--- a/c-user/object-services/directives.rst
+++ b/c-user/object-services/directives.rst
@@ -168,9 +168,9 @@ Gets the object name associated with the object identifier.
This parameter is the object identifier to get the name.
``name``
- This parameter is the pointer to an :c:type:`rtems_name` object. When the
- directive call is successful, the object name associated with the object
- identifier will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsName` object. When
+ the directive call is successful, the object name associated with the
+ object identifier will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -802,7 +802,7 @@ Gets the object class information of the object class of the object API.
``info``
This parameter is the pointer to an
- :c:type:`rtems_object_api_class_information` object. When the directive
+ :ref:`InterfaceRtemsObjectApiClassInformation` object. When the directive
call is successful, the object class information of the class of the API
will be stored in this object.
diff --git a/c-user/partition/directives.rst b/c-user/partition/directives.rst
index 534cfb4..af512f6 100644
--- a/c-user/partition/directives.rst
+++ b/c-user/partition/directives.rst
@@ -76,9 +76,9 @@ Creates a partition.
This parameter is the attribute set of the partition.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created partition will
- be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created partition
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -241,9 +241,9 @@ Identifies a partition by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/rate-monotonic/directives.rst b/c-user/rate-monotonic/directives.rst
index b7374ff..50dcc13 100644
--- a/c-user/rate-monotonic/directives.rst
+++ b/c-user/rate-monotonic/directives.rst
@@ -56,9 +56,9 @@ Creates a period.
This parameter is the object name of the period.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created period will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created period will
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -133,9 +133,9 @@ Identifies a period by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -413,7 +413,7 @@ Gets the detailed status of the period.
``status``
This parameter is the pointer to an
- :c:type:`rtems_rate_monotonic_period_status` object. When the directive
+ :ref:`InterfaceRtemsRateMonotonicPeriodStatus` object. When the directive
call is successful, the detailed period status will be stored in this
object.
@@ -496,7 +496,7 @@ Gets the statistics of the period.
``status``
This parameter is the pointer to an
- :c:type:`rtems_rate_monotonic_period_statistics` object. When the
+ :ref:`InterfaceRtemsRateMonotonicPeriodStatistics` object. When the
directive call is successful, the period statistics will be stored in this
object.
diff --git a/c-user/region/directives.rst b/c-user/region/directives.rst
index e608f31..26f4623 100644
--- a/c-user/region/directives.rst
+++ b/c-user/region/directives.rst
@@ -77,9 +77,9 @@ Creates a region.
This parameter is the attribute set of the region.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created region will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created region will
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -193,9 +193,9 @@ Identifies a region by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/rtems_data_types.rst b/c-user/rtems_data_types.rst
index 121d37e..6b6757e 100644
--- a/c-user/rtems_data_types.rst
+++ b/c-user/rtems_data_types.rst
@@ -1,6 +1,22 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0
-.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+.. Copyright (C) 2008, 2021 embedded brains GmbH (http://www.embedded-brains.de)
+.. Copyright (C) 1988, 2017 On-Line Applications Research Corporation (OAR)
+
+.. This file is part of the RTEMS quality process and was automatically
+.. generated. If you find something that needs to be fixed or
+.. worded better please post a report or patch to an RTEMS mailing list
+.. or raise a bug report:
+..
+.. https://www.rtems.org/bugs.html
+..
+.. For information on updating and regenerating please refer to the How-To
+.. section in the Software Requirements Engineering chapter of the
+.. RTEMS Software Engineering manual. The manual is provided as a part of
+.. a release. For development sources please refer to the online
+.. documentation at:
+..
+.. https://docs.rtems.org
.. index:: RTEMS Data Types
.. index:: data types
@@ -8,6 +24,8 @@
RTEMS Data Types
****************
+.. _Introduction:
+
Introduction
============
@@ -16,368 +34,1754 @@ alphabetical order. This is intended to be an overview and the user is
encouraged to look at the appropriate chapters in the manual for more
information about the usage of the various data types.
+.. _ListOfDataTypes:
+
List of Data Types
==================
The following is a complete list of the RTEMS primitive data types in
alphabetical order:
-.. index:: rtems_address
+.. Generated from spec:/rtems/io/if/bsp-output-char-function-type
+
+.. index:: BSP_output_char_function_type
+
+.. _InterfaceBSPOutputCharFunctionType:
+
+BSP_output_char_function_type
+-----------------------------
+
+Polled character output functions shall have this type.
+
+.. Generated from spec:/rtems/io/if/bsp-polling-getchar-function-type
+
+.. index:: BSP_polling_getchar_function_type
+
+.. _InterfaceBSPPollingGetcharFunctionType:
+
+BSP_polling_getchar_function_type
+---------------------------------
+
+Polled character input functions shall have this type.
+
+.. Generated from spec:/rtems/timer/if/classes
+
+.. index:: Timer_Classes
+
+.. _InterfaceTimerClasses:
+
+Timer_Classes
+-------------
+
+The timer class indicates how the timer was most recently fired.
+
+.. rubric:: ENUMERATORS:
+
+TIMER_DORMANT
+ This timer class indicates that the timer was never in use.
+
+TIMER_INTERVAL
+ This timer class indicates that the timer is currently in use as an
+ interval timer which will fire in the context of the clock tick
+ :term:`ISR`.
+
+TIMER_INTERVAL_ON_TASK
+ This timer class indicates that the timer is currently in use as an
+ interval timer which will fire in the context of the Timer Server task.
+
+TIMER_TIME_OF_DAY
+ This timer class indicates that the timer is currently in use as an time of
+ day timer which will fire in the context of the clock tick :term:`ISR`.
+
+TIMER_TIME_OF_DAY_ON_TASK
+ This timer class indicates that the timer is currently in use as an time of
+ day timer which will fire in the context of the Timer Server task.
+
+.. Generated from spec:/rtems/config/if/api-table
+
+.. index:: rtems_api_configuration_table
+
+.. _InterfaceRtemsApiConfigurationTable:
+
+rtems_api_configuration_table
+-----------------------------
+
+This structure contains a summary of the Classic API configuration.
+
+.. rubric:: MEMBERS:
+
+maximum_tasks
+ This member contains the maximum number of Classic API Tasks configured for
+ this application. See :ref:`CONFIGURE_MAXIMUM_TASKS`.
+
+notepads_enabled
+ This member is true, if the Classic API Notepads are enabled, otherwise it
+ is false.
+
+maximum_timers
+ This member contains the maximum number of Classic API Timers configured
+ for this application. See :ref:`CONFIGURE_MAXIMUM_TIMERS`.
+
+maximum_semaphores
+ This member contains the maximum number of Classic API Semaphores
+ configured for this application. See :ref:`CONFIGURE_MAXIMUM_SEMAPHORES`.
-``rtems_address``
- The data type used to manage addresses. It is equivalent to a ``void *``
- pointer.
+maximum_message_queues
+ This member contains the maximum number of Classic API Message Queues
+ configured for this application. See
+ :ref:`CONFIGURE_MAXIMUM_MESSAGE_QUEUES`.
+
+maximum_partitions
+ This member contains the maximum number of Classic API Partitions
+ configured for this application. See :ref:`CONFIGURE_MAXIMUM_PARTITIONS`.
+
+maximum_regions
+ This member contains the maximum number of Classic API Regions configured
+ for this application. See :ref:`CONFIGURE_MAXIMUM_REGIONS`.
+
+maximum_ports
+ This member contains the maximum number of Classic API Dual-Ported Memories
+ configured for this application. See :ref:`CONFIGURE_MAXIMUM_PORTS`.
+
+maximum_periods
+ This member contains the maximum number of Classic API Rate Monotonic
+ Periods configured for this application. See
+ :ref:`CONFIGURE_MAXIMUM_PERIODS`.
+
+maximum_barriers
+ This member contains the maximum number of Classic API Barriers configured
+ for this application. See :ref:`CONFIGURE_MAXIMUM_BARRIERS`.
+
+number_of_initialization_tasks
+ This member contains the number of Classic API Initialization Tasks
+ configured for this application. See
+ :ref:`CONFIGURE_RTEMS_INIT_TASKS_TABLE`.
+
+User_initialization_tasks_table
+ This member contains the pointer to Classic API Initialization Tasks Table
+ of this application. See :ref:`CONFIGURE_RTEMS_INIT_TASKS_TABLE`.
+
+.. rubric:: DESCRIPTION:
+
+Use :ref:`InterfaceRtemsConfigurationGetRtemsApiConfiguration` to get the
+configuration table.
+
+.. Generated from spec:/rtems/signal/if/asr
.. index:: rtems_asr
-``rtems_asr``
- The return type for an RTEMS ASR.
+.. _InterfaceRtemsAsr:
+
+rtems_asr
+---------
+
+This type defines the return type of routines which are used to process
+asynchronous signals.
+
+.. rubric:: NOTES:
+
+This type can be used to document asynchronous signal routines in the source
+code.
+
+.. Generated from spec:/rtems/signal/if/asr-entry
.. index:: rtems_asr_entry
-``rtems_asr_entry``
- The address of the entry point to an RTEMS ASR.
+.. _InterfaceRtemsAsrEntry:
-.. index:: rtems_attribute
+rtems_asr_entry
+---------------
-``rtems_attribute``
- The data type used to manage the attributes for RTEMS objects. It is
- primarily used as an argument to object create routines to specify
- characteristics of the new object.
+This type defines the prototype of routines which are used to process
+asynchronous signals.
-.. index:: rtems_boolean
+.. Generated from spec:/rtems/fatal/if/assert-context
-``rtems_boolean``
- This type is deprecated will be removed in RTEMS 6.1. Use ``bool`` instead.
+.. index:: rtems_assert_context
-.. index:: rtems_context
+.. _InterfaceRtemsAssertContext:
-``rtems_context``
- This type is deprecated will be removed in RTEMS 6.1.
+rtems_assert_context
+--------------------
-.. index:: rtems_context_fp
+This structure provides the context in which an assertion failed.
-``rtems_context_fp``
- This type is deprecated will be removed in RTEMS 6.1.
+.. rubric:: MEMBERS:
+
+file
+ This member provides the file name of the source code file containing the
+ failed assertion statement.
+
+line
+ This member provides the line number in the source code file containing the
+ failed assertion statement.
+
+function
+ This member provides the function name containing the failed assertion
+ statement.
+
+failed_expression
+ This member provides the expression of the failed assertion statement.
+
+.. Generated from spec:/rtems/attr/if/attribute
+
+.. index:: rtems_attribute
+
+.. _InterfaceRtemsAttribute:
+
+rtems_attribute
+---------------
+
+This type represents Classic API attributes.
+
+.. rubric:: NOTES:
+
+Attributes are primarily used when creating objects.
+
+.. Generated from spec:/rtems/io/if/device-driver
.. index:: rtems_device_driver
-``rtems_device_driver``
- The return type for a RTEMS device driver routine.
+.. _InterfaceRtemsDeviceDriver:
+
+rtems_device_driver
+-------------------
+
+This type shall be used in device driver entry declarations and definitions.
+
+.. rubric:: NOTES:
+
+Device driver entries return an :c:type:`rtems_status_code` status code. This
+type definition helps to document device driver entries in the source code.
+
+.. Generated from spec:/rtems/io/if/device-driver-entry
.. index:: rtems_device_driver_entry
-``rtems_device_driver_entry``
- The entry point to a RTEMS device driver routine.
+.. _InterfaceRtemsDeviceDriverEntry:
+
+rtems_device_driver_entry
+-------------------------
+
+Device driver entries shall have this type.
+
+.. Generated from spec:/rtems/io/if/device-major-number
.. index:: rtems_device_major_number
-``rtems_device_major_number``
- The data type used to manage device major numbers.
+.. _InterfaceRtemsDeviceMajorNumber:
+
+rtems_device_major_number
+-------------------------
+
+This integer type represents the major number of devices.
+
+.. rubric:: NOTES:
+
+The major number of a device is determined by
+:ref:`InterfaceRtemsIoRegisterDriver` and the application configuration (see
+:ref:`CONFIGURE_MAXIMUM_DRIVERS`) .
+
+.. Generated from spec:/rtems/io/if/device-minor-number
.. index:: rtems_device_minor_number
-``rtems_device_minor_number``
- The data type used to manage device minor numbers.
+.. _InterfaceRtemsDeviceMinorNumber:
+
+rtems_device_minor_number
+-------------------------
+
+This integer type represents the minor number of devices.
+
+.. rubric:: NOTES:
+
+The minor number of devices is managed by the device driver.
+
+.. Generated from spec:/rtems/io/if/driver-address-table
+
+.. index:: rtems_driver_address_table
-.. index:: rtems_double
+.. _InterfaceRtemsDriverAddressTable:
-``rtems_double``
- This type is deprecated will be removed in RTEMS 6.1. Use ``double`` instead.
+rtems_driver_address_table
+--------------------------
+
+This structure contains the device driver entries.
+
+.. rubric:: MEMBERS:
+
+initialization_entry
+ This member is the device driver initialization entry. This entry is called
+ by :ref:`InterfaceRtemsIoInitialize`.
+
+open_entry
+ This member is the device driver open entry. This entry is called by
+ :ref:`InterfaceRtemsIoOpen`.
+
+close_entry
+ This member is the device driver close entry. This entry is called by
+ :ref:`InterfaceRtemsIoClose`.
+
+read_entry
+ This member is the device driver read entry. This entry is called by
+ :ref:`InterfaceRtemsIoRead`.
+
+write_entry
+ This member is the device driver write entry. This entry is called by
+ :ref:`InterfaceRtemsIoWrite`.
+
+control_entry
+ This member is the device driver control entry. This entry is called by
+ :ref:`InterfaceRtemsIoControl`.
+
+.. rubric:: DESCRIPTION:
+
+This structure is used to register a device driver via
+:ref:`InterfaceRtemsIoRegisterDriver`.
+
+.. Generated from spec:/rtems/event/if/set
.. index:: rtems_event_set
-``rtems_event_set``
- The data type used to manage and manipulate RTEMS event sets with the Event
- Manager.
+.. _InterfaceRtemsEventSet:
+
+rtems_event_set
+---------------
+
+This integer type represents a bit field which can hold exactly 32 individual
+events.
+
+.. Generated from spec:/rtems/fatal/if/exception-frame
+
+.. index:: rtems_exception_frame
+
+.. _InterfaceRtemsExceptionFrame:
-.. index:: rtems_extension
+rtems_exception_frame
+---------------------
-``rtems_extension``
- The return type for RTEMS user extension routines.
+This structure represents an architecture-dependent exception frame.
+
+.. Generated from spec:/rtems/userext/if/table
+
+.. index:: rtems_extensions_table
+
+.. _InterfaceRtemsExtensionsTable:
+
+rtems_extensions_table
+----------------------
+
+The extensions table contains a set of extensions which may be registered in
+the system through the :ref:`CONFIGURE_INITIAL_EXTENSIONS` application
+configuration option or the :ref:`InterfaceRtemsExtensionCreate` directive.
+
+.. Generated from spec:/rtems/userext/if/fatal-code
+
+.. index:: rtems_fatal_code
+
+.. _InterfaceRtemsFatalCode:
+
+rtems_fatal_code
+----------------
+
+This integer type represents system termination codes.
+
+.. rubric:: DESCRIPTION:
+
+This integer type is large enough to store a 32-bit integer or a pointer.
+
+.. rubric:: NOTES:
+
+The interpretation of a system termination code depends on the system
+termination source, see :ref:`InterfaceRtemsFatalSource`.
+
+.. Generated from spec:/rtems/userext/if/fatal
.. index:: rtems_fatal_extension
-``rtems_fatal_extension``
- The entry point for a fatal error user extension handler routine.
+.. _InterfaceRtemsFatalExtension:
+
+rtems_fatal_extension
+---------------------
+
+Fatal extensions are invoked when the system should terminate.
+
+.. rubric:: NOTES:
+
+The fatal extensions are invoked in :term:`extension forward order`.
+
+The fatal extension should be extremely careful with respect to the RTEMS
+directives it calls. Depending on the system termination source, the system
+may be in an undefined and corrupt state.
+
+It is recommended to register fatal extensions through :term:`initial extension
+sets`, see :ref:`CONFIGURE_INITIAL_EXTENSIONS`.
+
+.. Generated from spec:/rtems/userext/if/fatal-source
+
+.. index:: rtems_fatal_source
+
+.. _InterfaceRtemsFatalSource:
+
+rtems_fatal_source
+------------------
+
+This enumeration represents system termination sources.
+
+.. rubric:: NOTES:
+
+The system termination code may provide additional information depending on the
+system termination source, see :ref:`InterfaceRtemsFatalCode`.
+
+.. Generated from spec:/rtems/type/if/id
.. index:: rtems_id
-``rtems_id``
- The data type used to manage and manipulate RTEMS object IDs.
+.. _InterfaceRtemsId:
+
+rtems_id
+--------
+
+This type represents RTEMS object identifiers.
+
+.. Generated from spec:/rtems/task/if/initialization-table
-.. index:: rtems_interrupt_frame
+.. index:: rtems_initialization_tasks_table
-``rtems_interrupt_frame``
- The data structure that defines the format of the interrupt stack frame as it
- appears to a user ISR. This data structure is only defined on architectures
- that pass the frame pointer to the ISR handler.
+.. _InterfaceRtemsInitializationTasksTable:
+
+rtems_initialization_tasks_table
+--------------------------------
+
+This structure defines the properties of the Classic API user initialization
+task.
+
+.. rubric:: MEMBERS:
+
+name
+ This member defines the task name.
+
+stack_size
+ This member defines the task stack size in bytes.
+
+initial_priority
+ This member defines the initial task priority.
+
+attribute_set
+ This member defines the attribute set of the task.
+
+entry_point
+ This member defines the entry point of the task.
+
+mode_set
+ This member defines the initial modes of the task.
+
+argument
+ This member defines the entry point argument of the task.
+
+.. Generated from spec:/rtems/intr/if/attributes
+
+.. index:: rtems_interrupt_attributes
+
+.. _InterfaceRtemsInterruptAttributes:
+
+rtems_interrupt_attributes
+--------------------------
+
+This structure provides the attributes of an interrupt vector.
+
+.. rubric:: MEMBERS:
+
+is_maskable
+ This member is true, if the interrupt vector is maskable by
+ :ref:`InterfaceRtemsInterruptLocalDisable`, otherwise it is false.
+ Interrupt vectors which are not maskable by
+ :ref:`InterfaceRtemsInterruptLocalDisable` should be used with care since
+ they cannot use most operating system services.
+
+can_enable
+ This member is true, if the interrupt vector can be enabled by
+ :ref:`InterfaceRtemsInterruptVectorEnable`, otherwise it is false. When an
+ interrupt vector can be enabled, this means that the enabled state can
+ always be changed from disabled to enabled. For an interrupt vector which
+ can be enabled it follows that it may be enabled.
+
+maybe_enable
+ This member is true, if the interrupt vector may be enabled by
+ :ref:`InterfaceRtemsInterruptVectorEnable`, otherwise it is false. When an
+ interrupt vector may be enabled, this means that the enabled state may be
+ changed from disabled to enabled. The requested enabled state change
+ should be checked by :ref:`InterfaceRtemsInterruptVectorIsEnabled`. Some
+ interrupt vectors may be optionally available and cannot be enabled on a
+ particular :term:`target`.
+
+can_disable
+ This member is true, if the interrupt vector can be disabled by
+ :ref:`InterfaceRtemsInterruptVectorDisable`, otherwise it is false. When an
+ interrupt vector can be disabled, this means that the enabled state can be
+ changed from enabled to disabled. For an interrupt vector which can be
+ disabled it follows that it may be disabled.
+
+maybe_disable
+ This member is true, if the interrupt vector may be disabled by
+ :ref:`InterfaceRtemsInterruptVectorDisable`, otherwise it is false. When an
+ interrupt vector may be disabled, this means that the enabled state may be
+ changed from enabled to disabled. The requested enabled state change
+ should be checked by :ref:`InterfaceRtemsInterruptVectorIsEnabled`. Some
+ interrupt vectors may be always enabled and cannot be disabled on a
+ particular :term:`target`.
+
+can_raise
+ This member is true, if the interrupt vector can be raised by
+ :ref:`InterfaceRtemsInterruptRaise`, otherwise it is false.
+
+can_raise_on
+ This member is true, if the interrupt vector can be raised on a processor
+ by :ref:`InterfaceRtemsInterruptRaiseOn`, otherwise it is false.
+
+can_clear
+ This member is true, if the interrupt vector can be cleared by
+ :ref:`InterfaceRtemsInterruptClear`, otherwise it is false.
+
+cleared_by_acknowledge
+ This member is true, if the pending status of the interrupt associated with
+ the interrupt vector is cleared by an interrupt acknowledge from the
+ processor, otherwise it is false.
+
+can_get_affinity
+ This member is true, if the affinity set of the interrupt vector can be
+ obtained by :ref:`InterfaceRtemsInterruptGetAffinity`, otherwise it is
+ false.
+
+can_set_affinity
+ This member is true, if the affinity set of the interrupt vector can be set
+ by :ref:`InterfaceRtemsInterruptSetAffinity`, otherwise it is false.
+
+can_be_triggered_by_message
+ This member is true, if the interrupt associated with the interrupt vector
+ can be triggered by a message. Interrupts may be also triggered by signals,
+ :ref:`InterfaceRtemsInterruptRaise`, or
+ :ref:`InterfaceRtemsInterruptRaiseOn`. Examples for message triggered
+ interrupts are the PCIe MSI/MSI-X and the ARM GICv3 Locality-specific
+ Peripheral Interrupts (LPI).
+
+trigger_signal
+ This member describes the trigger signal of the interrupt associated with
+ the interrupt vector. Interrupts are normally triggered by signals which
+ indicate an interrupt request from a peripheral. Interrupts may be also
+ triggered by messages, :ref:`InterfaceRtemsInterruptRaise`, or
+ :ref:`InterfaceRtemsInterruptRaiseOn`.
+
+.. rubric:: DESCRIPTION:
+
+The :ref:`InterfaceRtemsInterruptGetAttributes` directive may be used to obtain
+the attributes of an interrupt vector.
+
+.. Generated from spec:/rtems/intr/if/entry
+
+.. index:: rtems_interrupt_entry
+
+.. _InterfaceRtemsInterruptEntry:
+
+rtems_interrupt_entry
+---------------------
+
+This structure represents an interrupt entry.
+
+.. rubric:: MEMBERS:
+
+Members of the type shall not be accessed directly by the application.
+
+.. rubric:: NOTES:
+
+This structure shall be treated as an opaque data type from the :term:`API`
+point of view. Members shall not be accessed directly. An entry may be
+initialized by :ref:`InterfaceRTEMSINTERRUPTENTRYINITIALIZER` or
+:ref:`InterfaceRtemsInterruptEntryInitialize`. It may be installed for an
+interrupt vector with :ref:`InterfaceRtemsInterruptEntryInstall` and removed
+from an interrupt vector by :ref:`InterfaceRtemsInterruptEntryRemove`.
+
+.. Generated from spec:/rtems/intr/if/handler
+
+.. index:: rtems_interrupt_handler
+
+.. _InterfaceRtemsInterruptHandler:
+
+rtems_interrupt_handler
+-----------------------
+
+Interrupt handler routines shall have this type.
+
+.. Generated from spec:/rtems/intr/if/level
.. index:: rtems_interrupt_level
-``rtems_interrupt_level``
- The data structure used with the ``rtems_interrupt_disable``,
- ``rtems_interrupt_enable``, and ``rtems_interrupt_flash`` routines. This
- data type is CPU dependent and usually corresponds to the contents of the
- processor register containing the interrupt mask level.
+.. _InterfaceRtemsInterruptLevel:
-.. index:: rtems_interval
+rtems_interrupt_level
+---------------------
-``rtems_interval``
- The data type used to manage and manipulate time intervals. Intervals are
- non-negative integers used to measure the length of time in clock ticks.
+This integer type represents interrupt levels.
-.. index:: rtems_isr
+.. Generated from spec:/rtems/intr/if/lock
-``rtems_isr``
- The return type of a function implementing an RTEMS ISR.
+.. index:: rtems_interrupt_lock
-.. index:: rtems_isr_entry
+.. _InterfaceRtemsInterruptLock:
-``rtems_isr_entry``
- The address of the entry point to an RTEMS ISR. It is equivalent to the
- entry point of the function implementing the ISR.
+rtems_interrupt_lock
+--------------------
-.. index:: rtems_mp_packet_classes
+This structure represents an ISR lock.
-``rtems_mp_packet_classes``
- The enumerated type which specifies the categories of multiprocessing
- messages. For example, one of the classes is for messages that must be
- processed by the Task Manager.
+.. Generated from spec:/rtems/intr/if/lock-context
-.. index:: rtems_mode
+.. index:: rtems_interrupt_lock_context
-``rtems_mode``
- The data type used to manage and dynamically manipulate the execution mode of
- an RTEMS task.
+.. _InterfaceRtemsInterruptLockContext:
-.. index:: rtems_mpci_entry
+rtems_interrupt_lock_context
+----------------------------
-``rtems_mpci_entry``
- The return type of an RTEMS MPCI routine.
+This structure provides an ISR lock context for acquire and release pairs.
-.. index:: rtems_mpci_get_packet_entry
+.. Generated from spec:/rtems/intr/if/per-handler-routine
-``rtems_mpci_get_packet_entry``
- The address of the entry point to the get packet routine for an MPCI
- implementation.
+.. index:: rtems_interrupt_per_handler_routine
-.. index:: rtems_mpci_initialization_entry
+.. _InterfaceRtemsInterruptPerHandlerRoutine:
-``rtems_mpci_initialization_entry``
- The address of the entry point to the initialization routine for an MPCI
- implementation.
+rtems_interrupt_per_handler_routine
+-----------------------------------
-.. index:: rtems_mpci_receive_packet_entry
+Visitor routines invoked by :ref:`InterfaceRtemsInterruptHandlerIterate` shall
+have this type.
-``rtems_mpci_receive_packet_entry``
- The address of the entry point to the receive packet routine for an MPCI
- implementation.
+.. Generated from spec:/rtems/intr/if/server-action
-.. index:: rtems_mpci_return_packet_entry
+.. index:: rtems_interrupt_server_action
-``rtems_mpci_return_packet_entry``
- The address of the entry point to the return packet routine for an MPCI
- implementation.
+.. _InterfaceRtemsInterruptServerAction:
-.. index:: rtems_mpci_send_packet_entry
+rtems_interrupt_server_action
+-----------------------------
-``rtems_mpci_send_packet_entry``
- The address of the entry point to the send packet routine for an MPCI
- implementation.
+This structure represents an interrupt server action.
-.. index:: rtems_mpci_table
+.. rubric:: MEMBERS:
-``rtems_mpci_table``
- The data structure containing the configuration information for an MPCI.
+Members of the type shall not be accessed directly by the application.
-.. index:: rtems_name
+.. rubric:: NOTES:
-``rtems_name``
- The data type used to contain the name of a Classic API object. It is an
- unsigned thirty-two bit integer which can be treated as a numeric value or
- initialized using ``rtems_build_name`` to contain four ASCII characters.
+This structure shall be treated as an opaque data type from the :term:`API`
+point of view. Members shall not be accessed directly.
-.. index:: rtems_option
+.. Generated from spec:/rtems/intr/if/server-config
-``rtems_option``
- The data type used to specify which behavioral options the caller desires.
- It is commonly used with potentially blocking directives to specify whether
- the caller is willing to block or return immediately with an error indicating
- that the resource was not available.
+.. index:: rtems_interrupt_server_config
-.. index:: rtems_packet_prefix
+.. _InterfaceRtemsInterruptServerConfig:
-``rtems_packet_prefix``
- The data structure that defines the first bytes in every packet sent between
- nodes in an RTEMS multiprocessor system. It contains routing information
- that is expected to be used by the MPCI layer.
+rtems_interrupt_server_config
+-----------------------------
-.. index:: rtems_signal_set
+This structure defines an interrupt server configuration.
-``rtems_signal_set``
- The data type used to manage and manipulate RTEMS signal sets with the Signal
- Manager.
+.. rubric:: MEMBERS:
-.. index:: int8_t
+Members of the type shall not be accessed directly by the application.
-``int8_t``
- The C99 data type that corresponds to signed eight bit integers. This data
- type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. rubric:: NOTES:
-.. index:: int16_t
+See also :ref:`InterfaceRtemsInterruptServerCreate`.
-``int16_t``
- The C99 data type that corresponds to signed sixteen bit integers. This data
- type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. Generated from spec:/rtems/intr/if/server-control
-.. index:: int32_t
+.. index:: rtems_interrupt_server_control
-``int32_t``
- The C99 data type that corresponds to signed thirty-two bit integers. This
- data type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. _InterfaceRtemsInterruptServerControl:
-.. index:: int64_t
+rtems_interrupt_server_control
+------------------------------
-``int64_t``
- The C99 data type that corresponds to signed sixty-four bit integers. This
- data type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+This structure represents an interrupt server.
-.. index:: rtems_single
+.. rubric:: MEMBERS:
-``rtems_single``
- This type is deprecated will be removed in RTEMS 6.1. Use ``float`` instead.
+Members of the type shall not be accessed directly by the application.
-.. index:: rtems_status_code
+.. rubric:: NOTES:
-``rtems_status_code``
- The return type for most RTEMS services. This is an enumerated type of
- approximately twenty-five values. In general, when a service returns a
- particular status code, it indicates that a very specific error condition has
- occurred.
+This structure shall be treated as an opaque data type from the :term:`API`
+point of view. Members shall not be accessed directly. The structure is
+initialized by :ref:`InterfaceRtemsInterruptServerCreate` and maintained by the
+interrupt server support.
-.. index:: rtems_task
+.. Generated from spec:/rtems/intr/if/server-entry
-``rtems_task``
- The return type for an RTEMS Task.
+.. index:: rtems_interrupt_server_entry
-.. index:: rtems_task_argument
+.. _InterfaceRtemsInterruptServerEntry:
-``rtems_task_argument``
- The data type for the argument passed to each RTEMS task. In RTEMS 4.7 and
- older, this is an unsigned thirty-two bit integer. In RTEMS 4.8 and newer,
- this is based upon the C99 type ``uintptr_t`` which is guaranteed to be an
- integer large enough to hold a pointer on the target architecture.
+rtems_interrupt_server_entry
+----------------------------
-.. index:: rtems_task_begin_extension
+This structure represents an interrupt server entry.
-``rtems_task_begin_extension``
- The entry point for a task beginning execution user extension handler
- routine.
+.. rubric:: MEMBERS:
-.. index:: rtems_task_create_extension
+Members of the type shall not be accessed directly by the application.
-``rtems_task_create_extension``
- The entry point for a task creation execution user extension handler routine.
+.. rubric:: NOTES:
-.. index:: rtems_task_delete_extension
+This structure shall be treated as an opaque data type from the :term:`API`
+point of view. Members shall not be accessed directly. An entry is
+initialized by :ref:`InterfaceRtemsInterruptServerEntryInitialize` and
+destroyed by :ref:`InterfaceRtemsInterruptServerEntryDestroy`. Interrupt
+server actions can be prepended to the entry by
+:ref:`InterfaceRtemsInterruptServerActionPrepend`. The entry is submitted to
+be serviced by :ref:`InterfaceRtemsInterruptServerEntrySubmit`.
-``rtems_task_delete_extension``
- The entry point for a task deletion user extension handler routine.
+.. Generated from spec:/rtems/intr/if/server-request
-.. index:: rtems_task_entry
+.. index:: rtems_interrupt_server_request
-``rtems_task_entry``
- The address of the entry point to an RTEMS ASR. It is equivalent to the
- entry point of the function implementing the ASR.
+.. _InterfaceRtemsInterruptServerRequest:
-.. index:: rtems_task_exitted_extension
+rtems_interrupt_server_request
+------------------------------
-``rtems_task_exitted_extension``
- The entry point for a task exitted user extension handler routine.
+This structure represents an interrupt server request.
-.. index:: rtems_task_priority
+.. rubric:: MEMBERS:
-``rtems_task_priority``
- The data type used to manage and manipulate task priorities.
+Members of the type shall not be accessed directly by the application.
-.. index:: rtems_task_restart_extension
+.. rubric:: NOTES:
-``rtems_task_restart_extension``
- The entry point for a task restart user extension handler routine.
+This structure shall be treated as an opaque data type from the :term:`API`
+point of view. Members shall not be accessed directly. A request is
+initialized by :ref:`InterfaceRtemsInterruptServerRequestInitialize` and
+destroyed by :ref:`InterfaceRtemsInterruptServerRequestDestroy`. The interrupt
+vector of the request can be set by
+:ref:`InterfaceRtemsInterruptServerRequestSetVector`. The request is submitted
+to be serviced by :ref:`InterfaceRtemsInterruptServerRequestSubmit`.
-.. index:: rtems_task_start_extension
+.. Generated from spec:/rtems/intr/if/signal-variant
-``rtems_task_start_extension``
- The entry point for a task start user extension handler routine.
+.. index:: rtems_interrupt_signal_variant
-.. index:: rtems_task_switch_extension
+.. _InterfaceRtemsInterruptSignalVariant:
-``rtems_task_switch_extension``
- The entry point for a task context switch user extension handler routine.
+rtems_interrupt_signal_variant
+------------------------------
-.. index:: rtems_tcb
+This enumeration provides interrupt trigger signal variants.
-``rtems_tcb``
- The data structure associated with each task in an RTEMS system.
+.. rubric:: ENUMERATORS:
-.. index:: rtems_time_of_day
+RTEMS_INTERRUPT_UNSPECIFIED_SIGNAL
+ This interrupt signal variant indicates that the interrupt trigger signal
+ is unspecified.
-``rtems_time_of_day``
- The data structure used to manage and manipulate calendar time in RTEMS.
+RTEMS_INTERRUPT_NO_SIGNAL
+ This interrupt signal variant indicates that the interrupt cannot be
+ triggered by a signal.
-.. index:: rtems_timer_service_routine
+RTEMS_INTERRUPT_SIGNAL_LEVEL_LOW
+ This interrupt signal variant indicates that the interrupt is triggered by
+ a low level signal.
-``rtems_timer_service_routine``
- The return type for an RTEMS Timer Service Routine.
+RTEMS_INTERRUPT_SIGNAL_LEVEL_HIGH
+ This interrupt signal variant indicates that the interrupt is triggered by
+ a high level signal.
-.. index:: rtems_timer_service_routine_entry
+RTEMS_INTERRUPT_SIGNAL_EDGE_FALLING
+ This interrupt signal variant indicates that the interrupt is triggered by
+ a falling edge signal.
-``rtems_timer_service_routine_entry``
- The address of the entry point to an RTEMS TSR. It is equivalent to the
- entry point of the function implementing the TSR.
+RTEMS_INTERRUPT_SIGNAL_EDGE_RAISING
+ This interrupt signal variant indicates that the interrupt is triggered by
+ a raising edge signal.
-.. index:: rtems_vector_number
+.. Generated from spec:/rtems/type/if/interval
+
+.. index:: rtems_interval
+
+.. _InterfaceRtemsInterval:
+
+rtems_interval
+--------------
+
+This type represents clock tick intervals.
+
+.. Generated from spec:/rtems/intr/if/isr
+
+.. index:: rtems_isr
+
+.. _InterfaceRtemsIsr:
+
+rtems_isr
+---------
+
+This type defines the return type of interrupt service routines.
+
+.. rubric:: DESCRIPTION:
+
+This type can be used to document interrupt service routines in the source
+code.
+
+.. Generated from spec:/rtems/intr/if/isr-entry
+
+.. index:: rtems_isr_entry
+
+.. _InterfaceRtemsIsrEntry:
-``rtems_vector_number``
- The data type used to manage and manipulate interrupt vector numbers.
+rtems_isr_entry
+---------------
-.. index:: uint8_t
+Interrupt service routines installed by :ref:`InterfaceRtemsInterruptCatch`
+shall have this type.
-``uint8_t``
- The C99 data type that corresponds to unsigned eight bit integers. This data
- type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. Generated from spec:/rtems/message/if/config
-.. index:: uint16_t
+.. index:: rtems_message_queue_config
+
+.. _InterfaceRtemsMessageQueueConfig:
+
+rtems_message_queue_config
+--------------------------
+
+This structure defines the configuration of a message queue constructed by
+:ref:`InterfaceRtemsMessageQueueConstruct`.
+
+.. rubric:: MEMBERS:
+
+name
+ This member defines the name of the message queue.
+
+maximum_pending_messages
+ This member defines the maximum number of pending messages supported by the
+ message queue.
+
+maximum_message_size
+ This member defines the maximum message size supported by the message
+ queue.
+
+storage_area
+ This member shall point to the message buffer storage area begin. The
+ message buffer storage area for the message queue shall be an array of the
+ type defined by :ref:`InterfaceRTEMSMESSAGEQUEUEBUFFER` with a maximum
+ message size equal to the maximum message size of this configuration.
+
+storage_size
+ This member defines size of the message buffer storage area in bytes.
+
+storage_free
+ This member defines the optional handler to free the message buffer storage
+ area. It is called when the message queue is deleted. It is called from
+ task context under protection of the object allocator lock. It is allowed
+ to call :c:func:`free` in this handler. If handler is `NULL
+ <https://en.cppreference.com/w/c/types/NULL>`_, then no action will be
+ performed.
+
+attributes
+ This member defines the attributes of the message queue.
+
+.. Generated from spec:/rtems/mode/if/mode
+
+.. index:: rtems_mode
+
+.. _InterfaceRtemsMode:
+
+rtems_mode
+----------
+
+This type represents a Classic API task mode set.
+
+.. Generated from spec:/rtems/type/if/mp-packet-classes
+
+.. index:: rtems_mp_packet_classes
+
+.. _InterfaceRtemsMpPacketClasses:
+
+rtems_mp_packet_classes
+-----------------------
+
+This enumeration defines the MPCI packet classes.
+
+.. Generated from spec:/rtems/type/if/mpci-entry
+
+.. index:: rtems_mpci_entry
+
+.. _InterfaceRtemsMpciEntry:
+
+rtems_mpci_entry
+----------------
+
+MPCI handler routines shall have this return type.
+
+.. Generated from spec:/rtems/type/if/mpci-get-packet-entry
+
+.. index:: rtems_mpci_get_packet_entry
-``uint16_t``
- The C99 data type that corresponds to unsigned sixteen bit integers. This
- data type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. _InterfaceRtemsMpciGetPacketEntry:
-.. index:: uint32_t
+rtems_mpci_get_packet_entry
+---------------------------
-``uint32_t``
- The C99 data type that corresponds to unsigned thirty-two bit integers. This
- data type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+MPCI get packet routines shall have this type.
-.. index:: uint64_t
+.. Generated from spec:/rtems/type/if/mpci-initialization-entry
+
+.. index:: rtems_mpci_initialization_entry
+
+.. _InterfaceRtemsMpciInitializationEntry:
+
+rtems_mpci_initialization_entry
+-------------------------------
+
+MPCI initialization routines shall have this type.
+
+.. Generated from spec:/rtems/type/if/mpci-receive-packet-entry
+
+.. index:: rtems_mpci_receive_packet_entry
+
+.. _InterfaceRtemsMpciReceivePacketEntry:
+
+rtems_mpci_receive_packet_entry
+-------------------------------
+
+MPCI receive packet routines shall have this type.
+
+.. Generated from spec:/rtems/type/if/mpci-return-packet-entry
+
+.. index:: rtems_mpci_return_packet_entry
+
+.. _InterfaceRtemsMpciReturnPacketEntry:
+
+rtems_mpci_return_packet_entry
+------------------------------
+
+MPCI return packet routines shall have this type.
+
+.. Generated from spec:/rtems/type/if/mpci-send-packet-entry
+
+.. index:: rtems_mpci_send_packet_entry
+
+.. _InterfaceRtemsMpciSendPacketEntry:
+
+rtems_mpci_send_packet_entry
+----------------------------
+
+MPCI send packet routines shall have this type.
+
+.. Generated from spec:/rtems/type/if/mpci-table
+
+.. index:: rtems_mpci_table
+
+.. _InterfaceRtemsMpciTable:
+
+rtems_mpci_table
+----------------
+
+This type represents the user-provided MPCI control.
+
+.. Generated from spec:/rtems/type/if/multiprocessing-table
+
+.. index:: rtems_multiprocessing_table
+
+.. _InterfaceRtemsMultiprocessingTable:
+
+rtems_multiprocessing_table
+---------------------------
+
+This type represents the user-provided MPCI configuration.
+
+.. Generated from spec:/rtems/type/if/name
+
+.. index:: rtems_name
+
+.. _InterfaceRtemsName:
+
+rtems_name
+----------
+
+This type represents Classic API object names.
+
+.. rubric:: DESCRIPTION:
+
+It is an unsigned 32-bit integer which can be treated as a numeric value or
+initialized using :ref:`InterfaceRtemsBuildName` to encode four ASCII
+characters. A value of zero may have a special meaning in some directives.
+
+.. Generated from spec:/rtems/object/if/api-class-information
+
+.. index:: rtems_object_api_class_information
+
+.. _InterfaceRtemsObjectApiClassInformation:
+
+rtems_object_api_class_information
+----------------------------------
+
+This structure is used to return information to the application about the
+objects configured for a specific API/Class combination.
+
+.. rubric:: MEMBERS:
+
+minimum_id
+ This member contains the minimum valid object identifier for this class.
+
+maximum_id
+ This member contains the maximum valid object identifier for this class.
+
+maximum
+ This member contains the maximum number of active objects configured for
+ this class.
+
+auto_extend
+ This member is true, if this class is configured for automatic object
+ extension, otherwise it is false.
+
+unallocated
+ This member contains the number of currently inactive objects of this
+ class.
+
+.. Generated from spec:/rtems/option/if/option
+
+.. index:: rtems_option
+
+.. _InterfaceRtemsOption:
+
+rtems_option
+------------
+
+This type represents a Classic API directive option set.
+
+.. Generated from spec:/rtems/type/if/packet-prefix
+
+.. index:: rtems_packet_prefix
+
+.. _InterfaceRtemsPacketPrefix:
+
+rtems_packet_prefix
+-------------------
+
+This type represents the prefix found at the beginning of each MPCI packet sent
+between nodes.
+
+.. Generated from spec:/rtems/ratemon/if/period-states
+
+.. index:: rtems_rate_monotonic_period_states
+
+.. _InterfaceRtemsRateMonotonicPeriodStates:
+
+rtems_rate_monotonic_period_states
+----------------------------------
+
+This enumeration defines the states in which a period may be.
+
+.. rubric:: ENUMERATORS:
+
+RATE_MONOTONIC_INACTIVE
+ This status indicates the period is off the watchdog chain, and has never
+ been initialized.
+
+RATE_MONOTONIC_ACTIVE
+ This status indicates the period is on the watchdog chain, and running.
+ The owner may be executing or blocked waiting on another object.
+
+RATE_MONOTONIC_EXPIRED
+ This status indicates the period is off the watchdog chain, and has
+ expired. The owner may still execute and has taken too much time to
+ complete this iteration of the period.
+
+.. Generated from spec:/rtems/ratemon/if/period-statistics
+
+.. index:: rtems_rate_monotonic_period_statistics
+
+.. _InterfaceRtemsRateMonotonicPeriodStatistics:
+
+rtems_rate_monotonic_period_statistics
+--------------------------------------
+
+This structure provides the statistics of a period.
+
+.. rubric:: MEMBERS:
+
+count
+ This member contains the number of periods executed.
+
+missed_count
+ This member contains the number of periods missed.
+
+min_cpu_time
+ This member contains the least amount of processor time used in a period.
+
+max_cpu_time
+ This member contains the highest amount of processor time used in a period.
+
+total_cpu_time
+ This member contains the total amount of processor time used in a period.
+
+min_wall_time
+ This member contains the least amount of :term:`CLOCK_MONOTONIC` time used
+ in a period.
+
+max_wall_time
+ This member contains the highest amount of :term:`CLOCK_MONOTONIC` time
+ used in a period.
+
+total_wall_time
+ This member contains the total amount of :term:`CLOCK_MONOTONIC` time used
+ in a period.
+
+.. Generated from spec:/rtems/ratemon/if/period-status
+
+.. index:: rtems_rate_monotonic_period_status
+
+.. _InterfaceRtemsRateMonotonicPeriodStatus:
+
+rtems_rate_monotonic_period_status
+----------------------------------
+
+This structure provides the detailed status of a period.
+
+.. rubric:: MEMBERS:
+
+owner
+ This member contains the identifier of the owner task of the period.
+
+state
+ This member contains the state of the period.
+
+since_last_period
+ This member contains the time elapsed since the last successful invocation
+ :ref:`InterfaceRtemsRateMonotonicPeriod` using :term:`CLOCK_MONOTONIC`. If
+ the period is expired or has not been initiated, then this value has no
+ meaning.
+
+executed_since_last_period
+ This member contains the processor time consumed by the owner task since
+ the last successful invocation :ref:`InterfaceRtemsRateMonotonicPeriod`. If
+ the period is expired or has not been initiated, then this value has no
+ meaning.
+
+postponed_jobs_count
+ This member contains the count of jobs which are not released yet.
+
+.. Generated from spec:/rtems/signal/if/set
+
+.. index:: rtems_signal_set
+
+.. _InterfaceRtemsSignalSet:
+
+rtems_signal_set
+----------------
+
+This integer type represents a bit field which can hold exactly 32 individual
+signals.
+
+.. Generated from spec:/rtems/config/if/stack-allocate-hook
+
+.. index:: rtems_stack_allocate_hook
+
+.. _InterfaceRtemsStackAllocateHook:
+
+rtems_stack_allocate_hook
+-------------------------
+
+A thread stack allocator allocate handler shall have this type.
+
+.. Generated from spec:/rtems/config/if/stack-allocate-init-hook
+
+.. index:: rtems_stack_allocate_init_hook
+
+.. _InterfaceRtemsStackAllocateInitHook:
+
+rtems_stack_allocate_init_hook
+------------------------------
+
+A task stack allocator initialization handler shall have this type.
+
+.. Generated from spec:/rtems/config/if/stack-free-hook
+
+.. index:: rtems_stack_free_hook
+
+.. _InterfaceRtemsStackFreeHook:
+
+rtems_stack_free_hook
+---------------------
+
+A task stack allocator free handler shall have this type.
+
+.. Generated from spec:/rtems/status/if/code
+
+.. index:: rtems_status_code
+
+.. _InterfaceRtemsStatusCode:
+
+rtems_status_code
+-----------------
+
+This enumeration provides status codes for directives of the Classic API.
+
+.. rubric:: ENUMERATORS:
+
+RTEMS_SUCCESSFUL
+ This status code indicates successful completion of a requested operation.
+
+RTEMS_TASK_EXITTED
+ This status code indicates that a thread exitted.
+
+RTEMS_MP_NOT_CONFIGURED
+ This status code indicates that multiprocessing was not configured.
+
+RTEMS_INVALID_NAME
+ This status code indicates that an object name was invalid.
+
+RTEMS_INVALID_ID
+ This status code indicates that an object identifier was invalid.
+
+RTEMS_TOO_MANY
+ This status code indicates you have attempted to create too many instances
+ of a particular object class.
+
+RTEMS_TIMEOUT
+ This status code indicates that a blocking directive timed out.
+
+RTEMS_OBJECT_WAS_DELETED
+ This status code indicates the object was deleted while the thread was
+ blocked waiting.
+
+RTEMS_INVALID_SIZE
+ This status code indicates that a specified size was invalid.
+
+RTEMS_INVALID_ADDRESS
+ This status code indicates that a specified address was invalid.
+
+RTEMS_INVALID_NUMBER
+ This status code indicates that a specified number was invalid.
+
+RTEMS_NOT_DEFINED
+ This status code indicates that the item has not been initialized.
+
+RTEMS_RESOURCE_IN_USE
+ This status code indicates that the object still had resources in use.
+
+RTEMS_UNSATISFIED
+ This status code indicates that the request was not satisfied.
+
+RTEMS_INCORRECT_STATE
+ This status code indicates that an object was in wrong state for the
+ requested operation.
+
+RTEMS_ALREADY_SUSPENDED
+ This status code indicates that the thread was already suspended.
+
+RTEMS_ILLEGAL_ON_SELF
+ This status code indicates that the operation was illegal on the calling
+ thread.
+
+RTEMS_ILLEGAL_ON_REMOTE_OBJECT
+ This status code indicates that the operation was illegal on a remote
+ object.
+
+RTEMS_CALLED_FROM_ISR
+ This status code indicates that the operation should not be called from
+ this execution environment.
+
+RTEMS_INVALID_PRIORITY
+ This status code indicates that an invalid thread priority was provided.
+
+RTEMS_INVALID_CLOCK
+ This status code indicates that a specified date or time was invalid.
+
+RTEMS_INVALID_NODE
+ This status code indicates that a specified node identifier was invalid.
+
+RTEMS_NOT_CONFIGURED
+ This status code indicates that the directive was not configured.
+
+RTEMS_NOT_OWNER_OF_RESOURCE
+ This status code indicates that the caller was not the owner of the
+ resource.
+
+RTEMS_NOT_IMPLEMENTED
+ This status code indicates the directive or requested portion of the
+ directive is not implemented. This is a hint that you have stumbled across
+ an opportunity to submit code to the RTEMS Project.
+
+RTEMS_INTERNAL_ERROR
+ This status code indicates that an internal RTEMS inconsistency was
+ detected.
+
+RTEMS_NO_MEMORY
+ This status code indicates that the directive attempted to allocate memory
+ but was unable to do so.
+
+RTEMS_IO_ERROR
+ This status code indicates a device driver IO error.
+
+RTEMS_INTERRUPTED
+ This status code is used internally by the implementation to indicate a
+ blocking device driver call has been interrupted and should be reflected to
+ the caller as interrupted.
+
+RTEMS_PROXY_BLOCKING
+ This status code is used internally by the implementation when performing
+ operations on behalf of remote tasks. This is referred to as proxying
+ operations and this status indicates that the operation could not be
+ completed immediately and the proxy is blocking.
+
+.. Generated from spec:/rtems/task/if/task
+
+.. index:: rtems_task
+
+.. _InterfaceRtemsTask:
+
+rtems_task
+----------
+
+This type defines the return type of task entry points.
+
+.. rubric:: DESCRIPTION:
+
+This type can be used to document task entry points in the source code.
+
+.. Generated from spec:/rtems/task/if/argument
+
+.. index:: rtems_task_argument
+
+.. _InterfaceRtemsTaskArgument:
+
+rtems_task_argument
+-------------------
+
+This integer type represents task argument values.
+
+.. rubric:: NOTES:
+
+The type is an architecture-specific unsigned integer type which is large
+enough to represent pointer values and 32-bit unsigned integers.
+
+.. Generated from spec:/rtems/userext/if/task-begin
+
+.. index:: rtems_task_begin_extension
+
+.. _InterfaceRtemsTaskBeginExtension:
+
+rtems_task_begin_extension
+--------------------------
+
+Task begin extensions are invoked when a task begins execution.
+
+.. rubric:: NOTES:
+
+The task begin extensions are invoked in :term:`extension forward order`.
+
+Task begin extensions are invoked with thread dispatching enabled. This allows
+the use of dynamic memory allocation, creation of POSIX keys, and use of C++
+thread-local storage. Blocking synchronization primitives are allowed also.
+
+The task begin extensions are invoked before the global construction.
+
+The task begin extensions may be called as a result of a task restart through
+:ref:`InterfaceRtemsTaskRestart`.
+
+.. Generated from spec:/rtems/task/if/config
+
+.. index:: rtems_task_config
+
+.. _InterfaceRtemsTaskConfig:
+
+rtems_task_config
+-----------------
+
+This structure defines the configuration of a task constructed by
+:ref:`InterfaceRtemsTaskConstruct`.
+
+.. rubric:: MEMBERS:
+
+name
+ This member defines the name of the task.
+
+initial_priority
+ This member defines the initial priority of the task.
+
+storage_area
+ This member shall point to the task storage area begin. The task storage
+ area will contain the task stack, the thread-local storage, and the
+ floating-point context on architectures with a separate floating-point
+ context.
+
+ The task storage area begin address and size should be aligned by
+ :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT`. To avoid memory waste, use
+ :c:func:`RTEMS_ALIGNED` and :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT` to
+ enforce the recommended alignment of a statically allocated task storage
+ area.
+
+storage_size
+ This member defines size of the task storage area in bytes. Use the
+ :ref:`InterfaceRTEMSTASKSTORAGESIZE` macro to determine the recommended
+ task storage area size.
+
+maximum_thread_local_storage_size
+ This member defines the maximum thread-local storage size supported by the
+ task storage area. Use :c:func:`RTEMS_ALIGN_UP` and
+ :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT` to adjust the size to meet the
+ minimum alignment requirement of a thread-local storage area used to
+ construct a task.
+
+ If the value is less than the actual thread-local storage size, then the
+ task construction by :ref:`InterfaceRtemsTaskConstruct` fails.
+
+ If the is less than the task storage area size, then the task construction
+ by :ref:`InterfaceRtemsTaskConstruct` fails.
+
+ The actual thread-local storage size is determined when the application
+ executable is linked. The ``rtems-exeinfo`` command line tool included in
+ the RTEMS Tools can be used to obtain the thread-local storage size and
+ alignment of an application executable.
+
+ The application may configure the maximum thread-local storage size for all
+ threads explicitly through the
+ :ref:`CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE` configuration option.
+
+storage_free
+ This member defines the optional handler to free the task storage area. It
+ is called on exactly two mutually exclusive occasions. Firstly, when the
+ task construction aborts due to a failed task create extension, or
+ secondly, when the task is deleted. It is called from task context under
+ protection of the object allocator lock. It is allowed to call
+ :c:func:`free` in this handler. If handler is `NULL
+ <https://en.cppreference.com/w/c/types/NULL>`_, then no action will be
+ performed.
+
+initial_modes
+ This member defines the initial modes of the task.
+
+attributes
+ This member defines the attributes of the task.
+
+.. Generated from spec:/rtems/userext/if/task-create
+
+.. index:: rtems_task_create_extension
+
+.. _InterfaceRtemsTaskCreateExtension:
+
+rtems_task_create_extension
+---------------------------
+
+Task create extensions are invoked when a task is created.
+
+.. rubric:: NOTES:
+
+The task create extensions are invoked in :term:`extension forward order`.
+
+The task create extensions are invoked after a new task has been completely
+initialized, but before it is started.
+
+While normal tasks are created, the executing thread is the owner of the object
+allocator mutex. The object allocator mutex allows nesting, so the normal
+memory allocation routines can be used allocate memory for the created thread.
+
+If the task create extension returns :c:macro:`false`, then the task create
+operation stops immediately and the entire task create operation will fail. In
+this case, all task delete extensions are invoked, see
+:ref:`InterfaceRtemsTaskDeleteExtension`.
+
+.. Generated from spec:/rtems/userext/if/task-delete
+
+.. index:: rtems_task_delete_extension
+
+.. _InterfaceRtemsTaskDeleteExtension:
+
+rtems_task_delete_extension
+---------------------------
+
+Task delete extensions are invoked when a task is deleted.
+
+.. rubric:: NOTES:
+
+The task delete extensions are invoked in :term:`extension reverse order`.
+
+The task delete extensions are invoked by task create directives before an
+attempt to allocate a :term:`TCB` is made.
+
+If a task create extension failed, then a task delete extension may be invoked
+without a previous invocation of the corresponding task create extension of the
+extension set.
+
+.. Generated from spec:/rtems/task/if/entry
+
+.. index:: rtems_task_entry
+
+.. _InterfaceRtemsTaskEntry:
+
+rtems_task_entry
+----------------
+
+This type defines the entry point of an RTEMS task.
+
+.. Generated from spec:/rtems/userext/if/task-exitted
+
+.. index:: rtems_task_exitted_extension
+
+.. _InterfaceRtemsTaskExittedExtension:
+
+rtems_task_exitted_extension
+----------------------------
+
+Task exitted extensions are invoked when a task entry returns.
+
+.. rubric:: NOTES:
+
+The task exitted extensions are invoked in :term:`extension forward order`.
+
+.. Generated from spec:/rtems/type/if/priority
+
+.. index:: rtems_task_priority
+
+.. _InterfaceRtemsTaskPriority:
+
+rtems_task_priority
+-------------------
+
+This integer type represents task priorities of the Classic API.
+
+.. Generated from spec:/rtems/userext/if/task-restart
+
+.. index:: rtems_task_restart_extension
+
+.. _InterfaceRtemsTaskRestartExtension:
+
+rtems_task_restart_extension
+----------------------------
+
+Task restart extensions are invoked when a task restarts.
+
+.. rubric:: NOTES:
+
+The task restart extensions are invoked in :term:`extension forward order`.
+
+The task restart extensions are invoked in the context of the restarted thread
+right before the execution context is reloaded. The thread stack reflects the
+previous execution context.
+
+Thread restart and delete requests issued by restart extensions lead to
+recursion.
+
+.. Generated from spec:/rtems/userext/if/task-start
+
+.. index:: rtems_task_start_extension
+
+.. _InterfaceRtemsTaskStartExtension:
+
+rtems_task_start_extension
+--------------------------
+
+Task start extensions are invoked when a task was made ready for the first
+time.
+
+.. rubric:: NOTES:
+
+The task start extensions are invoked in :term:`extension forward order`.
+
+In SMP configurations, the thread may already run on another processor before
+the task start extensions are actually invoked. Task switch and task begin
+extensions may run before or in parallel with the thread start extension in SMP
+configurations, see :ref:`InterfaceRtemsTaskSwitchExtension` and
+:ref:`InterfaceRtemsTaskBeginExtension`.
+
+.. Generated from spec:/rtems/userext/if/task-switch
+
+.. index:: rtems_task_switch_extension
+
+.. _InterfaceRtemsTaskSwitchExtension:
+
+rtems_task_switch_extension
+---------------------------
+
+Task switch extensions are invoked when a thread switch from an executing
+thread to a heir thread takes place.
+
+.. rubric:: NOTES:
+
+The task switch extensions are invoked in :term:`extension forward order`.
+
+The invocation conditions of the task switch extensions depend on whether RTEMS
+was built with SMP support enabled or disabled. A user must pay attention to
+the differences to correctly implement a task switch extension.
+
+Where the system was built with SMP support disabled, the task switch
+extensions are invoked before the context switch from the currently executing
+thread to the heir thread. The executing is a pointer to the :term:`TCB` of
+the currently executing thread. The heir is a pointer to the TCB of the heir
+thread. The context switch initiated through the multitasking start is not
+covered by the task switch extensions.
+
+Where the system was built with SMP support enabled, the task switch extensions
+are invoked after the context switch to the heir thread. The executing is a
+pointer to the TCB of the previously executing thread. Despite the name, this
+is not the currently executing thread. The heir is a pointer to the TCB of the
+newly executing thread. This is the currently executing thread. The context
+switches initiated through the multitasking start are covered by the task
+switch extensions. The reason for the differences to uniprocessor
+configurations is that the context switch may update the heir thread of the
+processor. The task switch extensions are invoked with maskable interrupts
+disabled and with ownership of a processor-specific SMP lock. Task switch
+extensions may run in parallel on multiple processors. It is recommended to
+use thread-local or processor-specific data structures for task switch
+extensions. A global SMP lock should be avoided for performance reasons, see
+:ref:`InterfaceRtemsInterruptLockInitialize`.
+
+.. Generated from spec:/rtems/userext/if/task-terminate
+
+.. index:: rtems_task_terminate_extension
+
+.. _InterfaceRtemsTaskTerminateExtension:
+
+rtems_task_terminate_extension
+------------------------------
+
+Task terminate extensions are invoked when a task terminates.
+
+.. rubric:: NOTES:
+
+The task terminate extensions are invoked in :term:`extension reverse order`.
+
+The task terminate extensions are invoked in the context of the terminating
+thread right before the thread dispatch to the heir thread should take place.
+The thread stack reflects the previous execution context. The POSIX cleanup
+and key destructors execute in this context.
+
+Thread restart and delete requests issued by terminate extensions lead to
+recursion.
+
+.. Generated from spec:/rtems/task/if/visitor
+
+.. index:: rtems_task_visitor
+
+.. _InterfaceRtemsTaskVisitor:
+
+rtems_task_visitor
+------------------
+
+Visitor routines invoked by :ref:`InterfaceRtemsTaskIterate` shall have this
+type.
+
+.. Generated from spec:/rtems/task/if/tcb
+
+.. index:: rtems_tcb
+
+.. _InterfaceRtemsTcb:
+
+rtems_tcb
+---------
+
+This structure represents the :term:`TCB`.
+
+.. Generated from spec:/rtems/type/if/time-of-day
+
+.. index:: rtems_time_of_day
+
+.. _InterfaceRtemsTimeOfDay:
+
+rtems_time_of_day
+-----------------
+
+This type represents Classic API calendar times.
+
+.. rubric:: MEMBERS:
+
+year
+ This member contains the year A.D.
+
+month
+ This member contains the month of the year with values from 1 to 12.
+
+day
+ This member contains the day of the month with values from 1 to 31.
+
+hour
+ This member contains the hour of the day with values from 0 to 23.
+
+minute
+ This member contains the minute of the hour with values from 0 to 59.
+
+second
+ This member contains the second of the minute with values from 0 to 59.
+
+ticks
+ This member contains the clock tick of the second with values from 0 to
+ :ref:`InterfaceRtemsClockGetTicksPerSecond` minus one.
+
+.. Generated from spec:/rtems/timer/if/information
+
+.. index:: rtems_timer_information
+
+.. _InterfaceRtemsTimerInformation:
+
+rtems_timer_information
+-----------------------
+
+The structure contains information about a timer.
+
+.. rubric:: MEMBERS:
+
+the_class
+ The timer class member indicates how the timer was most recently fired.
+
+initial
+ This member indicates the initial requested interval.
+
+start_time
+ This member indicates the time the timer was initially scheduled. The time
+ is in clock ticks since the clock driver initialization or the last clock
+ tick counter overflow.
+
+stop_time
+ This member indicates the time the timer was scheduled to fire. The time is
+ in clock ticks since the clock driver initialization or the last clock tick
+ counter overflow.
+
+.. Generated from spec:/rtems/timer/if/service-routine
+
+.. index:: rtems_timer_service_routine
+
+.. _InterfaceRtemsTimerServiceRoutine:
+
+rtems_timer_service_routine
+---------------------------
+
+This type defines the return type of routines which can be fired by directives
+of the Timer Manager.
+
+.. rubric:: DESCRIPTION:
+
+This type can be used to document timer service routines in the source code.
+
+.. Generated from spec:/rtems/timer/if/service-routine-entry
+
+.. index:: rtems_timer_service_routine_entry
+
+.. _InterfaceRtemsTimerServiceRoutineEntry:
+
+rtems_timer_service_routine_entry
+---------------------------------
+
+This type defines the prototype of routines which can be fired by directives of
+the Timer Manager.
+
+.. Generated from spec:/rtems/intr/if/vector-number
+
+.. index:: rtems_vector_number
-``uint64_t``
- The C99 data type that corresponds to unsigned sixty-four bit integers. This
- data type is defined by RTEMS in a manner that ensures it is portable across
- different target processors.
+.. _InterfaceRtemsVectorNumber:
-.. index:: uintptr_t
+rtems_vector_number
+-------------------
-``uintptr_t``
- The C99 data type that corresponds to the unsigned integer type that is of
- sufficient size to represent addresses as unsigned integers. This data type
- is defined by RTEMS in a manner that ensures it is portable across different
- target processors.
+This integer type represents interrupt vector numbers.
diff --git a/c-user/scheduling-concepts/directives.rst b/c-user/scheduling-concepts/directives.rst
index 1827060..7d365ad 100644
--- a/c-user/scheduling-concepts/directives.rst
+++ b/c-user/scheduling-concepts/directives.rst
@@ -54,8 +54,8 @@ Identifies a scheduler by the object name.
This parameter is the scheduler name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the scheduler will be
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the scheduler will be
stored in this object.
.. rubric:: DESCRIPTION:
@@ -120,8 +120,8 @@ Identifies a scheduler by the processor index.
This parameter is the processor index to identify the scheduler.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the scheduler will be
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the scheduler will be
stored in this object.
.. rubric:: RETURN VALUES:
@@ -184,8 +184,8 @@ Identifies a scheduler by the processor set.
processor set will be used to identify the scheduler.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the scheduler will be
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the scheduler will be
stored in this object.
.. rubric:: DESCRIPTION:
@@ -254,9 +254,9 @@ Gets the maximum task priority of the scheduler.
This parameter is the scheduler identifier.
``priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` object.
- When the directive the maximum priority of the scheduler will be stored in
- this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
+ object. When the directive the maximum priority of the scheduler will be
+ stored in this object.
.. rubric:: RETURN VALUES:
@@ -375,10 +375,10 @@ Maps a POSIX thread priority to the corresponding Classic API task priority.
This parameter is the POSIX thread priority to map.
``priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` object.
- When the directive call is successful, the Classic API task priority value
- corresponding to the specified POSIX thread priority value will be stored
- in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
+ object. When the directive call is successful, the Classic API task
+ priority value corresponding to the specified POSIX thread priority value
+ will be stored in this object.
.. rubric:: RETURN VALUES:
diff --git a/c-user/semaphore/directives.rst b/c-user/semaphore/directives.rst
index 5a66ac1..94b83b8 100644
--- a/c-user/semaphore/directives.rst
+++ b/c-user/semaphore/directives.rst
@@ -75,9 +75,9 @@ Creates a semaphore.
the attribute set.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created semaphore will
- be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created semaphore
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -278,9 +278,9 @@ Identifies a semaphore by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -862,9 +862,10 @@ Sets the priority by scheduler for the semaphore.
scheduler.
``old_priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` object.
- When the directive call is successful, the old priority of the semaphore
- corresponding to the specified scheduler will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
+ object. When the directive call is successful, the old priority of the
+ semaphore corresponding to the specified scheduler will be stored in this
+ object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/task/directives.rst b/c-user/task/directives.rst
index dfc90b0..76aa8dc 100644
--- a/c-user/task/directives.rst
+++ b/c-user/task/directives.rst
@@ -74,9 +74,9 @@ Creates a task.
This parameter is the attribute set of the task.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created task will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created task will
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -332,12 +332,13 @@ Constructs a task from the specified task configuration.
.. rubric:: PARAMETERS:
``config``
- This parameter is the task configuration.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskConfig` object.
+ It configures the task.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the constructed task will
- be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the constructed task
+ will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -475,9 +476,9 @@ Identifies a task by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1162,10 +1163,10 @@ Sets the real priority or gets the current priority of the task.
:c:macro:`RTEMS_CURRENT_PRIORITY` to get the current priority.
``old_priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` object.
- When the directive call is successful, the current or previous priority of
- the task with respect to its :term:`home scheduler` will be stored in this
- object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
+ object. When the directive call is successful, the current or previous
+ priority of the task with respect to its :term:`home scheduler` will be
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -1261,9 +1262,9 @@ Gets the current priority of the task with respect to the scheduler.
This parameter is the scheduler identifier.
``priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` object.
- When the directive call is successful, the current priority of the task
- with respect to the specified scheduler will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
+ object. When the directive call is successful, the current priority of the
+ task with respect to the specified scheduler will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1630,9 +1631,9 @@ Gets the home scheduler of the task.
may be used to specify the calling task.
``scheduler_id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the :term:`home scheduler`
- of the task will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the :term:`home
+ scheduler` of the task will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/timer/directives.rst b/c-user/timer/directives.rst
index f020de4..3c13675 100644
--- a/c-user/timer/directives.rst
+++ b/c-user/timer/directives.rst
@@ -55,9 +55,9 @@ Creates a timer.
This parameter is the object name of the timer.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created timer will be
- stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created timer will
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -137,9 +137,9 @@ Identifies a timer by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -811,7 +811,7 @@ Gets information about the timer.
This parameter is the timer identifier.
``the_info``
- This parameter is the pointer to an :c:type:`rtems_timer_information`
+ This parameter is the pointer to an :ref:`InterfaceRtemsTimerInformation`
object. When the directive call is successful, the information about the
timer will be stored in this object.
diff --git a/c-user/user-extensions/directives.rst b/c-user/user-extensions/directives.rst
index ac04cdd..78955ba 100644
--- a/c-user/user-extensions/directives.rst
+++ b/c-user/user-extensions/directives.rst
@@ -64,9 +64,9 @@ Creates an extension set.
set.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the identifier of the created extension set
- will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the identifier of the created extension
+ set will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -219,9 +219,9 @@ Identifies an extension set by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an :c:type:`rtems_id` object. When the
- directive call is successful, the object identifier of an object with the
- specified name will be stored in this object.
+ This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When
+ the directive call is successful, the object identifier of an object with
+ the specified name will be stored in this object.
.. rubric:: DESCRIPTION:
More information about the vc
mailing list