switchtarget

Displays information about debugged threads, processes and connections or changes the debug context for subsequent commands.

Syntax

switchtarget [<index> | -cur | -ResetIndex -pid | -tid | -conn | -arch]

switchtarget -tid [-pid=<procID>] [[-arch==<name>] | [-conn==<name>]]

switchtarget -pid [[-arch==<name>] | [-conn==<name>]]

switchtarget -arch [-conn==<name>]

switchtarget -conn [-arch==<name>]

switchtarget [-pid=<procID>] [-tid=<threadID>] [[-arch==<name>] | [- conn==<name>]]

Parameter

index

Session Index number.

Examples

The following table lists and defines examples of the switchtarget command.

Table 1. `switchtarget` Command-line debugger command - Examples
Command	Description
`switchtarget`	Lists currently available debug sessions.
`switchtarget 0`	Selects the thread with index 0
`switchtarget -cur`	Lists the index of the current thread.
`switchtarget -ResetIndex`	Resets the index counter to 0, not valid while debugging.
`switchtarget -tid`	Lists the thread IDs of the current process of the current connection.
`switchtarget -pid`	Lists the process IDs of the debugged processes of the current connection.
`switchtarget -pid -arch=EPPC`	Lists the process IDs of the debugged processes of EPPC architecture on the current debug system.
`switchtarget -pid -conn=Launch-1`	Lists the process IDs of the debugged processes of the Launch-1 connection.
`switchtarget -arch -conn=Launch-1`	Lists the architectures debugged on Launch-1 connection.
`switchtarget -conn -arch=EPPC`	Lists the name of the connection of EPPC architecture on the current debug system.
`switchtarget -pid=0 -tid=0 -arch=EPPC`	Switches current context to thread 0 of process 0 of EPPC architecture on the current debug system.
`switchtarget -pid=0 -tid=0 -conn=Launch-1`	Switches current context to thread 0 of process 0 on Launch-1 connection.