mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-05-03 14:06:54 +00:00
2b2dbe43d7
move the following files to guest folder:
renamed: arch/x86/assign.c -> arch/x86/guest/assign.c
renamed: arch/x86/ept.c -> arch/x86/guest/ept.c
renamed: arch/x86/io_emul.c -> arch/x86/guest/io_emul.c
renamed: arch/x86/trusty.c -> arch/x86/guest/trusty.c
renamed: arch/x86/virq.c -> arch/x86/guest/virq.c
renamed: arch/x86/virtual_cr.c -> arch/x86/guest/virtual_cr.c
renamed: arch/x86/vmcs.c -> arch/x86/guest/vmcs.c
renamed: arch/x86/vmexit.c -> arch/x86/guest/vmexit.c
renamed: arch/x86/vmx_asm.S -> arch/x86/guest/vmx_asm.S
renamed: include/arch/x86/assign.h ->
include/arch/x86/guest/assign.h
renamed: include/arch/x86/io_emul.h ->
include/arch/x86/guest/io_emul.h
renamed: include/arch/x86/trusty.h ->
include/arch/x86/guest/trusty.h
renamed: include/arch/x86/virtual_cr.h ->
include/arch/x86/guest/virtual_cr.h
renamed: include/arch/x86/vmcs.h -> include/arch/x86/guest/vmcs.h
renamed: include/arch/x86/vmexit.h ->
include/arch/x86/guest/vmexit.h
After these files movement, all the files in arch/x86 are native
hardware related, and all the files in arch/x86/guest are
virtualiztion related.
Tracked-On: #1842
Signed-off-by: Mingqiang Chi <mingqiang.chi@intel.com>
Reviewed-by: Jason Chen CJ <jason.cj.chen@intel.com>
Reviewed-by: Eddie Dong <eddie.dong@intel.com>
166 lines
4.7 KiB
C
166 lines
4.7 KiB
C
/*
|
|
* Copyright (C) 2018 Intel Corporation. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef ASSIGN_H
|
|
#define ASSIGN_H
|
|
|
|
#include <ptdev.h>
|
|
|
|
/**
|
|
* @file assign.h
|
|
*
|
|
* @brief public APIs for Passthrough Interrupt Remapping
|
|
*/
|
|
|
|
/**
|
|
* @brief VT-d
|
|
*
|
|
* @defgroup acrn_passthrough ACRN Passthrough
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Acknowledge a virtual interrupt for passthrough device.
|
|
*
|
|
* Acknowledge a virtual legacy interrupt for a passthrough device.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_pin virtual pin number associated with the passthrough device
|
|
* @param[in] vpin_src ioapic or pic
|
|
*
|
|
* @return None
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
void ptirq_intx_ack(struct acrn_vm *vm, uint32_t virt_pin, uint32_t vpin_src);
|
|
|
|
/**
|
|
* @brief MSI/MSI-x remapping for passthrough device.
|
|
*
|
|
* Main entry for PCI device assignment with MSI and MSI-X.
|
|
* MSI can up to 8 vectors and MSI-X can up to 1024 Vectors.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_bdf virtual bdf associated with the passthrough device
|
|
* @param[in] entry_nr indicate coming vectors, entry_nr = 0 means first vector
|
|
* @param[in] info structure used for MSI/MSI-x remapping
|
|
*
|
|
* @return
|
|
* - 0: on success
|
|
* - \p -ENODEV:
|
|
* - for SOS, the entry already be held by others
|
|
* - for UOS, no pre-hold mapping found.
|
|
*
|
|
* @pre vm != NULL
|
|
* @pre info != NULL
|
|
*
|
|
*/
|
|
int32_t ptirq_msix_remap(struct acrn_vm *vm, uint16_t virt_bdf, uint16_t entry_nr, struct ptirq_msi_info *info);
|
|
|
|
|
|
/**
|
|
* @brief INTx remapping for passthrough device.
|
|
*
|
|
* Set up the remapping of the given virtual pin for the given vm.
|
|
* This is the main entry for PCI/Legacy device assignment with INTx, calling from vIOAPIC or vPIC.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_pin virtual pin number associated with the passthrough device
|
|
* @param[in] vpin_src ioapic or pic
|
|
*
|
|
* @return
|
|
* - 0: on success
|
|
* - \p -ENODEV:
|
|
* - for SOS, the entry already be held by others
|
|
* - for UOS, no pre-hold mapping found.
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
int32_t ptirq_intx_pin_remap(struct acrn_vm *vm, uint32_t virt_pin, uint32_t vpin_src);
|
|
|
|
/**
|
|
* @brief Add an interrupt remapping entry for INTx as pre-hold mapping.
|
|
*
|
|
* Except sos_vm, Device Model should call this function to pre-hold ptdev intx
|
|
* The entry is identified by phys_pin, one entry vs. one phys_pin.
|
|
* Currently, one phys_pin can only be held by one pin source (vPIC or vIOAPIC).
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_pin virtual pin number associated with the passthrough device
|
|
* @param[in] phys_pin physical pin number associated with the passthrough device
|
|
* @param[in] pic_pin true for pic, false for ioapic
|
|
*
|
|
* @return
|
|
* - 0: on success
|
|
* - \p -EINVAL: invalid virt_pin value
|
|
* - \p -ENODEV: failed to add the remapping entry
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
int32_t ptirq_add_intx_remapping(struct acrn_vm *vm, uint32_t virt_pin, uint32_t phys_pin, bool pic_pin);
|
|
|
|
/**
|
|
* @brief Remove an interrupt remapping entry for INTx.
|
|
*
|
|
* Deactivate & remove mapping entry of the given virt_pin for given vm.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_pin virtual pin number associated with the passthrough device
|
|
* @param[in] pic_pin true for pic, false for ioapic
|
|
*
|
|
* @return None
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
void ptirq_remove_intx_remapping(struct acrn_vm *vm, uint32_t virt_pin, bool pic_pin);
|
|
|
|
/**
|
|
* @brief Add interrupt remapping entry/entries for MSI/MSI-x as pre-hold mapping.
|
|
*
|
|
* Add pre-hold mapping of the given number of vectors between the given physical and virtual BDF for the given vm.
|
|
* Except sos_vm, Device Model should call this function to pre-hold ptdev MSI/MSI-x.
|
|
* The entry is identified by phys_bdf:msi_idx, one entry vs. one phys_bdf:msi_idx.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_bdf virtual bdf associated with the passthrough device
|
|
* @param[in] phys_bdf physical bdf associated with the passthrough device
|
|
* @param[in] vector_count number of vectors
|
|
*
|
|
* @return
|
|
* - 0: on success
|
|
* - \p -ENODEV: failed to add the remapping entry
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
int32_t ptirq_add_msix_remapping(struct acrn_vm *vm, uint16_t virt_bdf, uint16_t phys_bdf, uint32_t vector_count);
|
|
|
|
/**
|
|
* @brief Remove interrupt remapping entry/entries for MSI/MSI-x.
|
|
*
|
|
* Remove the mapping of given number of vectors of the given virtual BDF for the given vm.
|
|
*
|
|
* @param[in] vm pointer to acrn_vm
|
|
* @param[in] virt_bdf virtual bdf associated with the passthrough device
|
|
* @param[in] vector_count number of vectors
|
|
*
|
|
* @return None
|
|
*
|
|
* @pre vm != NULL
|
|
*
|
|
*/
|
|
void ptirq_remove_msix_remapping(const struct acrn_vm *vm, uint16_t virt_bdf, uint32_t vector_count);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* ASSIGN_H */
|