diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2021-04-21 09:19:27 +0200 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2021-04-21 09:35:58 +0200 |
commit | f3262d40745c4109f529e0456e011c85bf134917 (patch) | |
tree | 7da3f060070d6ec29616f92ae98ad90c60992445 /c-user/initialization/directives.rst | |
parent | c-user: Document rtems_semaphore_obtain() errors (diff) | |
download | rtems-docs-f3262d40745c4109f529e0456e011c85bf134917.tar.bz2 |
c-user: Split up initialization manager
This makes it easier to automatically generate parts of the module
documentation in the future.
Update #3993.
Diffstat (limited to '')
-rw-r--r-- | c-user/initialization/directives.rst | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/c-user/initialization/directives.rst b/c-user/initialization/directives.rst new file mode 100644 index 0000000..97dea46 --- /dev/null +++ b/c-user/initialization/directives.rst @@ -0,0 +1,41 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + +.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) + +Directives +========== + +This section details the Initialization Manager's directives. A subsection is +dedicated to each of this manager's directives and describes the calling +sequence, related constants, usage, and status codes. + +.. raw:: latex + + \clearpage + +.. index:: initialize RTEMS +.. index:: start multitasking +.. index:: rtems_initialize_executive + +.. _rtems_initialize_executive: + +INITIALIZE_EXECUTIVE - Initialize RTEMS +--------------------------------------- + +CALLING SEQUENCE: + .. code-block:: c + + void rtems_initialize_executive(void); + +DIRECTIVE STATUS CODES: + NONE - This function will not return to the caller. + +DESCRIPTION: + Iterates through the system initialization linker set and invokes the + registered handlers. The final step is to start multitasking. + +NOTES: + This directive should be called by :c:func:`boot_card()` only. + + This directive *does not return* to the caller. Errors in the + initialization sequence are usually fatal and lead to a system termination. |