5.14.1 Per-instance execution control functions

Describes the following functions:

perInstanceExecution_getState()

Gets the current per-instance execution state of a specific instance.

Arguments

instId

Type: NumberU64

Opaque number uniquely identifying the target instance.

Return value

Object

Object containing one member, "enable" (Boolean), which is True iff execution is enabled in this instance.

Errors

  • E_unknown_instance_id.

perInstanceExecution_getStateAll()

Gets the execution state of all instances in the system that support per-instance execution control. This is a convenience function, calling perInstanceExecution_getState() on all instances in the system that support it.

Return value

Object

Object containing two members: enabledSet and disabledSet. Each member is an array of NumberU64 containing the set of instance ids for which execution is enabled or disabled, respectively.

perInstanceExecution_setState()

Gets the current per-instance execution state of a specific instance.

Arguments

enable

Type: Boolean

Iff True, enable execution of instructions or processing of work items.

instId

Type: NumberU64

Opaque number uniquely identifying the target instance.

Return value

Function has no return value.

Errors

  • E_unknown_instance_id.

perInstanceExecution_setStateAll()

Updates the execution state of all instances in the system that support per-instance execution control. This is a convenience function, calling perInstanceExecution_setState() on all instances in the system that support it.

Arguments

enable

Type: Boolean

Iff True, enable execution of instructions or processing of work items for instances in instanceSet and disable execution for all other instances. Iff False, disable execution for instances in instanceSet and enable execution for all other instances.

instanceSet

Type: NumberU64[]

List of instance ids for which execution must be enabled or disabled, depending on enable. All instances that are not in this list are set to the opposite state. Can be empty.

Return value

Function has no return value.

Errors

  • E_unknown_instance_id.
Non-ConfidentialPDF file icon PDF version101196_0100_03_en
Copyright © 2018, 2019 Arm Limited or its affiliates. All rights reserved.