shell: Rename HALT to SHUTDOWN command

Use a normal command for shutdown via exit().
This commit is contained in:
Sebastian Huber
2014-11-17 15:42:57 +01:00
parent e02d5dd9b3
commit bac3d6df35
4 changed files with 23 additions and 36 deletions

View File

@@ -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