Changeset 8babe99 in rtems


Ignore:
Timestamp:
Jul 13, 2011, 6:35:56 PM (8 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.11, master
Children:
aa03052
Parents:
f4adc0d1
Message:

2011-07-13 Joel Sherrill <joel.sherrilL@…>

PR 1824/cpukit

  • bsp_howto/init.t, bsp_howto/support.t, user/init.t: Return exit/shutdown status back to boot_card().
Location:
doc
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • doc/ChangeLog

    rf4adc0d1 r8babe99  
     12011-07-13      Joel Sherrill <joel.sherrilL@OARcorp.com>
     2
     3        PR 1824/cpukit
     4        * bsp_howto/init.t, bsp_howto/support.t, user/init.t: Return
     5        exit/shutdown status back to boot_card().
     6
    172011-05-23      Joel Sherrill <joel.sherrilL@OARcorp.com>
    28
  • doc/bsp_howto/init.t

    rf4adc0d1 r8babe99  
    9898until it calls @code{exit}, @code{rtems_shutdown_executive}, or some
    9999other normal termination initiating routine and control is returned
    100 to @code{bootcard.c} which allows the BSP to perform some clanup in C
     100to @code{bootcard.c} which allows the BSP to perform some cleanup in C
    101101(@code{bsp_cleanup}) and then @code{boot_card} returns to the assembly
    102102language which initially invoked it.
  • doc/bsp_howto/support.t

    rf4adc0d1 r8babe99  
    183183If your BSP does not want to support dynamic heap extension, then you do not have to do anything special.  However, if you want to support @code{sbrk}, you must provide an implementation of this method and define @code{CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK} in @code{bsp.h}.  This informs @code{rtems/confdefs.h} to configure the Malloc Family Extensions which support @code{sbrk}.
    184184
    185 @section bsp_cleanup() - Cleanup the Hardware
     185@section bsp_cleanup(uint32_t status) - Cleanup the Hardware
    186186
    187187The @code{bsp_cleanup()} is the last C code invoked.  Most of the BSPs
     
    195195The @code{bsp_cleanup()} routine can be used to return to a ROM monitor,
    196196insure that interrupt sources are disabled, etc..  This routine is the
    197 last place to insure a clean shutdown of the hardware.  On some BSPs,
    198 it prints a message indicating that the application completed execution
    199 and waits for the user to press a key before resetting the board.
    200 The PowerPC/gen83xx and PowerPC/gen5200 BSPs do this when they are built
    201 to support the FreeScale evaluation boards.  This is convenient when
    202 using the boards in a development environment and may be disabled for
    203 production use.
     197last place to ensure a clean shutdown of the hardware.  The @code{status}
     198argument is the value passed to the service which initiated shutting
     199down RTEMS.  All of the non-fatal shutdown sequences ultimately pass
     200their exit status to @code{rtems_shutdown_executive} and this is what
     201is passed to this routine.
     202
     203On some BSPs, it prints a message indicating that the application
     204completed execution and waits for the user to press a key before
     205resetting the board.  The PowerPC/gen83xx and PowerPC/gen5200 BSPs do
     206this when they are built to support the FreeScale evaluation boards.
     207This is convenient when using the boards in a development environment
     208and may be disabled for production use.
    204209
    205210@section Configuration Macros
  • doc/user/init.t

    rf4adc0d1 r8babe99  
    350350@findex rtems_initialize_start_multitasking
    351351@example
    352 void rtems_initialize_start_multitasking(void);
     352uint32_t rtems_initialize_start_multitasking(void);
    353353@end example
    354354@end ifset
     
    362362@subheading DIRECTIVE STATUS CODES:
    363363
    364 NONE
     364This directive returns the status code passed in to the
     365@code{@value{DIRPREFIX}shutdown_executive}.
    365366
    366367@subheading DESCRIPTION:
Note: See TracChangeset for help on using the changeset viewer.