tct (Trace to Next Call or Return)

The tct command executes the program until it reaches a call instruction or return instruction.

User-Mode

[~Thread] tct [r] [= StartAddress] [Count] 

Kernel-Mode

tct [r] [= StartAddress] [Count] 

Parameters

Thread
Specifies threads to continue executing. All other threads are frozen. For more information about the syntax, see Thread Syntax. You can specify threads only in user mode.

r
Turns on and off the display of registers and flags. By default, the registers and flags are displayed. You can disable register display by using the tctr, pr, tr, or .prompt_allow -reg commands. All of these commands control the same setting and you can use any of them to override any previous use of these commands.

You can also disable register display by using the l-os command. This setting is separate from the other four commands. To control which registers and flags are displayed, use the rm (Register Mask) command.

StartAddress
Specifies the address where the debugger begins execution. If you do not use StartAddress, execution begins at the instruction that the instruction pointer points to. For more information about the syntax, see Address and Address Range Syntax.

Count
Specifies the number of call or return instructions that the debugger must encounter for the tct command to end. The default value is one.

Environment

Item Description
Modes user mode, kernel mode
Targets live debugging only
Platforms all

Additional Information

For more information about related commands, see Controlling the Target.

Remarks

The tct command causes the target to begin executing. This execution continues until the debugger reaches a call or return instruction or encounters a breakpoint.

If the program counter is already on a call or return instruction, the debugger traces into the call or return and continues executing until it encounters another call or return. This tracing, rather than execution, of the call is the only difference between tct and pct (Step to Next Call or Return).

In source mode, you can associate one source line with multiple assembly instructions. This command does not stop at a call or return instruction that is associated with the current source line.