write-reg 3.3 Command Index
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

x

Synopsis

x [object] [cpu-name] address [size] [-c] [group-by] [-l]
<image>.x [address] [offset] [size] [-c] [group-by] [-l]
<memory_space>.x address [size] [-c] [group-by] [-l]
<processor_info>.x [cpu-name] address [size] [-c] [group-by] [-l]

Description

Display the contents of a memory space or image, starting at address. The object parameter can be an image, memory-space or processor object, which implicitly uses the memory space of that processor. There are also namespace versions of the command; namely, the image x command and the memory-space x command. The global version of the command operates on the memory of the current frontend processor by default.

If the memory is accessed via a processor, the type of address is specified by a prefix. For physical addresses use p:<address>; for virtual addresses, v:<address> on non-x86 targets. On x86, use <segment-register>:<offset> or l:<address> for x86 linear addresses. If no prefix is given, the address is assumed to be virtual. On x86 the default is ds:<address> (data segment addressing).

The access will be made in inquiry mode, which means it will have no side-effects on the processor or the accessed object. Use the read command to do non-inquiry accesses.

The size argument specifies the number of bytes to examine. When reading virtual memory, only addresses which can be found in the TLB or hardware page tables (if any) are shown. Unmapped addresses are shown presented "--", undefined physical addresses as "**".

By default the memory contents, from low address to high, is presented from left to right, grouped into 16-bit words. In this format the values shown can be interpreted as big-endian words. The grouping can be modified by the group-by argument and supports 8, 16, 32, 64 and 128 bit words. The -l flag can be used to show the values as little-endian words instead.

The -c flag compresses the output by not displaying sequences of zeros.

Provided By

Simics Core

See Also

disassemble, get, set
write-reg 3.3 Command Index