Executing Out of a Function

You can step your program out of a function by using the Out commands. The eight Out commands in the GUI are located on the Group, Process, and Thread menus.

CLI: dfocus ... dout

If the source line that is the goal of the Out operation has more than one statement, TotalView will stop execution just after the routine from which it just emerged. For example, suppose that the following is your source line:

routine1; routine2;

Suppose you step into routine1, then use an Out command. While the PC arrow in the Source Pane still points to this same source line, the actual PC is just after routine1. This means that if you use a step command, you will step into routine2.

The PC arrow does not move when the source line only has one statement on it. The internal PC does, of course, change.

You can also return out of several functions at once, by selecting the routine in the Stack Trace Pane that you want to go to, and then selecting an Out command.

If your program calls recursive functions, you can select a nested stack frame in the Stack Trace Pane to indicate which instance you are running out of.