hv_gic_create(_:)

Declaration

func hv_gic_create(_ gic_config: hv_gic_config_t) -> hv_return_t

Parameters

• gic_config:

  A GIC configuration object.

Return Value

HV_SUCCESS on success, an error code otherwise.

Discussion

Use this method to create an ARM Generic Interrupt Controller (GIC) v3 device. The framework supports a maximum of one instance of this device per VM. The device supports a distributor, redistributors, MSIs, and GIC CPU system registers.

When EL2 is enabled, the device supports GIC hypervisor control registers which the guest hypervisor uses to inject interrupts to its guest. The framework doesn’t support the Hypervisor’s vCPU get or set interrupt functions for injecting interrupts to a nested guest.

GIC v3 uses affinity based interrupt routing. vCPUs must set affinity values in their MPIDR_EL1 register. When the virtual machine vCPUs are running, the framework considers its topology final. Destroy vCPUs only when you’re tearing down the virtual machine.

Hypervisor only provides GIC MSI support when you’ve both configured an MSI region base address and set an MSI interrupt range.