[rtems-docs commit] c-user: Update for application CONFIGURE option

Joel Sherrill joel at rtems.org
Wed Nov 3 13:35:52 UTC 2021


Module:    rtems-docs
Branch:    master
Commit:    a0bf79c39ace76a91779ca811e26f859ae2ec911
Changeset: http://git.rtems.org/rtems-docs/commit/?id=a0bf79c39ace76a91779ca811e26f859ae2ec911

Author:    Kinsey Moore <kinsey.moore at oarcorp.com>
Date:      Mon Nov  1 14:40:55 2021 -0500

c-user: Update for application CONFIGURE option

This adds the documentation for the application configuration option
CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING.

---

 c-user/config/device-driver.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/c-user/config/device-driver.rst b/c-user/config/device-driver.rst
index 22002f9..5d1081a 100644
--- a/c-user/config/device-driver.rst
+++ b/c-user/config/device-driver.rst
@@ -604,6 +604,36 @@ NOTES:
     This configuration option is only evaluated if the configuration option
     :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
 
 .. index:: CONFIGURE_MAXIMUM_DRIVERS



More information about the vc mailing list