2.3.71. HALT

Stops target program execution.

Syntax

HALT [[=]threadID]

where:

threadID

Identifies the thread to be stopped when running in RSD mode.

Description

The behavior of the HALT command depends on the whether your program is running on a non OS-aware connection, an OS-aware connection, or a RealMonitor-aware connection.

Using the HALT command on non OS-aware connections

The HALT command stops the processor.

Using the HALT command on OS-aware connections

The behavior of the HALT command depends on whether the processor is running in HSD or RSD mode:

  • If the processor is running in HSD mode, the command stops the processor.

  • If RSD is enabled, the behavior depends on whether or not a thread identifier is specified:

    • If no thread identifier is specified, the command stops either the currently running thread or the thread attached to the Code window.

    • The thread with the identifier specified in the command is stopped.

  • If the processor is running in RSD mode, and you use the HALT command without specifying a thread, the command stops either the currently running thread or the thread attached to the Code window.

  • If the processor is running in RSD mode, and you use the HALT command with a thread identifier, the identified thread is stopped.

    The stopping of threads is accomplished by the Debug Agent using the associated OS service.

Using the HALT command on connections running RealMonitor

If RealMonitor support is enabled, then only the application thread stops. The RealMonitor thread continues running.

Examples

The following examples show how to use HALT:

halt

Stops the currently running thread or the thread attached to the Code window.

halt = thread_4

Stops the specified thread in RSD.

halt = 0x39d8

Stops the thread specified by the TCB address in RSD.

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111