220 lines
7.0 KiB
C
220 lines
7.0 KiB
C
/*-
|
|
* Copyright (c) 2011 NetApp, Inc.
|
|
* Copyright (c) 2017 Intel Corporation
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef VLAPIC_H
|
|
#define VLAPIC_H
|
|
|
|
#include <page.h>
|
|
#include <timer.h>
|
|
#include <apicreg.h>
|
|
|
|
/**
|
|
* @file vlapic.h
|
|
*
|
|
* @brief public APIs for virtual LAPIC
|
|
*/
|
|
|
|
|
|
#define VLAPIC_MAXLVT_INDEX APIC_LVT_CMCI
|
|
|
|
struct vlapic_pir_desc {
|
|
uint64_t pir[4];
|
|
uint64_t pending;
|
|
uint64_t unused[3];
|
|
} __aligned(64);
|
|
|
|
struct vlapic_timer {
|
|
struct hv_timer timer;
|
|
uint32_t mode;
|
|
uint32_t tmicr;
|
|
uint32_t divisor_shift;
|
|
};
|
|
|
|
struct acrn_vlapic {
|
|
/*
|
|
* Please keep 'apic_page' and 'pir_desc' be the first two fields in
|
|
* current structure, as below alignment restrictions are mandatory
|
|
* to support APICv features:
|
|
* - 'apic_page' MUST be 4KB aligned.
|
|
* - 'pir_desc' MUST be 64 bytes aligned.
|
|
* IRR, TMR and PIR could be accessed by other vCPUs when deliver
|
|
* an interrupt to vLAPIC.
|
|
*/
|
|
struct lapic_regs apic_page;
|
|
struct vlapic_pir_desc pir_desc;
|
|
|
|
struct acrn_vm *vm;
|
|
struct acrn_vcpu *vcpu;
|
|
|
|
uint32_t esr_pending;
|
|
int32_t esr_firing;
|
|
|
|
struct vlapic_timer vtimer;
|
|
|
|
/*
|
|
* isrv: vector number for the highest priority bit that is set in the ISR
|
|
*/
|
|
uint32_t isrv;
|
|
|
|
uint64_t msr_apicbase;
|
|
|
|
const struct acrn_apicv_ops *ops;
|
|
|
|
/*
|
|
* Copies of some registers in the virtual APIC page. We do this for
|
|
* a couple of different reasons:
|
|
* - to be able to detect what changed (e.g. svr_last)
|
|
* - to maintain a coherent snapshot of the register (e.g. lvt_last)
|
|
*/
|
|
uint32_t svr_last;
|
|
uint32_t lvt_last[VLAPIC_MAXLVT_INDEX + 1];
|
|
} __aligned(PAGE_SIZE);
|
|
|
|
struct acrn_apicv_ops {
|
|
void (*accept_intr)(struct acrn_vlapic *vlapic, uint32_t vector, bool level);
|
|
bool (*inject_intr)(struct acrn_vlapic *vlapic, bool guest_irq_enabled, bool injected);
|
|
bool (*has_pending_delivery_intr)(struct acrn_vcpu *vcpu);
|
|
bool (*has_pending_intr)(struct acrn_vcpu *vcpu);
|
|
bool (*apic_read_access_may_valid)(uint32_t offset);
|
|
bool (*apic_write_access_may_valid)(uint32_t offset);
|
|
bool (*x2apic_read_msr_may_valid)(uint32_t offset);
|
|
bool (*x2apic_write_msr_may_valid)(uint32_t offset);
|
|
};
|
|
|
|
enum reset_mode;
|
|
extern const struct acrn_apicv_ops *apicv_ops;
|
|
void vlapic_set_apicv_ops(void);
|
|
|
|
/**
|
|
* @brief virtual LAPIC
|
|
*
|
|
* @addtogroup acrn_vlapic ACRN vLAPIC
|
|
* @{
|
|
*/
|
|
|
|
bool vlapic_inject_intr(struct acrn_vlapic *vlapic, bool guest_irq_enabled, bool injected);
|
|
bool vlapic_has_pending_delivery_intr(struct acrn_vcpu *vcpu);
|
|
bool vlapic_has_pending_intr(struct acrn_vcpu *vcpu);
|
|
|
|
/**
|
|
* @brief Get physical address to PIR description.
|
|
*
|
|
* If APICv Posted-interrupt is supported, this address will be configured
|
|
* to VMCS "Posted-interrupt descriptor address" field.
|
|
*
|
|
* @param[in] vcpu Target vCPU
|
|
*
|
|
* @return physicall address to PIR
|
|
*
|
|
* @pre vcpu != NULL
|
|
*/
|
|
uint64_t apicv_get_pir_desc_paddr(struct acrn_vcpu *vcpu);
|
|
|
|
uint64_t vlapic_get_tsc_deadline_msr(const struct acrn_vlapic *vlapic);
|
|
void vlapic_set_tsc_deadline_msr(struct acrn_vlapic *vlapic, uint64_t val_arg);
|
|
uint64_t vlapic_get_apicbase(const struct acrn_vlapic *vlapic);
|
|
int32_t vlapic_set_apicbase(struct acrn_vlapic *vlapic, uint64_t new);
|
|
int32_t vlapic_x2apic_read(struct acrn_vcpu *vcpu, uint32_t msr, uint64_t *val);
|
|
int32_t vlapic_x2apic_write(struct acrn_vcpu *vcpu, uint32_t msr, uint64_t val);
|
|
|
|
/*
|
|
* Signals to the LAPIC that an interrupt at 'vector' needs to be generated
|
|
* to the 'cpu', the state is recorded in IRR.
|
|
* @pre vcpu != NULL
|
|
* @pre vector <= 255U
|
|
*/
|
|
void vlapic_set_intr(struct acrn_vcpu *vcpu, uint32_t vector, bool level);
|
|
|
|
#define LAPIC_TRIG_LEVEL true
|
|
#define LAPIC_TRIG_EDGE false
|
|
|
|
/**
|
|
* @brief Triggers LAPIC local interrupt(LVT).
|
|
*
|
|
* @param[in] vm Pointer to VM data structure
|
|
* @param[in] vcpu_id_arg ID of vCPU, BROADCAST_CPU_ID means triggering
|
|
* interrupt to all vCPUs.
|
|
* @param[in] lvt_index The index which LVT would to be fired.
|
|
*
|
|
* @retval 0 on success.
|
|
* @retval -EINVAL on error that vcpu_id_arg or vector of the LVT is invalid.
|
|
*
|
|
* @pre vm != NULL
|
|
*/
|
|
int32_t vlapic_set_local_intr(struct acrn_vm *vm, uint16_t vcpu_id_arg, uint32_t lvt_index);
|
|
|
|
/**
|
|
* @brief Inject MSI to target VM.
|
|
*
|
|
* @param[in] vm Pointer to VM data structure
|
|
* @param[in] addr MSI address.
|
|
* @param[in] msg MSI data.
|
|
*
|
|
* @retval 0 on success.
|
|
* @retval -1 on error that addr is invalid.
|
|
*
|
|
* @pre vm != NULL
|
|
*/
|
|
int32_t vlapic_intr_msi(struct acrn_vm *vm, uint64_t addr, uint64_t msg);
|
|
|
|
void vlapic_receive_intr(struct acrn_vm *vm, bool level, uint32_t dest,
|
|
bool phys, uint32_t delmode, uint32_t vec, bool rh);
|
|
|
|
uint32_t vlapic_get_apicid(const struct acrn_vlapic *vlapic);
|
|
void vlapic_create(struct acrn_vcpu *vcpu);
|
|
/*
|
|
* @pre vcpu != NULL
|
|
*/
|
|
void vlapic_free(struct acrn_vcpu *vcpu);
|
|
/**
|
|
* @pre vlapic->vm != NULL
|
|
* @pre vlapic->vcpu->vcpu_id < MAX_VCPUS_PER_VM
|
|
*/
|
|
void vlapic_init(struct acrn_vlapic *vlapic);
|
|
void vlapic_reset(struct acrn_vlapic *vlapic, const struct acrn_apicv_ops *ops, enum reset_mode mode);
|
|
void vlapic_restore(struct acrn_vlapic *vlapic, const struct lapic_regs *regs);
|
|
uint64_t vlapic_apicv_get_apic_access_addr(void);
|
|
uint64_t vlapic_apicv_get_apic_page_addr(struct acrn_vlapic *vlapic);
|
|
int32_t apic_access_vmexit_handler(struct acrn_vcpu *vcpu);
|
|
int32_t apic_write_vmexit_handler(struct acrn_vcpu *vcpu);
|
|
int32_t veoi_vmexit_handler(struct acrn_vcpu *vcpu);
|
|
void vlapic_update_tpr_threshold(const struct acrn_vlapic *vlapic);
|
|
int32_t tpr_below_threshold_vmexit_handler(struct acrn_vcpu *vcpu);
|
|
void vlapic_calc_dest(struct acrn_vm *vm, uint64_t *dmask, bool is_broadcast,
|
|
uint32_t dest, bool phys, bool lowprio);
|
|
void vlapic_calc_dest_lapic_pt(struct acrn_vm *vm, uint64_t *dmask, bool is_broadcast,
|
|
uint32_t dest, bool phys);
|
|
bool is_x2apic_enabled(const struct acrn_vlapic *vlapic);
|
|
bool is_xapic_enabled(const struct acrn_vlapic *vlapic);
|
|
/**
|
|
* @}
|
|
*/
|
|
/* End of acrn_vlapic */
|
|
#endif /* VLAPIC_H */
|