RTEMS 4.9.1 On-Line Library

RTEMS Specific Commands extension - display information about extensions

RTEMS Shell User's Guide

5.2.7: extension - display information about extensions

SYNOPSYS:

extension [id [id ...] ]

DESCRIPTION:

When invoked with no arguments, this command prints information on the set of User Extensions currently active in the system.

If invoked with a set of ids as arguments, then just those objects are included in the information printed.

EXIT STATUS:

This command returns 0 on success and non-zero if an error is encountered.

NOTES:

NONE

EXAMPLES:

The following is an example of using the extension command on a system with no user extensions.

SHLL [/] $ extension
  ID       NAME
------------------------------------------------------------------------------

CONFIGURATION:

This command is included in the default shell command set. When building a custom command set, define CONFIGURE_SHELL_COMMAND_EXTENSION to have this command included.

This command can be excluded from the shell command set by defining CONFIGURE_SHELL_NO_COMMAND_EXTENSION when all shell commands have been configured.

PROGRAMMING INFORMATION:

The extension is implemented by a C language function which has the following prototype:

int rtems_shell_rtems_main_extension(
  int    argc,
  char **argv
);

The configuration structure for the extension has the following prototype:

extern rtems_shell_cmd_t rtems_shell_EXTENSION_Command;

RTEMS Shell User's Guide