Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

th (Trace to Next Branching Instruction)

The th command executes the program until it reaches any kind of branching instruction, including conditional or unconditional branches, calls, returns, and system calls.

User-Mode

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

Kernel-Mode


    th [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 thr, 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 branching instructions that the debugger must encounter for the th command to end. The default value is one.

Environment

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 th command causes the target to begin executing. Execution continues until the debugger reaches a branching instruction or encounters a breakpoint.

If the program counter is already on a branching instruction, the debugger traces into the branching instruction and continues executing until another branching instruction is reached. This tracing, rather than execution, of the call is the only difference between th and ph (Step to Next Branching Instruction).

th is available for all live sessions. This availability is the primary difference between th and tb (Trace to Next Branch).

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

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.