RTEMS 4.9.6 On-Line Library

Memory Commands wdump - display contents of memory (word)

RTEMS Shell User's Guide

4.2.2: wdump - display contents of memory (word)

SYNOPSYS:

wdump [address [length]]

DESCRIPTION:

This command displays the contents of memory at the address and length in bytes specified on the command line.

When length is not provided, it defaults to 320 which is twenty lines of output with sixteen bytes of output per line.

When address is not provided, it defaults to 0x00000000.

EXIT STATUS:

This command always returns 0 to indicate success.

NOTES:

Dumping memory from a non-existent address may result in an unrecoverable program fault.

EXAMPLES:

The following is an example of how to use wdump:

SHLL [/] $ wdump 0x02010000 32
0x02010000 0201 08D8 0201 08C0-0201 08AC 0201 0874 ...............t
0x02010010 0201 0894 0201 0718-0201 0640 0201 0798 ...............

CONFIGURATION:

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

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

PROGRAMMING INFORMATION:

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

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

The configuration structure for the wdump has the following prototype:

extern rtems_shell_cmd_t rtems_shell_WDUMP_Command;

RTEMS Shell User's Guide