arm_subbuffer_diag_properties Struct Reference [ARM 4.1 Sub-buffers]

used to pass diagnostic detail properties to the ARM implementation More...

#include <arm41.h>

Data Fields
arm_subbuffer_t	header
arm_int32_t	tran_property_count
const arm_property_t *	tran_property_array

---

Detailed Description

used to pass diagnostic detail properties to the ARM implementation

Applications may provide additional properties of the form name=value when a transaction ends [arm_stop_transaction() or arm_report_transaction()] by passing properties in the Diagnostic Properties sub-buffer. The sub-buffer is ignored on all other calls. There are no implicit requirements on how or if these values are processed

Either the Diagnostic Properties or the Diagnostic Details sub-buffer may be provided, but not both.

There are constraints on the number of non-null properties and their size at any point in time.

Constraint Description	Constraint Value
Maximum number of non-null properties	20
Maximum number of characters of any property name, including the termination character	128
Maximum number of characters of any property name + property value, including the termination characters	2048
Maximum number of characters of all property names + property values, including the termination characters	4096

---

Field Documentation

arm_subbuffer_t arm_subbuffer_diag_properties::header

header.format must be set to ARM_SUBBUFFER_DIAG_PROPERTIES

const arm_property_t* arm_subbuffer_diag_properties::tran_property_array

An array of C structures containing the property names and values.

The array index of a property value in the value array is bound to the property name at the same index in the name array.

If a name is repeated in the array, the name and its corresponding value are ignored, and the first instance of the name and value in the array is used. The implementation may return an error code but is not obliged to do so.

arm_int32_t arm_subbuffer_diag_properties::tran_property_count

A 32-bit integer count of property values in the following array.

---

The documentation for this struct was generated from the following file:

• arm41.h