mdump [address [length]]
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
.
This command always returns 0 to indicate success.
Dumping memory from a non-existent address may result in an unrecoverable program fault.
The following is an example of how to use mdump
:
SHLL [/] $ mdump 0x10000 32 0x0001000000 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................ 0x0001001000 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................ SHLL [/] $ mdump 0x02000000 32 0x02000000A1 48 00 00 29 00 80 33-81 C5 22 BC A6 10 21 00 .H..)..3.."...!. 0x02000010A1 48 00 00 29 00 80 33-81 C5 22 BC A6 10 21 01 .H..)..3.."...!. SHLL [/] $ mdump 0x02001000 32 0x0200100003 00 80 00 82 10 60 00-81 98 40 00 83 48 00 00 ......`.....H.. 0x0200101084 00 60 01 84 08 A0 07-86 10 20 01 87 28 C0 02 ..`....... ..(..
This command is included in the default shell command set.
When building a custom command set, define
CONFIGURE_SHELL_COMMAND_MDUMP
to have this
command included.
This command can be excluded from the shell command set by
defining CONFIGURE_SHELL_NO_COMMAND_MDUMP
when all
shell commands have been configured.
The mdump
is implemented by a C language function
which has the following prototype:
int rtems_shell_rtems_main_mdump( int argc, char **argv );
The configuration structure for the mdump
has the
following prototype:
extern rtems_shell_cmd_t rtems_shell_MDUMP_Command;
Copyright © 1988-2008 OAR Corporation