Edit

Share via

.pcmd (Set Prompt Command)

  • Article

The .pcmd command causes the debugger to issue a command whenever the target stops executing and to display a prompt in the Debugger Command window with register or target state information.

.pcmd -s CommandString 
.pcmd -c 
.pcmd

Parameters

-s **** CommandString
Specifies a new prompt command string. Whenever the target stops executing, the debugger issues and immediately runs the CommandString command. If CommandString contains spaces or semicolons, you must enclose it in quotation marks.

-c
Deletes any existing prompt command string.

Environment

Item Description
Modes User mode, kernel mode
Targets Live, crash dump
Platforms All

Additional Information

For more information about the Debugger Command window prompt, see Using Debugger Commands.

Remarks

If you use the .pcmd command without parameters, the current prompt command is displayed.

When you set a prompt command by using .pcmd -s, the specified CommandString is issued whenever the target stops executing (for example, when a g, p, or t command ends). The CommandString command is not issued when you use a non-execution command, unless that command displays registers or target state information.

In the following example, the first use of .pcmd sets a fixed string that appears with the prompt. The second use of .pcmd causes the debugger to display the target's current process ID and thread ID every time that the prompt appears. The special prompt does not appear after the .ttime command is used, because that command does not involve execution.

0:000> .pcmd
No per-prompt command

0:000> .pcmd -s ".echo Execution is done."
Per-prompt command is '.echo Execution is done.'

0:000> t
Prymes!isPrime+0xd0:
004016c0 837dc400      cmp dword ptr [ebp-0x3c],0x0 ss:0023:0012fe70=00000002
Execution is done.

0:000> t
Prymes!isPrime+0xd4:
004016c4 7507             jnz     Prymes!isPrime+0xdd (004016cd)
 [br=1]
Execution is done.

0:000> .ttime
Created: Thu Aug 21 13:18:59 2003
Kernel:  0 days 0:00:00.031
User:    0 days 0:00:00.000

0:000> .pcmd -s "r $tpid, $tid"
Per-prompt command is 'r $tpid, $tid'

0:000> t
Prymes!isPrime+0xdd:
004016cd ebc0             jmp     Prymes!isPrime+0x9f (0040168f)
$tpid=0000080c $tid=00000514

0:000> t
Prymes!isPrime+0x9f:
0040168f 8b55fc           mov     edx,[ebp-0x4]     ss:0023:0012fea8=00000005
$tpid=0000080c $tid=00000514