Commit b704fd14 authored by Kirti Wankhede's avatar Kirti Wankhede Committed by Alex Williamson
Browse files

vfio iommu: Add ioctl definition for dirty pages tracking 



IOMMU container maintains a list of all pages pinned by vfio_pin_pages API.
All pages pinned by vendor driver through this API should be considered as
dirty during migration. When container consists of IOMMU capable device and
all pages are pinned and mapped, then all pages are marked dirty.
Added support to start/stop dirtied pages tracking and to get bitmap of all
dirtied pages for requested IO virtual address range.

Signed-off-by: default avatarKirti Wankhede <kwankhede@nvidia.com>
Reviewed-by: default avatarNeo Jia <cjia@nvidia.com>
Reviewed-by: default avatarCornelia Huck <cohuck@redhat.com>
Reviewed-by: default avatarYan Zhao <yan.y.zhao@intel.com>
Signed-off-by: default avatarAlex Williamson <alex.williamson@redhat.com>
parent cade075f

include/uapi/linux/vfio.h

+57 −0
Original line number Diff line number Diff line
@@ -1033,6 +1033,12 @@ struct vfio_iommu_type1_dma_map { 


#define VFIO_IOMMU_MAP_DMA _IO(VFIO_TYPE, VFIO_BASE + 13)



struct vfio_bitmap {

	__u64        pgsize;	/* page size for bitmap in bytes */

	__u64        size;	/* in bytes */

	__u64 __user *data;	/* one bit per page */

};



/**

 * VFIO_IOMMU_UNMAP_DMA - _IOWR(VFIO_TYPE, VFIO_BASE + 14,

 *							struct vfio_dma_unmap)
@@ -1059,6 +1065,57 @@ struct vfio_iommu_type1_dma_unmap { 
#define VFIO_IOMMU_ENABLE	_IO(VFIO_TYPE, VFIO_BASE + 15)

#define VFIO_IOMMU_DISABLE	_IO(VFIO_TYPE, VFIO_BASE + 16)



/**

 * VFIO_IOMMU_DIRTY_PAGES - _IOWR(VFIO_TYPE, VFIO_BASE + 17,

 *                                     struct vfio_iommu_type1_dirty_bitmap)

 * IOCTL is used for dirty pages logging.

 * Caller should set flag depending on which operation to perform, details as

 * below:

 *

 * Calling the IOCTL with VFIO_IOMMU_DIRTY_PAGES_FLAG_START flag set, instructs

 * the IOMMU driver to log pages that are dirtied or potentially dirtied by

 * the device; designed to be used when a migration is in progress. Dirty pages

 * are logged until logging is disabled by user application by calling the IOCTL

 * with VFIO_IOMMU_DIRTY_PAGES_FLAG_STOP flag.

 *

 * Calling the IOCTL with VFIO_IOMMU_DIRTY_PAGES_FLAG_STOP flag set, instructs

 * the IOMMU driver to stop logging dirtied pages.

 *

 * Calling the IOCTL with VFIO_IOMMU_DIRTY_PAGES_FLAG_GET_BITMAP flag set

 * returns the dirty pages bitmap for IOMMU container for a given IOVA range.

 * The user must specify the IOVA range and the pgsize through the structure

 * vfio_iommu_type1_dirty_bitmap_get in the data[] portion. This interface

 * supports getting a bitmap of the smallest supported pgsize only and can be

 * modified in future to get a bitmap of any specified supported pgsize. The

 * user must provide a zeroed memory area for the bitmap memory and specify its

 * size in bitmap.size. One bit is used to represent one page consecutively

 * starting from iova offset. The user should provide page size in bitmap.pgsize

 * field. A bit set in the bitmap indicates that the page at that offset from

 * iova is dirty. The caller must set argsz to a value including the size of

 * structure vfio_iommu_type1_dirty_bitmap_get, but excluding the size of the

 * actual bitmap. If dirty pages logging is not enabled, an error will be

 * returned.

 *

 * Only one of the flags _START, _STOP and _GET may be specified at a time.

 *

 */

struct vfio_iommu_type1_dirty_bitmap {

	__u32        argsz;

	__u32        flags;

#define VFIO_IOMMU_DIRTY_PAGES_FLAG_START	(1 << 0)

#define VFIO_IOMMU_DIRTY_PAGES_FLAG_STOP	(1 << 1)

#define VFIO_IOMMU_DIRTY_PAGES_FLAG_GET_BITMAP	(1 << 2)

	__u8         data[];

};



struct vfio_iommu_type1_dirty_bitmap_get {

	__u64              iova;	/* IO virtual address */

	__u64              size;	/* Size of iova range */

	struct vfio_bitmap bitmap;

};



#define VFIO_IOMMU_DIRTY_PAGES             _IO(VFIO_TYPE, VFIO_BASE + 17)



/* -------- Additional API for SPAPR TCE (Server POWERPC) IOMMU -------- */



/*

CRA Git | Maintained and supported by SUSTech CRA and CCSE