forked from Imagelibrary/rtems
shell: Rename HALT to SHUTDOWN command
Use a normal command for shutdown via exit().
This commit is contained in:
@@ -11,7 +11,7 @@ The RTEMS shell has the following rtems commands:
|
||||
|
||||
@itemize @bullet
|
||||
|
||||
@item @code{halt} - Shutdown the system
|
||||
@item @code{shutdown} - 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
|
||||
@@ -42,14 +42,14 @@ command as well as providing an example usage.
|
||||
@c
|
||||
@c
|
||||
@page
|
||||
@subsection halt - Shutdown the system
|
||||
@subsection shutdown - Shutdown the system
|
||||
|
||||
@pgindex halt
|
||||
@pgindex shutdown
|
||||
|
||||
@subheading SYNOPSYS:
|
||||
|
||||
@example
|
||||
halt
|
||||
shutdown
|
||||
@end example
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
@@ -65,10 +65,11 @@ This command does not return.
|
||||
|
||||
@subheading EXAMPLES:
|
||||
|
||||
The following is an example of how to use @code{halt}:
|
||||
The following is an example of how to use @code{shutdown}:
|
||||
|
||||
@example
|
||||
SHLL [/] $ halt
|
||||
SHLL [/] $ shutdown
|
||||
System shutting down at user request
|
||||
@end example
|
||||
|
||||
The user will not see another prompt and the system will
|
||||
@@ -76,37 +77,25 @@ shutdown.
|
||||
|
||||
@subheading CONFIGURATION:
|
||||
|
||||
@findex CONFIGURE_SHELL_NO_COMMAND_HALT
|
||||
@findex CONFIGURE_SHELL_COMMAND_HALT
|
||||
@findex CONFIGURE_SHELL_NO_COMMAND_SHUTDOWN
|
||||
@findex CONFIGURE_SHELL_COMMAND_SHUTDOWN
|
||||
|
||||
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
|
||||
@code{CONFIGURE_SHELL_COMMAND_SHUTDOWN} 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
|
||||
defining @code{CONFIGURE_SHELL_NO_COMMAND_SHUTDOWN} 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
|
||||
The configuration structure for the @code{shutdown} has the
|
||||
following prototype:
|
||||
|
||||
@example
|
||||
extern rtems_shell_cmd_t rtems_shell_HALT_Command;
|
||||
extern rtems_shell_cmd_t rtems_shell_SHUTDOWN_Command;
|
||||
@end example
|
||||
|
||||
@c
|
||||
|
||||
Reference in New Issue
Block a user