vCPU Management

Overview

Hypervisor creates Virtual CPUs with hv_vcpu_create(_:_:_:). Call functions that operate on the vCPU from the same thread with the exception of hv_vcpus_exit(_:_:).

Enter the vCPU by using hv_vcpu_run(_:). The function runs until the guest traps or an other thread calls hv_vcpus_exit(_:_:). On exit, hv_vcpu_run(_:) populates the hv_vcpu_exit_t with the exit reason.

Topics

Configuration

• hv_vcpu_config_create()
• hv_vcpu_config_get_feature_reg(_:_:_:)
• hv_vcpu_config_get_ccsidr_el1_sys_reg_values(_:_:_:)
• hv_vcpu_config_t
• OS_hv_vcpu_config
• hv_feature_reg_t

Creation and destruction

• hv_vm_get_max_vcpu_count(_:)
• hv_vcpu_create(_:_:_:)
• hv_vcpu_destroy(_:)
• hv_vcpu_t

Runtime

• hv_vcpu_run(_:)
• hv_vcpus_exit(_:_:)
• hv_vcpu_get_pending_interrupt(_:_:_:)
• hv_vcpu_set_pending_interrupt(_:_:_:)
• hv_vcpu_get_exec_time(_:_:)
• hv_interrupt_type_t
• Exits

General registers

• hv_vcpu_get_reg(_:_:_:)
• hv_vcpu_set_reg(_:_:_:)
• hv_reg_t

SIMD & Floating-point registers

• hv_vcpu_get_simd_fp_reg(_:_:_:)
• hv_vcpu_set_simd_fp_reg(_:_:_:)
• hv_simd_fp_uchar16_t
• hv_simd_fp_reg_t

System registers

• hv_vcpu_get_sys_reg(_:_:_:)
• hv_vcpu_set_sys_reg(_:_:_:)
• hv_sys_reg_t

Trap configuration

• hv_vcpu_get_trap_debug_exceptions(_:_:)
• hv_vcpu_set_trap_debug_exceptions(_:_:)
• hv_vcpu_get_trap_debug_reg_accesses(_:_:)
• hv_vcpu_set_trap_debug_reg_accesses(_:_:)

See Also

Resource management

• Memory management