Changeset e2e5b492 in rtems


Ignore:
Timestamp:
Nov 14, 2012, 8:51:41 AM (7 years ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
4.11, master
Children:
156e91e
Parents:
b31a960
git-author:
Sebastian Huber <sebastian.huber@…> (11/14/12 08:51:41)
git-committer:
Sebastian Huber <sebastian.huber@…> (11/15/12 14:33:12)
Message:

score: Add rtems_fatal()

Files:
1 added
3 edited

Legend:

Unmodified
Added
Removed
  • cpukit/sapi/Makefile.am

    rb31a960 re2e5b492  
    3838    src/rtemsapi.c src/extensiondata.c src/getversionstring.c \
    3939    src/chainappendnotify.c src/chaingetnotify.c src/chaingetwait.c \
    40     src/chainprependnotify.c src/rbheap.c src/interrdesc.c
     40    src/chainprependnotify.c src/rbheap.c src/interrdesc.c \
     41    src/fatal2.c
    4142libsapi_a_CPPFLAGS = $(AM_CPPFLAGS)
    4243
  • cpukit/sapi/include/rtems/fatal.h

    rb31a960 re2e5b492  
    11/**
    2  * @file rtems/fatal.h
     2 * @file
    33 *
    4  * This include file contains constants and prototypes related
    5  * to the Fatal Error Manager.  This manager processes all fatal or
    6  * irrecoverable errors.
     4 * @ingroup ClassicFatal
    75 *
    8  * This manager provides directives to:
    9  *
    10  *   - announce a fatal error has occurred
     6 * @brief Fatal API.
    117 */
    128
     
    3026#endif
    3127
    32 /*
    33  *  rtems_fatal_error_occurred
     28/**
     29 * @defgroup ClassicFatal Fatal
    3430 *
    35  *  DESCRIPTION:
     31 * @ingroup ClassicRTEMS
    3632 *
    37  *  This is the routine which implements the rtems_fatal_error_occurred
    38  *  directive.  It is invoked when the application or RTEMS
    39  *  determines that a fatal error has occurred.
     33 * @brief The Fatal Manager provides functions for fatal system states and or
     34 * irrecoverable errors.
     35 *
     36 * @{
    4037 */
    4138
     39/**
     40 * @brief Invokes the internal error handler with a source of
     41 * INTERNAL_ERROR_RTEMS_API and is internal set to false.
     42 *
     43 * @param[in] the_error A 32-bit fatal error code.
     44 *
     45 * @return This function will not return.
     46 *
     47 * @see _Internal_error_Occurred().
     48 */
    4249void rtems_fatal_error_occurred(
    4350  uint32_t   the_error
     51) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
     52
     53/**
     54 * @brief Invokes the internal error handler with is internal set to false.
     55 *
     56 * @param[in] source The fatal source.
     57 * @param[in] error The fatal code.
     58 *
     59 * @return This function will not return.
     60 *
     61 * @see _Internal_error_Occurred().
     62 */
     63void rtems_fatal(
     64  rtems_fatal_source source,
     65  rtems_fatal_code error
    4466) RTEMS_COMPILER_NO_RETURN_ATTRIBUTE;
    4567
     
    5476const char *rtems_internal_error_description( rtems_fatal_code error );
    5577
     78/** @} */
     79
    5680#ifdef __cplusplus
    5781}
  • doc/user/fatal.t

    rb31a960 re2e5b492  
    1616@itemize @bullet
    1717@item @code{@value{DIRPREFIX}fatal_error_occurred} - Invoke the fatal error handler
     18@item @code{@value{DIRPREFIX}fatal} - Invoke the fatal error handler with error source
    1819@end itemize
    1920
     
    173174@c
    174175@page
     176@subsection FATAL - Invoke the fatal error handler with error source
     177
     178@cindex announce fatal error
     179@cindex fatal error, announce
     180
     181@subheading CALLING SEQUENCE:
     182
     183@ifset is-C
     184@findex rtems_fatal
     185@example
     186void rtems_fatal(
     187  rtems_fatal_source source,
     188  rtems_fatal_code error
     189);
     190@end example
     191@end ifset
     192
     193@subheading DIRECTIVE STATUS CODES
     194
     195NONE
     196
     197@subheading DESCRIPTION:
     198
     199This directive invokes the internal error handler with is internal set to
     200false.  See also @code{@value{DIRPREFIX}fatal_error_occurred}.
     201
     202@c
     203@c
     204@c
     205@page
    175206@subsection INTERNAL_ERROR_DESCRIPTION - Returns a description for an internal error code
    176207
Note: See TracChangeset for help on using the changeset viewer.