Target Control Debugging Commands (Windows Embedded CE 6.0)
1/5/2010
You can use commands for the Target Control service shell to transfer files to a target device and to debug applications.
In addition shell commands, Target Control offers important debugger extension commands that enable you to load and manage debugger DLLs. For more information about these, see Debugger Extension Commands.
There are two ways to enter Target Control commands:
- If you use a command prompt window, enter commands at the Windows Embedded CE prompt.
- If you use Platform Builder, from the Target menu choose Target Control to display the Target Control window. Enter commands in the Target Control window.
The following line shows how to enter the commands.
[commands]
The following table lists the command options supported for Target Control Debugging.
| Option | Description |
|---|---|
? |
Displays a list of commands. |
Break |
Breaks into the Microsoft kernel debugger program. |
DdAddress [Size] |
Dumps DWORD values. For information about the parameters supported for the dd command, see Target Control Debugging: dd Command. |
dfFilename Address Size |
Dumps DWORD values to a file. For information about the parameters supported for the df command, see Target Control Debugging: df Command. |
Dis |
This function forces the operating system to swap out all discardable pages from memory. See ForcePageout. |
giproc | thrd | mod | delta | all |
Gets information on processes and processes with threads; modules; critical sections with threads waiting; and events. For information about the parameters supported for the gi command, see Target Control Debugging: gi Command. |
KpPid | Pindex |
Ends a process. For information about the parameters supported for the kp command, see Target Control Debugging: kp Command. |
log[ LogOptions ][ HexWindowsCEZone [ HexUserZone [ HexProcessMask ]]] |
Displays the zones used by the event-tracking subsystem, Celog.lib. You can also use this command to modify zones for the event-tracking subsystem. This command works only if the event-tracking subsystem is running. For information about the parameters supported for the log command, see Target Control Debugging: log Command. |
Mikernel | full |
Displays memory information. For information about the parameters supported for the mi command, see Target Control Debugging: mi Command. |
prof on | off[DataType ][ StorageType][OtherOptions] |
Controls the kernel profiler. This command has an effect only on a Windows Embedded CE OS that supports profiling. For information about the parameters supported for the prof command, see Target Control Debugging: prof Command. |
s Processname |
Starts the process. The Processnameparameter refers to the name of the process. |
runBatchFileName |
Runs a series of processes listed in a text file specified by the BatchFileNameparameter. |
Win |
Dumps the list of windows currently displayed on the target device. |
zop | m Index | Name[Zone, [on | off][ZoneIndex]] |
Performs debugging zone operations. For information about the options and zones supported for the zo command, see Target Control Debugging: zo Command. |
timestamp |
Toggle timestamp on all commands (useful for logs). |
priority [N] |
Change the priority of the shell thread. |
kernfault |
Break into the debugger even if TLSKERN_NOFAULT is enabled. |
kernnofault |
Re-enable default TLSKERN_NOFAULT handling. |
loadext [[-u] DLLName] |
Load shell.exe extension dll. -u : unload extension dll. DLLName : name of DLL to load (i.e. shellext.dll). |
suspend |
Suspend the device. Requires GWES.exe and proper OAL support. |
hd <exe> |
Dumps the processes allocated heap (does not show freed pages). exe: Name of the process without the .exe extension. |
tp <tid> [prio] |
Sets/queries thread priority. tid: Can be either a thread id, 'kitlintr' or 'kitltimer'. prio: Thread priority. -1 or omitted: Query current thread priority. 0 - 255: Set thread priority. |