RealView® Debugger Command Line Reference Guide 2.3.128. STOP

2.3.128. STOP

The STOP command stops target program execution, or a specified thread when the processor is running in RSD mode.

Syntax

STOP [=value]

where:

value: Identifies the thread.

Description

The behavior of the STOP command depends on the whether your program is running on a non RTOS-aware or RTOS-aware connection.

Using the STOP command on non RTOS-aware connections

The STOP command stops the whole processor.

Using the STOP command on RTOS-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, the behavior depends on the RTOS System_Stop setting in the Advanced_Information block for the connection (see the chapter that describes RTOS support in the RealView Debugger v1.8 Extensions User Guide). If it 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 processor is running in RSD mode, then when you are working on a multithreaded image in an unattached Code window, the STOP command acts on the current thread. If you are using an attached window, the STOP instruction stops the thread that the window is attached to.
The stopping of threads is accomplished by the Debug Agent using the associated OS service.

If you are working with RTOS images, see the chapters that describe RTOS support and working with multiple target connections in the RealView Debugger v1.8 Extensions User Guide.

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.

Copyright © 2002-2005 ARM Limited. All rights reserved.	ARM DUI 0175G
Non-Confidential
PDF version