.create (Create Process)

The .create command creates a new target application.

.create [-premote RemoteOptions] [-f] CommandLine 

Parameters

RemoteOptions
Specifies a process server to which to attach. The options are the same as those for the command line -premote option. See Activating a Smart Client for syntax details.

-f
Freezes all threads in all target applications, except in the new target being created. These threads will remain frozen until an exception occurs in the newly-created process. Note that an initial breakpoint qualifies as an exception. Individual threads can be unfrozen by using the ~u (Unfreeze Thread) command.

CommandLine
Specifies the complete command line for the new process. CommandLine may contain spaces, and must not be surrounded with quotes. All text after the .create command is taken as part of CommandLine; this command cannot be followed with a semicolon and additional debugger commands.

Environment

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

Remarks

This command can be used when CDB is dormant, or if it is already debugging one or more processes. It cannot be used when WinDbg is dormant.

If this command is successful, the debugger will create the specified process the next time the debugger issues an execution command. If this command is used several times in a row, execution will have to be requested as many times as this command was used.

Multiple target processes will always be executed together, unless some of their threads are frozen or suspended.

If you wish to create a new process and freeze all your existing targets, use the -f option.

If the -premote option is used, the new process will be part of a new system. For details, see Debugging Multiple Targets.