Multicore Commands in Debugger Shell

In addition to the multicore-specific toolbar buttons and menu commands available in the Debug view, the Debugger Shell has Multicore specific commands that can control the operation of one or more processor cores at the same time. Like the menu commands, the Multicore debugger shell commands allow you to select, start, and stop a specific core. You can also restart or kill sessions executing on a particular core. The table below lists and defines the affect of each Multicore debugging command.

Table 1. Multicore Debugging Commands
Command Shortcut Description
mc::go mc::g Resume multiple cores

Syntax

go

Examples

mc::go

Resumes the selected cores associated with the current thread context.

mc::kill mc::kill Terminates the debug session for selected cores associated with the current thread context.

Syntax

mc::kill

Examples

mc::kill

Terminates multiple cores.

mc::restart mc::restart Restarts the debug session for selected cores associated with the current thread context.

Syntax

mc::restart

Examples

mc::restart

Restarts multiple cores

mc::stop mc::stop Stops the selected cores associated with the current thread context.

Syntax

mc::stop

Examples

mc::stop

Suspends multiple cores

mc::group mc::gr Display or edit multicore groups

Syntax

group group new <type-name> [<name>] group rename <name>|<group-index> <new-name>group remove <name>|<group-index> ... group removeall group enable|disable <index> ...|all

Examples

mc::group

Shows the defined groups, including indices for use in the mc::group rename|enable|remove set of commands.

mc::group new 8572

Creates a new group for system type 8572. The group name will be based on the system name and will be unique. The enablement of the group elements will be all non-cores enabled, all cores disabled.

mc::group rename 0 "My Group Name"

Renames the group at index 0 to "My Group Name".

mc::group enable 0 0.0

Enables the group at index 0 and the element at index 0.0 of the mc::group command.

mc::group remove "My Group Name"

Removes the group named "My Group Name".

mc::group removeall

Removes all groups.

mc::type mc::t Shows the system types available for multicore debugging as well as type indices for use by the mc::type remove and mc::group new commands.

Syntax

type type import <filename> type remove <filename>|<type-index> ... type removeall

Examples

mc::type

Display or edit system types

mc::type import 8572_jtag.txt

Creates a new type from the JTAG configuration file.

mc::type remove 8572_jtag.txt

Removes the type imported from the specified file.

mc::group removeall

Removes all imported types.