dexamine

Format:

dexamine [ –column_count cnt ] [ –count cnt ] [ –data_only ] [ –show_chars ]
[ –string_length len ] [ –format fmt ] [ –memory_info ]
[ –wordsize size ] variable_or_expression

Arguments:

–cols cnt
–column_count cnt

Specifies the number of columns to display. Without this option, the CLI determines this number of columns based on the data’s wordactid size and format.

–c cnt
–count cnt

Specifies the number of elements to examine. Without this option, the CLI displays the entire object. This number is determined by the object’s datatype. If no type is available, the default value for cnt is 1 element.

–d
–data_only

Does not display memory values with a prefixed address: field or address annotations. This option is incompatible with –memory_info.

–f fmt
–format fmt

Specifies the format to use when displaying memory. The default format is hex. You can abbreviate each of these to the first character in the format’s name.

address

Interprets memory as addresses; the word size is always the size of a pointer

binary

Binary; this can also be abbreviated to t

char

Unsigned character

dec

Signed decimal value of size 1, 2, 4, or 8 bytes

float

Signed float value, either 4 or 8 byte word size

hex

Unsigned hexadecimal value of size 1, 2, 4, or 8 bytes

instruction

Sequence of instructions

oct

Unsigned octal value of size 1, 2, 4, or 8 bytes

string

String

–m
–memory_info

Shows information about the type of memory associated with the address. Without this option, the CLI does not display this information. This argument is incompatible with –data_only. When you use this option, the CLI annotates address each line in the dump as follows:

[d]: .data
[t]: .text
[p]: .plt
[b]: .bss
[?]: Another type of memory (such as stack address)

If you have enabled memory debugging, the following annotations can also appear:

[A]: Allocated block of memory
[D]: Deallocated block of memory
[G]: Address is a guard region
[C]: Address is a corrupted guard region

If the address being examined is within an allocated block, this option tells the Memory Debugger to automatically include the pre-guard region if the user specified guards in the memory debugging configuration.

–sc
–show_chars

Shows a trailing character dump for each line. Without this option, the CLI does not show the trailing characters.

–sl len
–string_length len

Specifies the maximum size string to display. Without this option, the length is all characters up to the first null character.

–w size
–wordsize size

Specifies the “word size” to apply to the format. The default word size is '1' for most formats. For 'address' format, the word size is always the size of a target pointer. The values can be 1, 2, 4, 8 or one of the following: b (byte), h (half word), w (word), or g (giant).

variable_or_expression

A variable or an expression that can be resolved into a memory address.

Description:

Examines memory at the address of the specified variable or the address resulting from the evaluation of an expression. If you specify an expression, the result of the evaluation must be an lvalue.

In most cases, you will enclose the expression in {} symbols.

Instead of using the listed dexamine options, you can instead use the gdb examine command syntax.

Command alias:


Alias	Definition	Description
x	dexamine	Examines (dumps) memory