dwhere

Displays locations in the call stack

Format:

dwhere [ num-levels ] [ -args ]

Arguments:

num-levels

Restricts output to this number of levels of the call stack.

-args

Displays argument names and values in addition to program location information. If you omit this option, arguments are not shown.

Description:

The dwhere command prints the current execution locations and the call stacks--or sequences of procedure calls--which led to that point. Information is shown for threads in the current focus, with the default being to show information at the thread level.

Arguments control the amount of command output in two ways:

• The num-levels argument lets you control how many levels of the call stacks are displayed, counting from the uppermost (most recent) level.
• The -args option tells the CLI that it should also display procedure argument names and values for each stack level.

A dwhere command with no arguments or options displays the call stacks for all threads in the target set.

Output is generated for each thread in the target focus.

Command alias:

You may find the following alias useful:

Alias	Definition	Meaning
w	{dwhere}	Displays the current location

Examples:

dwhere

Displays the call stacks for all threads in the current focus.

dfocus 2.1 dwhere 1

Displays just the most recent level of the call stack corresponding to thread 1 in process 2. This shows just the immediate execution location of a thread or threads.

w 1 -args

Displays the current execution locations (one level only) of threads in the current focus together with the names and values of any arguments that were passed into the current procedures.

f p1.< w 5

Displays the most recent five levels of the call stacks for all threads involved in process 1. If the depth of any call stack is less than five levels, all of its levels are shown.

This command is a slightly more complicated way of saying f p1 w 5 because specifying a process width tells dwhere to ignore the thread indicator.