diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2012-11-14 09:51:41 +0100 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2012-11-15 15:33:12 +0100 |
commit | e2e5b49215cabd82f99bdc0c6e1b6f69ff233d19 (patch) | |
tree | 9817613ec2f5d5c474c00ef363d3b42c3b94daa7 /cpukit/sapi/include/rtems/fatal.h | |
parent | score: Add INTERNAL_ERROR_CPU_ISR_INSTALL_VECTOR (diff) | |
download | rtems-e2e5b49215cabd82f99bdc0c6e1b6f69ff233d19.tar.bz2 |
score: Add rtems_fatal()
Diffstat (limited to '')
-rw-r--r-- | cpukit/sapi/include/rtems/fatal.h | 50 |
1 files changed, 37 insertions, 13 deletions
diff --git a/cpukit/sapi/include/rtems/fatal.h b/cpukit/sapi/include/rtems/fatal.h index 8f646a9417..66926054b9 100644 --- a/cpukit/sapi/include/rtems/fatal.h +++ b/cpukit/sapi/include/rtems/fatal.h @@ -1,13 +1,9 @@ /** - * @file rtems/fatal.h + * @file * - * This include file contains constants and prototypes related - * to the Fatal Error Manager. This manager processes all fatal or - * irrecoverable errors. - * - * This manager provides directives to: + * @ingroup ClassicFatal * - * - announce a fatal error has occurred + * @brief Fatal API. */ /* @@ -29,21 +25,47 @@ extern "C" { #endif -/* - * rtems_fatal_error_occurred +/** + * @defgroup ClassicFatal Fatal + * + * @ingroup ClassicRTEMS * - * DESCRIPTION: + * @brief The Fatal Manager provides functions for fatal system states and or + * irrecoverable errors. * - * This is the routine which implements the rtems_fatal_error_occurred - * directive. It is invoked when the application or RTEMS - * determines that a fatal error has occurred. + * @{ */ +/** + * @brief Invokes the internal error handler with a source of + * INTERNAL_ERROR_RTEMS_API and is internal set to false. + * + * @param[in] the_error A 32-bit fatal error code. + * + * @return This function will not return. + * + * @see _Internal_error_Occurred(). + */ void rtems_fatal_error_occurred( uint32_t the_error ) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE; /** + * @brief Invokes the internal error handler with is internal set to false. + * + * @param[in] source The fatal source. + * @param[in] error The fatal code. + * + * @return This function will not return. + * + * @see _Internal_error_Occurred(). + */ +void rtems_fatal( + rtems_fatal_source source, + rtems_fatal_code error +) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE; + +/** * @brief Returns a description for an internal error code. * * @param[in] error The error code. @@ -53,6 +75,8 @@ void rtems_fatal_error_occurred( */ const char *rtems_internal_error_description( rtems_fatal_code error ); +/** @} */ + #ifdef __cplusplus } #endif |