2.3.54. DUMP

Displays memory contents in hexadecimal or ASCII format.

Syntax

DUMP [{/B|/H|/W|/8|/16|/32}] [{address | address-range}]

Note

/B|/H|/W are deprecated in this release.

where:

/B | /8

Sets the display format to 8 bits. Each line of output displays 16 bytes.

/H | /16

Sets the display format to 16 bits. Each line of output displays eight 16-bit values.

/W | /32

Sets the display format to 32 bits. Each line of output displays four 32-bit values.

Note

If no display format is specified, the default is the native format for the debug target. For example, the ARM7TDMI processor naturally addresses 8 bits.

address

Specifies a memory address at which to begin the display of contents. If the start address is at an offset from the address of a line, then any values at addresses before the start address are not displayed. The remainder of that line and the whole of the following line are displayed. For an example, see Examples.

address-range

Specifies a range of memory addresses whose contents are to be displayed. If the start address is at an offset from the address of a line, then any values at addresses before the start address are not displayed. If the end address is at an offset from the address of a line, then any values at addresses after the end address are not displayed. For an example, see Examples.

Description

The DUMP command displays memory contents in 8-bit, 16-bit or 32-bit hexadecimal values and ASCII characters on the screen. If you are using the GUI, then they are displayed in the Output view.

If you do not specify any parameters, the next five lines of data after the previously dumped address range are displayed. In the character output format, nonprintable characters (such as a carriage return) are represented by a period (.).

The DUMP command runs synchronously unless background access to target memory is supported. Use the WAIT command to force it to run synchronously.

Examples

The following example illustrates the output of DUMP. The first example displays two rows of memory from 0x8000.

> dump 0x8000
  0x00008000 00 00 00 EA 24 06 00 EA  28 C0 8F E2 00 0C 9C E8 ....$...(.......
  0x00008010 0C A0 8A E0 01 70 4A E2  0C B0 8B E0 0B 00 5A E1 .....pJ.......Z.

Executing DUMP again displays a page of memory from 0x8020.

> dump
             +0 +1 +2 +3 +4 +5 +6 +7  +8 +9 +A +B +C +D +E +F
             ------------------------------------------------
  0x00008020 86 06 00 0A 0F 00 BA E8  14 E0 4F E2 01 00 13 E3 ..........O.....
  0x00008030 03 F0 47 10 03 F0 A0 E1  54 6A 00 00 64 6A 00 00 ..G.....Tj..dj..
  0x00008040 00 30 A0 E3 00 40 A0 E3  00 50 A0 E3 00 60 A0 E3 .0...@...P...`..
  0x00008050 10 20 52 E2 78 00 A1 28  FC FF FF 8A 82 2E B0 E1 . R.x..(........
  0x00008060 30 00 A1 28 00 30 81 45  0E F0 A0 E1 04 30 9F E5 0..(.0.E.....0..

Requesting a DUMP of memory as 16-bit values, and specifying a range of addresses produces the following result:

> dump /16 0x8338..0x8348
  0x00008330                           4844  5952  5453  4E4F         DHRYSTON
  0x00008340 2045  5250  474F  4152    2C4D                   E PROGRAM,

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111