Changeset a0bf79c in rtems-docs

Timestamp:

11/01/21 19:40:55 (8 months ago)

Author:

Kinsey Moore <kinsey.moore@…>

Branches:

master

Children:

fa25208

Parents:

ac8f461

git-author:

Kinsey Moore <kinsey.moore@…> (11/01/21 19:40:55)

git-committer:

Joel Sherrill <joel@…> (11/03/21 13:25:36)

Message:

c-user: Update for application CONFIGURE option

This adds the documentation for the application configuration option
CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING.

File:

• c-user/config/device-driver.rst (modified) (1 diff)

c-user/config/device-driver.rst

@@ -605 +605 @@
     :ref:`CONFIGURE_APPLICATION_NEEDS_ATA_DRIVER` is defined.
 
+.. Generated from spec:/acfg/if/exception-to-signal-mapping
+
+.. index:: CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING
+
+.. _CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING:
+
+CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING
+-------------------------------------
+
+CONSTANT:
+    ``CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING``
+
+OPTION TYPE:
+    This configuration option is a boolean feature define.
+
+DEFAULT CONFIGURATION:
+    If this configuration option is undefined, then the described feature is not
+    enabled.
+
+DESCRIPTION:
+    In case this configuration option is defined, then the machine exception to
+    POSIX signal mapping is configured during system initialization.
+
+NOTES:
+    This device driver is responsible for setting up a mapping from machine
+    exceptions to POSIX signals so that applications may consume them and alter
+    task execution as necessary.
+
+    This is especially useful for applications written in Ada or C++.
+
 .. Generated from spec:/acfg/if/max-drivers