2.3.49. DOWN

Moves the variable scope and source location down the stack (that is, away from the program entry point, towards the current PC).

Syntax

DOWN [levels]

where:

levels

Specifies the number of stack levels to move down. This must be a positive number.

Description

This command moves the current variable scope, and source or disassembly view location down the stack by the specified number of levels. The debugger modifies the local variable scope to display the variables in the new location, and potentially hiding those at the previous level.

If you are already at the lowest level (nearest to the program entry point), a message reminds you that you cannot move down any more. You must have used an UP command or a SCOPE command before a DOWN command becomes meaningful. You can move down one level by using the command without parameters.

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

Example

The following example shows how to use DOWN. The UP command moves the context up the stack to the enclosing function, so that a variable index is in scope. The value of the index variable is examined. Another variable, count, is examined by looking at the preceding function. When count is displayed, the DOWN 2 command is used to return down the stack two levels, to the scope of the initial function.

> up
> ce index
index = 3
> up
> ce count
count = 55
> down 2

See also

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