4.4.9. read

This function enables a debugger to read a coprocessor register via RDI. The function reads the coprocessor register numbered reg and transfers its value to the location addressed by value.

If the requested coprocessor register does not exist, or the register cannot be read, the function must return ARMul_CP_CANT.

Syntax


unsigned read(void *handleint reg, ARMword instr, ARMword *value)

where:

handle

is the handle from ARMulif_InstallCoprocessorV5.

reg

is the register number of the coprocessor registerto be read.

instr

is not used.

value

is a pointer to the location of the data to be read from the coprocessor.

Return

The function must return one of:

  • ARMul_CP_DONE, to indicate that the coprocessor operation is complete

  • ARMul_CP_CANT, to indicate that the register is not supported.

Usage

This function is called by the debugger via RDI.

Copyright © 1999-2001 ARM Limited. All rights reserved.ARM DUI0058D
Non-Confidential