2.3.134. STOP

Stops target program execution, or a specified thread when the processor is running in RSD mode.

Syntax

STOP [[=]threadID]

where:

threadID

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

Description

The behavior of the STOP 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 STOP command on non OS-aware connections

The STOP command stops the processor.

Using the STOP command on OS-aware connections

The behavior of the STOP 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 whole processor.

  • If the processor is running in RSD mode, and you use the STOP command without specifying a thread, RealView Debugger attempts to stop the processor. The behavior depends on the OS System_Stop setting in the Advanced_Information block for the connection.

    If the System_Stop setting is set to Prompt, you are prompted to continue with the request:

    • Yes stops the processor, and the processor falls back to HSD mode.

    • No cancels the stop request, and the processor continues to run.

    If the System_Stop setting is set to Never, the STOP command is not actioned.

  • If the processor is running in RSD mode, and you use the STOP 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 STOP 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 STOP:

stop

Stops the processor.

stop = thread_4

Stops the specified thread in RSD.

stop = 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