diff options
author | Joel Sherrill <joel.sherrill@OARcorp.com> | 2009-02-19 19:20:51 +0000 |
---|---|---|
committer | Joel Sherrill <joel.sherrill@OARcorp.com> | 2009-02-19 19:20:51 +0000 |
commit | 0a90bf269be43fb30c853043b0f21eb1e48870ff (patch) | |
tree | 91b90f00bdc71f9eef6239967019b331699be61b /doc/shell | |
parent | 2009-02-19 Joel Sherrill <joel.sherrill@oarcorp.com> (diff) | |
download | rtems-0a90bf269be43fb30c853043b0f21eb1e48870ff.tar.bz2 |
2009-02-19 Joel Sherrill <joel.sherrill@oarcorp.com>
* shell/rtems.t: Add halt command.
Diffstat (limited to 'doc/shell')
-rw-r--r-- | doc/shell/rtems.t | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/doc/shell/rtems.t b/doc/shell/rtems.t index 11906de881..ad1e0e9b09 100644 --- a/doc/shell/rtems.t +++ b/doc/shell/rtems.t @@ -14,6 +14,7 @@ The RTEMS shell has the following rtems commands: @itemize @bullet +@item @code{halt} - Shutdown the system @item @code{cpuuse} - print or reset per thread cpu usage @item @code{stackuse} - print per thread stack usage @item @code{perioduse} - print or reset per period usage @@ -39,6 +40,78 @@ This section details the RTEMS Specific Commands available. A subsection is dedicated to each of the commands and describes the behavior and configuration of that command as well as providing an example usage. + +@c +@c +@c +@page +@subsection halt - Shutdown the system + +@pgindex halt + +@subheading SYNOPSYS: + +@example +halt +@end example + +@subheading DESCRIPTION: + +This command is used to shutdown the RTEMS application. + +@subheading EXIT STATUS: + +This command does not return. + +@subheading NOTES: + + +@subheading EXAMPLES: + +The following is an example of how to use @code{halt}: + +@example +SHLL [/] $ halt +@end example + +The user will not see another prompt and the system will +shutdown. + +@subheading CONFIGURATION: + +@findex CONFIGURE_SHELL_NO_COMMAND_HALT +@findex CONFIGURE_SHELL_COMMAND_HALT + +This command is included in the default shell command set. +When building a custom command set, define +@code{CONFIGURE_SHELL_COMMAND_HALT} to have this +command included. + +This command can be excluded from the shell command set by +defining @code{CONFIGURE_SHELL_NO_COMMAND_HALT} when all +shell commands have been configured. + +@subheading PROGRAMMING INFORMATION: + +@findex rtems_shell_rtems_main_halt + +The @code{halt} is implemented by a C language function +which has the following prototype: + +@example +int rtems_shell_rtems_main_halt( + int argc, + char **argv +); +@end example + +The configuration structure for the @code{halt} has the +following prototype: + +@example +extern rtems_shell_cmd_t rtems_shell_HALT_Command; +@end example + @c @c @c |