drivers/gpu/drm/i915/gvt/mpt.h - linux - Git at Google

 /*
  * Copyright(c) 2011-2016 Intel Corporation. All rights reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
  * to deal in the Software without restriction, including without limitation
  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  * and/or sell copies of the Software, and to permit persons to whom the
  * Software is furnished to do so, subject to the following conditions:
  *
  * The above copyright notice and this permission notice (including the next
  * paragraph) shall be included in all copies or substantial portions of the
  * Software.
  *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
  * Authors:
  *    Eddie Dong <eddie.dong@intel.com>
  *    Dexuan Cui
  *    Jike Song <jike.song@intel.com>
  *
  * Contributors:
  *    Zhi Wang <zhi.a.wang@intel.com>
  *
  */

 #ifndef _GVT_MPT_H_
 #define _GVT_MPT_H_

 #include "gvt.h"

 /**
  * DOC: Hypervisor Service APIs for GVT-g Core Logic
  *
  * This is the glue layer between specific hypervisor MPT modules and GVT-g core
  * logic. Each kind of hypervisor MPT module provides a collection of function
  * callbacks and will be attached to GVT host when the driver is loading.
  * GVT-g core logic will call these APIs to request specific services from
  * hypervisor.
  */

 /**
  * intel_gvt_hypervisor_host_init - init GVT-g host side
  *
  * Returns:
  * Zero on success, negative error code if failed
  */
 static inline int intel_gvt_hypervisor_host_init(struct device *dev,
 						 void *gvt, const void *ops)
 {
 	if (!intel_gvt_host.mpt->host_init)
 		return -ENODEV;

 	return intel_gvt_host.mpt->host_init(dev, gvt, ops);
 }

 /**
  * intel_gvt_hypervisor_host_exit - exit GVT-g host side
  */
 static inline void intel_gvt_hypervisor_host_exit(struct device *dev)
 {
 	/* optional to provide */
 	if (!intel_gvt_host.mpt->host_exit)
 		return;

 	intel_gvt_host.mpt->host_exit(dev);
 }

 /**
  * intel_gvt_hypervisor_attach_vgpu - call hypervisor to initialize vGPU
  * related stuffs inside hypervisor.
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_attach_vgpu(struct intel_vgpu *vgpu)
 {
 	/* optional to provide */
 	if (!intel_gvt_host.mpt->attach_vgpu)
 		return 0;

 	return intel_gvt_host.mpt->attach_vgpu(vgpu, &vgpu->handle);
 }

 /**
  * intel_gvt_hypervisor_detach_vgpu - call hypervisor to release vGPU
  * related stuffs inside hypervisor.
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline void intel_gvt_hypervisor_detach_vgpu(struct intel_vgpu *vgpu)
 {
 	/* optional to provide */
 	if (!intel_gvt_host.mpt->detach_vgpu)
 		return;

 	intel_gvt_host.mpt->detach_vgpu(vgpu);
 }

 #define MSI_CAP_CONTROL(offset) (offset + 2)
 #define MSI_CAP_ADDRESS(offset) (offset + 4)
 #define MSI_CAP_DATA(offset) (offset + 8)
 #define MSI_CAP_EN 0x1

 /**
  * intel_gvt_hypervisor_inject_msi - inject a MSI interrupt into vGPU
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_inject_msi(struct intel_vgpu *vgpu)
 {
 	unsigned long offset = vgpu->gvt->device_info.msi_cap_offset;
 	u16 control, data;
 	u32 addr;
 	int ret;

 	control = *(u16 *)(vgpu_cfg_space(vgpu) + MSI_CAP_CONTROL(offset));
 	addr = *(u32 *)(vgpu_cfg_space(vgpu) + MSI_CAP_ADDRESS(offset));
 	data = *(u16 *)(vgpu_cfg_space(vgpu) + MSI_CAP_DATA(offset));

 	/* Do not generate MSI if MSIEN is disable */
 	if (!(control & MSI_CAP_EN))
 		return 0;

 	if (WARN(control & GENMASK(15, 1), "only support one MSI format\n"))
 		return -EINVAL;

 	trace_inject_msi(vgpu->id, addr, data);

 	ret = intel_gvt_host.mpt->inject_msi(vgpu->handle, addr, data);
 	if (ret)
 		return ret;
 	return 0;
 }

 /**
  * intel_gvt_hypervisor_set_wp_page - translate a host VA into MFN
  * @p: host kernel virtual address
  *
  * Returns:
  * MFN on success, INTEL_GVT_INVALID_ADDR if failed.
  */
 static inline unsigned long intel_gvt_hypervisor_virt_to_mfn(void *p)
 {
 	return intel_gvt_host.mpt->from_virt_to_mfn(p);
 }

 /**
  * intel_gvt_hypervisor_enable_page_track - track a guest page
  * @vgpu: a vGPU
  * @gfn: the gfn of guest
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_enable_page_track(
 		struct intel_vgpu *vgpu, unsigned long gfn)
 {
 	return intel_gvt_host.mpt->enable_page_track(vgpu->handle, gfn);
 }

 /**
  * intel_gvt_hypervisor_disable_page_track - untrack a guest page
  * @vgpu: a vGPU
  * @gfn: the gfn of guest
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_disable_page_track(
 		struct intel_vgpu *vgpu, unsigned long gfn)
 {
 	return intel_gvt_host.mpt->disable_page_track(vgpu->handle, gfn);
 }

 /**
  * intel_gvt_hypervisor_read_gpa - copy data from GPA to host data buffer
  * @vgpu: a vGPU
  * @gpa: guest physical address
  * @buf: host data buffer
  * @len: data length
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_read_gpa(struct intel_vgpu *vgpu,
 		unsigned long gpa, void *buf, unsigned long len)
 {
 	return intel_gvt_host.mpt->read_gpa(vgpu->handle, gpa, buf, len);
 }

 /**
  * intel_gvt_hypervisor_write_gpa - copy data from host data buffer to GPA
  * @vgpu: a vGPU
  * @gpa: guest physical address
  * @buf: host data buffer
  * @len: data length
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_write_gpa(struct intel_vgpu *vgpu,
 		unsigned long gpa, void *buf, unsigned long len)
 {
 	return intel_gvt_host.mpt->write_gpa(vgpu->handle, gpa, buf, len);
 }

 /**
  * intel_gvt_hypervisor_gfn_to_mfn - translate a GFN to MFN
  * @vgpu: a vGPU
  * @gpfn: guest pfn
  *
  * Returns:
  * MFN on success, INTEL_GVT_INVALID_ADDR if failed.
  */
 static inline unsigned long intel_gvt_hypervisor_gfn_to_mfn(
 		struct intel_vgpu *vgpu, unsigned long gfn)
 {
 	return intel_gvt_host.mpt->gfn_to_mfn(vgpu->handle, gfn);
 }

 /**
  * intel_gvt_hypervisor_dma_map_guest_page - setup dma map for guest page
  * @vgpu: a vGPU
  * @gfn: guest pfn
  * @size: page size
  * @dma_addr: retrieve allocated dma addr
  *
  * Returns:
  * 0 on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_dma_map_guest_page(
 		struct intel_vgpu *vgpu, unsigned long gfn, unsigned long size,
 		dma_addr_t *dma_addr)
 {
 	return intel_gvt_host.mpt->dma_map_guest_page(vgpu->handle, gfn, size,
 						      dma_addr);
 }

 /**
  * intel_gvt_hypervisor_dma_unmap_guest_page - cancel dma map for guest page
  * @vgpu: a vGPU
  * @dma_addr: the mapped dma addr
  */
 static inline void intel_gvt_hypervisor_dma_unmap_guest_page(
 		struct intel_vgpu *vgpu, dma_addr_t dma_addr)
 {
 	intel_gvt_host.mpt->dma_unmap_guest_page(vgpu->handle, dma_addr);
 }

 /**
  * intel_gvt_hypervisor_dma_pin_guest_page - pin guest dma buf
  * @vgpu: a vGPU
  * @dma_addr: guest dma addr
  *
  * Returns:
  * 0 on success, negative error code if failed.
  */
 static inline int
 intel_gvt_hypervisor_dma_pin_guest_page(struct intel_vgpu *vgpu,
 					dma_addr_t dma_addr)
 {
 	return intel_gvt_host.mpt->dma_pin_guest_page(vgpu->handle, dma_addr);
 }

 /**
  * intel_gvt_hypervisor_map_gfn_to_mfn - map a GFN region to MFN
  * @vgpu: a vGPU
  * @gfn: guest PFN
  * @mfn: host PFN
  * @nr: amount of PFNs
  * @map: map or unmap
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_map_gfn_to_mfn(
 		struct intel_vgpu *vgpu, unsigned long gfn,
 		unsigned long mfn, unsigned int nr,
 		bool map)
 {
 	/* a MPT implementation could have MMIO mapped elsewhere */
 	if (!intel_gvt_host.mpt->map_gfn_to_mfn)
 		return 0;

 	return intel_gvt_host.mpt->map_gfn_to_mfn(vgpu->handle, gfn, mfn, nr,
 						  map);
 }

 /**
  * intel_gvt_hypervisor_set_trap_area - Trap a guest PA region
  * @vgpu: a vGPU
  * @start: the beginning of the guest physical address region
  * @end: the end of the guest physical address region
  * @map: map or unmap
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_set_trap_area(
 		struct intel_vgpu *vgpu, u64 start, u64 end, bool map)
 {
 	/* a MPT implementation could have MMIO trapped elsewhere */
 	if (!intel_gvt_host.mpt->set_trap_area)
 		return 0;

 	return intel_gvt_host.mpt->set_trap_area(vgpu->handle, start, end, map);
 }

 /**
  * intel_gvt_hypervisor_set_opregion - Set opregion for guest
  * @vgpu: a vGPU
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_set_opregion(struct intel_vgpu *vgpu)
 {
 	if (!intel_gvt_host.mpt->set_opregion)
 		return 0;

 	return intel_gvt_host.mpt->set_opregion(vgpu);
 }

 /**
  * intel_gvt_hypervisor_set_edid - Set EDID region for guest
  * @vgpu: a vGPU
  * @port_num: display port number
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_set_edid(struct intel_vgpu *vgpu,
 						int port_num)
 {
 	if (!intel_gvt_host.mpt->set_edid)
 		return 0;

 	return intel_gvt_host.mpt->set_edid(vgpu, port_num);
 }

 /**
  * intel_gvt_hypervisor_get_vfio_device - increase vfio device ref count
  * @vgpu: a vGPU
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline int intel_gvt_hypervisor_get_vfio_device(struct intel_vgpu *vgpu)
 {
 	if (!intel_gvt_host.mpt->get_vfio_device)
 		return 0;

 	return intel_gvt_host.mpt->get_vfio_device(vgpu);
 }

 /**
  * intel_gvt_hypervisor_put_vfio_device - decrease vfio device ref count
  * @vgpu: a vGPU
  *
  * Returns:
  * Zero on success, negative error code if failed.
  */
 static inline void intel_gvt_hypervisor_put_vfio_device(struct intel_vgpu *vgpu)
 {
 	if (!intel_gvt_host.mpt->put_vfio_device)
 		return;

 	intel_gvt_host.mpt->put_vfio_device(vgpu);
 }

 /**
  * intel_gvt_hypervisor_is_valid_gfn - check if a visible gfn
  * @vgpu: a vGPU
  * @gfn: guest PFN
  *
  * Returns:
  * true on valid gfn, false on not.
  */
 static inline bool intel_gvt_hypervisor_is_valid_gfn(
 		struct intel_vgpu *vgpu, unsigned long gfn)
 {
 	if (!intel_gvt_host.mpt->is_valid_gfn)
 		return true;

 	return intel_gvt_host.mpt->is_valid_gfn(vgpu->handle, gfn);
 }

 int intel_gvt_register_hypervisor(const struct intel_gvt_mpt *);
 void intel_gvt_unregister_hypervisor(void);

 #endif /* _GVT_MPT_H_ */
	/*
	* Copyright(c) 2011-2016 Intel Corporation. All rights reserved.
	*
	* Permission is hereby granted, free of charge, to any person obtaining a
	* copy of this software and associated documentation files (the "Software"),
	* to deal in the Software without restriction, including without limitation
	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	* and/or sell copies of the Software, and to permit persons to whom the
	* Software is furnished to do so, subject to the following conditions:
	*
	* The above copyright notice and this permission notice (including the next
	* paragraph) shall be included in all copies or substantial portions of the
	* Software.
	*
	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
	* SOFTWARE.
	*
	* Authors:
	* Eddie Dong <eddie.dong@intel.com>
	* Dexuan Cui
	* Jike Song <jike.song@intel.com>
	*
	* Contributors:
	* Zhi Wang <zhi.a.wang@intel.com>
	*
	*/

	#ifndef _GVT_MPT_H_
	#define _GVT_MPT_H_

	#include "gvt.h"

	/**
	* DOC: Hypervisor Service APIs for GVT-g Core Logic
	*
	* This is the glue layer between specific hypervisor MPT modules and GVT-g core
	* logic. Each kind of hypervisor MPT module provides a collection of function
	* callbacks and will be attached to GVT host when the driver is loading.
	* GVT-g core logic will call these APIs to request specific services from
	* hypervisor.
	*/

	/**
	* intel_gvt_hypervisor_host_init - init GVT-g host side
	*
	* Returns:
	* Zero on success, negative error code if failed
	*/
	static inline int intel_gvt_hypervisor_host_init(struct device *dev,
	void gvt, const void ops)
	{
	if (!intel_gvt_host.mpt->host_init)
	return -ENODEV;

	return intel_gvt_host.mpt->host_init(dev, gvt, ops);
	}

	/**
	* intel_gvt_hypervisor_host_exit - exit GVT-g host side
	*/
	static inline void intel_gvt_hypervisor_host_exit(struct device *dev)
	{
	/* optional to provide */
	if (!intel_gvt_host.mpt->host_exit)
	return;

	intel_gvt_host.mpt->host_exit(dev);
	}

	/**
	* intel_gvt_hypervisor_attach_vgpu - call hypervisor to initialize vGPU
	* related stuffs inside hypervisor.
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_attach_vgpu(struct intel_vgpu *vgpu)
	{
	/* optional to provide */
	if (!intel_gvt_host.mpt->attach_vgpu)
	return 0;

	return intel_gvt_host.mpt->attach_vgpu(vgpu, &vgpu->handle);
	}

	/**
	* intel_gvt_hypervisor_detach_vgpu - call hypervisor to release vGPU
	* related stuffs inside hypervisor.
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline void intel_gvt_hypervisor_detach_vgpu(struct intel_vgpu *vgpu)
	{
	/* optional to provide */
	if (!intel_gvt_host.mpt->detach_vgpu)
	return;

	intel_gvt_host.mpt->detach_vgpu(vgpu);
	}

	#define MSI_CAP_CONTROL(offset) (offset + 2)
	#define MSI_CAP_ADDRESS(offset) (offset + 4)
	#define MSI_CAP_DATA(offset) (offset + 8)
	#define MSI_CAP_EN 0x1

	/**
	* intel_gvt_hypervisor_inject_msi - inject a MSI interrupt into vGPU
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_inject_msi(struct intel_vgpu *vgpu)
	{
	unsigned long offset = vgpu->gvt->device_info.msi_cap_offset;
	u16 control, data;
	u32 addr;
	int ret;

	control = (u16 )(vgpu_cfg_space(vgpu) + MSI_CAP_CONTROL(offset));
	addr = (u32 )(vgpu_cfg_space(vgpu) + MSI_CAP_ADDRESS(offset));
	data = (u16 )(vgpu_cfg_space(vgpu) + MSI_CAP_DATA(offset));

	/* Do not generate MSI if MSIEN is disable */
	if (!(control & MSI_CAP_EN))
	return 0;

	if (WARN(control & GENMASK(15, 1), "only support one MSI format\n"))
	return -EINVAL;

	trace_inject_msi(vgpu->id, addr, data);

	ret = intel_gvt_host.mpt->inject_msi(vgpu->handle, addr, data);
	if (ret)
	return ret;
	return 0;
	}

	/**
	* intel_gvt_hypervisor_set_wp_page - translate a host VA into MFN
	* @p: host kernel virtual address
	*
	* Returns:
	* MFN on success, INTEL_GVT_INVALID_ADDR if failed.
	*/
	static inline unsigned long intel_gvt_hypervisor_virt_to_mfn(void *p)
	{
	return intel_gvt_host.mpt->from_virt_to_mfn(p);
	}

	/**
	* intel_gvt_hypervisor_enable_page_track - track a guest page
	* @vgpu: a vGPU
	* @gfn: the gfn of guest
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_enable_page_track(
	struct intel_vgpu *vgpu, unsigned long gfn)
	{
	return intel_gvt_host.mpt->enable_page_track(vgpu->handle, gfn);
	}

	/**
	* intel_gvt_hypervisor_disable_page_track - untrack a guest page
	* @vgpu: a vGPU
	* @gfn: the gfn of guest
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_disable_page_track(
	struct intel_vgpu *vgpu, unsigned long gfn)
	{
	return intel_gvt_host.mpt->disable_page_track(vgpu->handle, gfn);
	}

	/**
	* intel_gvt_hypervisor_read_gpa - copy data from GPA to host data buffer
	* @vgpu: a vGPU
	* @gpa: guest physical address
	* @buf: host data buffer
	* @len: data length
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_read_gpa(struct intel_vgpu *vgpu,
	unsigned long gpa, void *buf, unsigned long len)
	{
	return intel_gvt_host.mpt->read_gpa(vgpu->handle, gpa, buf, len);
	}

	/**
	* intel_gvt_hypervisor_write_gpa - copy data from host data buffer to GPA
	* @vgpu: a vGPU
	* @gpa: guest physical address
	* @buf: host data buffer
	* @len: data length
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_write_gpa(struct intel_vgpu *vgpu,
	unsigned long gpa, void *buf, unsigned long len)
	{
	return intel_gvt_host.mpt->write_gpa(vgpu->handle, gpa, buf, len);
	}

	/**
	* intel_gvt_hypervisor_gfn_to_mfn - translate a GFN to MFN
	* @vgpu: a vGPU
	* @gpfn: guest pfn
	*
	* Returns:
	* MFN on success, INTEL_GVT_INVALID_ADDR if failed.
	*/
	static inline unsigned long intel_gvt_hypervisor_gfn_to_mfn(
	struct intel_vgpu *vgpu, unsigned long gfn)
	{
	return intel_gvt_host.mpt->gfn_to_mfn(vgpu->handle, gfn);
	}

	/**
	* intel_gvt_hypervisor_dma_map_guest_page - setup dma map for guest page
	* @vgpu: a vGPU
	* @gfn: guest pfn
	* @size: page size
	* @dma_addr: retrieve allocated dma addr
	*
	* Returns:
	* 0 on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_dma_map_guest_page(
	struct intel_vgpu *vgpu, unsigned long gfn, unsigned long size,
	dma_addr_t *dma_addr)
	{
	return intel_gvt_host.mpt->dma_map_guest_page(vgpu->handle, gfn, size,
	dma_addr);
	}

	/**
	* intel_gvt_hypervisor_dma_unmap_guest_page - cancel dma map for guest page
	* @vgpu: a vGPU
	* @dma_addr: the mapped dma addr
	*/
	static inline void intel_gvt_hypervisor_dma_unmap_guest_page(
	struct intel_vgpu *vgpu, dma_addr_t dma_addr)
	{
	intel_gvt_host.mpt->dma_unmap_guest_page(vgpu->handle, dma_addr);
	}

	/**
	* intel_gvt_hypervisor_dma_pin_guest_page - pin guest dma buf
	* @vgpu: a vGPU
	* @dma_addr: guest dma addr
	*
	* Returns:
	* 0 on success, negative error code if failed.
	*/
	static inline int
	intel_gvt_hypervisor_dma_pin_guest_page(struct intel_vgpu *vgpu,
	dma_addr_t dma_addr)
	{
	return intel_gvt_host.mpt->dma_pin_guest_page(vgpu->handle, dma_addr);
	}

	/**
	* intel_gvt_hypervisor_map_gfn_to_mfn - map a GFN region to MFN
	* @vgpu: a vGPU
	* @gfn: guest PFN
	* @mfn: host PFN
	* @nr: amount of PFNs
	* @map: map or unmap
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_map_gfn_to_mfn(
	struct intel_vgpu *vgpu, unsigned long gfn,
	unsigned long mfn, unsigned int nr,
	bool map)
	{
	/* a MPT implementation could have MMIO mapped elsewhere */
	if (!intel_gvt_host.mpt->map_gfn_to_mfn)
	return 0;

	return intel_gvt_host.mpt->map_gfn_to_mfn(vgpu->handle, gfn, mfn, nr,
	map);
	}

	/**
	* intel_gvt_hypervisor_set_trap_area - Trap a guest PA region
	* @vgpu: a vGPU
	* @start: the beginning of the guest physical address region
	* @end: the end of the guest physical address region
	* @map: map or unmap
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_set_trap_area(
	struct intel_vgpu *vgpu, u64 start, u64 end, bool map)
	{
	/* a MPT implementation could have MMIO trapped elsewhere */
	if (!intel_gvt_host.mpt->set_trap_area)
	return 0;

	return intel_gvt_host.mpt->set_trap_area(vgpu->handle, start, end, map);
	}

	/**
	* intel_gvt_hypervisor_set_opregion - Set opregion for guest
	* @vgpu: a vGPU
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_set_opregion(struct intel_vgpu *vgpu)
	{
	if (!intel_gvt_host.mpt->set_opregion)
	return 0;

	return intel_gvt_host.mpt->set_opregion(vgpu);
	}

	/**
	* intel_gvt_hypervisor_set_edid - Set EDID region for guest
	* @vgpu: a vGPU
	* @port_num: display port number
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_set_edid(struct intel_vgpu *vgpu,
	int port_num)
	{
	if (!intel_gvt_host.mpt->set_edid)
	return 0;

	return intel_gvt_host.mpt->set_edid(vgpu, port_num);
	}

	/**
	* intel_gvt_hypervisor_get_vfio_device - increase vfio device ref count
	* @vgpu: a vGPU
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline int intel_gvt_hypervisor_get_vfio_device(struct intel_vgpu *vgpu)
	{
	if (!intel_gvt_host.mpt->get_vfio_device)
	return 0;

	return intel_gvt_host.mpt->get_vfio_device(vgpu);
	}

	/**
	* intel_gvt_hypervisor_put_vfio_device - decrease vfio device ref count
	* @vgpu: a vGPU
	*
	* Returns:
	* Zero on success, negative error code if failed.
	*/
	static inline void intel_gvt_hypervisor_put_vfio_device(struct intel_vgpu *vgpu)
	{
	if (!intel_gvt_host.mpt->put_vfio_device)
	return;

	intel_gvt_host.mpt->put_vfio_device(vgpu);
	}

	/**
	* intel_gvt_hypervisor_is_valid_gfn - check if a visible gfn
	* @vgpu: a vGPU
	* @gfn: guest PFN
	*
	* Returns:
	* true on valid gfn, false on not.
	*/
	static inline bool intel_gvt_hypervisor_is_valid_gfn(
	struct intel_vgpu *vgpu, unsigned long gfn)
	{
	if (!intel_gvt_host.mpt->is_valid_gfn)
	return true;

	return intel_gvt_host.mpt->is_valid_gfn(vgpu->handle, gfn);
	}

	int intel_gvt_register_hypervisor(const struct intel_gvt_mpt *);
	void intel_gvt_unregister_hypervisor(void);

	#endif /* _GVT_MPT_H_ */