Merge tag 'mlx5-vfio-v10' of https://git.kernel.org/pub/scm/linux/kernel/git/mellanox...
authorAlex Williamson <alex.williamson@redhat.com>
Thu, 3 Mar 2022 16:51:03 +0000 (09:51 -0700)
committerAlex Williamson <alex.williamson@redhat.com>
Thu, 3 Mar 2022 16:51:03 +0000 (09:51 -0700)
Add mlx5 live migration driver and v2 migration protocol

This series adds mlx5 live migration driver for VFs that are migration
capable and includes the v2 migration protocol definition and mlx5
implementation.

The mlx5 driver uses the vfio_pci_core split to create a specific VFIO
PCI driver that matches the mlx5 virtual functions. The driver provides
the same experience as normal vfio-pci with the addition of migration
support.

In HW the migration is controlled by the PF function, using its
mlx5_core driver, and the VFIO PCI VF driver co-ordinates with the PF to
execute the migration actions.

The bulk of the v2 migration protocol is semantically the same v1,
however it has been recast into a FSM for the device_state and the
actual syscall interface uses normal ioctl(), read() and write() instead
of building a syscall interface using the region.

Several bits of infrastructure work are included here:
 - pci_iov_vf_id() to help drivers like mlx5 figure out the VF index from
   a BDF
 - pci_iov_get_pf_drvdata() to clarify the tricky locking protocol when a
   VF reaches into its PF's driver
 - mlx5_core uses the normal SRIOV lifecycle and disables SRIOV before
   driver remove, to be compatible with pci_iov_get_pf_drvdata()
 - Lifting VFIO_DEVICE_FEATURE into core VFIO code

This series comes after alot of discussion. Some major points:
- v1 ABI compatible migration defined using the same FSM approach:
   https://lore.kernel.org/all/0-v1-a4f7cab64938+3f-vfio_mig_states_jgg@nvidia.com/
- Attempts to clarify how the v1 API works:
   Alex's:
     https://lore.kernel.org/kvm/163909282574.728533.7460416142511440919.stgit@omen/
   Jason's:
     https://lore.kernel.org/all/0-v3-184b374ad0a8+24c-vfio_mig_doc_jgg@nvidia.com/
- Etherpad exploring the scope and questions of general VFIO migration:
     https://lore.kernel.org/kvm/87mtm2loml.fsf@redhat.com/

NOTE: As this series touched mlx5_core parts we need to send this in a
pull request format to VFIO to avoid conflicts.

Matching qemu changes can be previewed here:
 https://github.com/jgunthorpe/qemu/commits/vfio_migration_v2

Link: https://lore.kernel.org/all/20220224142024.147653-1-yishaih@nvidia.com
Signed-of-by: Leon Romanovsky <leonro@nvidia.com>
22 files changed:
MAINTAINERS
drivers/net/ethernet/mellanox/mlx5/core/cmd.c
drivers/net/ethernet/mellanox/mlx5/core/main.c
drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.h
drivers/net/ethernet/mellanox/mlx5/core/sriov.c
drivers/pci/iov.c
drivers/vfio/pci/Kconfig
drivers/vfio/pci/Makefile
drivers/vfio/pci/mlx5/Kconfig [new file with mode: 0644]
drivers/vfio/pci/mlx5/Makefile [new file with mode: 0644]
drivers/vfio/pci/mlx5/cmd.c [new file with mode: 0644]
drivers/vfio/pci/mlx5/cmd.h [new file with mode: 0644]
drivers/vfio/pci/mlx5/main.c [new file with mode: 0644]
drivers/vfio/pci/vfio_pci.c
drivers/vfio/pci/vfio_pci_core.c
drivers/vfio/vfio.c
include/linux/mlx5/driver.h
include/linux/mlx5/mlx5_ifc.h
include/linux/pci.h
include/linux/vfio.h
include/linux/vfio_pci_core.h
include/uapi/linux/vfio.h

index 777cd6f..4322b53 100644 (file)
@@ -20320,6 +20320,12 @@ L:     kvm@vger.kernel.org
 S:     Maintained
 F:     drivers/vfio/platform/
 
+VFIO MLX5 PCI DRIVER
+M:     Yishai Hadas <yishaih@nvidia.com>
+L:     kvm@vger.kernel.org
+S:     Maintained
+F:     drivers/vfio/pci/mlx5/
+
 VGA_SWITCHEROO
 R:     Lukas Wunner <lukas@wunner.de>
 S:     Maintained
index 17fe058..4f45ee0 100644 (file)
@@ -477,6 +477,11 @@ static int mlx5_internal_err_ret_value(struct mlx5_core_dev *dev, u16 op,
        case MLX5_CMD_OP_QUERY_VHCA_STATE:
        case MLX5_CMD_OP_MODIFY_VHCA_STATE:
        case MLX5_CMD_OP_ALLOC_SF:
+       case MLX5_CMD_OP_SUSPEND_VHCA:
+       case MLX5_CMD_OP_RESUME_VHCA:
+       case MLX5_CMD_OP_QUERY_VHCA_MIGRATION_STATE:
+       case MLX5_CMD_OP_SAVE_VHCA_STATE:
+       case MLX5_CMD_OP_LOAD_VHCA_STATE:
                *status = MLX5_DRIVER_STATUS_ABORTED;
                *synd = MLX5_DRIVER_SYND;
                return -EIO;
@@ -674,6 +679,11 @@ const char *mlx5_command_str(int command)
        MLX5_COMMAND_STR_CASE(MODIFY_VHCA_STATE);
        MLX5_COMMAND_STR_CASE(ALLOC_SF);
        MLX5_COMMAND_STR_CASE(DEALLOC_SF);
+       MLX5_COMMAND_STR_CASE(SUSPEND_VHCA);
+       MLX5_COMMAND_STR_CASE(RESUME_VHCA);
+       MLX5_COMMAND_STR_CASE(QUERY_VHCA_MIGRATION_STATE);
+       MLX5_COMMAND_STR_CASE(SAVE_VHCA_STATE);
+       MLX5_COMMAND_STR_CASE(LOAD_VHCA_STATE);
        default: return "unknown command opcode";
        }
 }
index 2c774f3..e9aeba4 100644 (file)
@@ -1620,6 +1620,7 @@ static void remove_one(struct pci_dev *pdev)
        struct devlink *devlink = priv_to_devlink(dev);
 
        devlink_unregister(devlink);
+       mlx5_sriov_disable(pdev);
        mlx5_crdump_disable(dev);
        mlx5_drain_health_wq(dev);
        mlx5_uninit_one(dev);
@@ -1880,6 +1881,50 @@ static struct pci_driver mlx5_core_driver = {
        .sriov_set_msix_vec_count = mlx5_core_sriov_set_msix_vec_count,
 };
 
+/**
+ * mlx5_vf_get_core_dev - Get the mlx5 core device from a given VF PCI device if
+ *                     mlx5_core is its driver.
+ * @pdev: The associated PCI device.
+ *
+ * Upon return the interface state lock stay held to let caller uses it safely.
+ * Caller must ensure to use the returned mlx5 device for a narrow window
+ * and put it back with mlx5_vf_put_core_dev() immediately once usage was over.
+ *
+ * Return: Pointer to the associated mlx5_core_dev or NULL.
+ */
+struct mlx5_core_dev *mlx5_vf_get_core_dev(struct pci_dev *pdev)
+                       __acquires(&mdev->intf_state_mutex)
+{
+       struct mlx5_core_dev *mdev;
+
+       mdev = pci_iov_get_pf_drvdata(pdev, &mlx5_core_driver);
+       if (IS_ERR(mdev))
+               return NULL;
+
+       mutex_lock(&mdev->intf_state_mutex);
+       if (!test_bit(MLX5_INTERFACE_STATE_UP, &mdev->intf_state)) {
+               mutex_unlock(&mdev->intf_state_mutex);
+               return NULL;
+       }
+
+       return mdev;
+}
+EXPORT_SYMBOL(mlx5_vf_get_core_dev);
+
+/**
+ * mlx5_vf_put_core_dev - Put the mlx5 core device back.
+ * @mdev: The mlx5 core device.
+ *
+ * Upon return the interface state lock is unlocked and caller should not
+ * access the mdev any more.
+ */
+void mlx5_vf_put_core_dev(struct mlx5_core_dev *mdev)
+                       __releases(&mdev->intf_state_mutex)
+{
+       mutex_unlock(&mdev->intf_state_mutex);
+}
+EXPORT_SYMBOL(mlx5_vf_put_core_dev);
+
 static void mlx5_core_verify_params(void)
 {
        if (prof_sel >= ARRAY_SIZE(profile)) {
index 6f8baa0..37b2805 100644 (file)
@@ -164,6 +164,7 @@ void mlx5_sriov_cleanup(struct mlx5_core_dev *dev);
 int mlx5_sriov_attach(struct mlx5_core_dev *dev);
 void mlx5_sriov_detach(struct mlx5_core_dev *dev);
 int mlx5_core_sriov_configure(struct pci_dev *dev, int num_vfs);
+void mlx5_sriov_disable(struct pci_dev *pdev);
 int mlx5_core_sriov_set_msix_vec_count(struct pci_dev *vf, int msix_vec_count);
 int mlx5_core_enable_hca(struct mlx5_core_dev *dev, u16 func_id);
 int mlx5_core_disable_hca(struct mlx5_core_dev *dev, u16 func_id);
index e8185b6..887ee0f 100644 (file)
@@ -161,7 +161,7 @@ static int mlx5_sriov_enable(struct pci_dev *pdev, int num_vfs)
        return err;
 }
 
-static void mlx5_sriov_disable(struct pci_dev *pdev)
+void mlx5_sriov_disable(struct pci_dev *pdev)
 {
        struct mlx5_core_dev *dev  = pci_get_drvdata(pdev);
        int num_vfs = pci_num_vf(dev->pdev);
@@ -205,19 +205,8 @@ int mlx5_core_sriov_set_msix_vec_count(struct pci_dev *vf, int msix_vec_count)
                        mlx5_get_default_msix_vec_count(dev, pci_num_vf(pf));
 
        sriov = &dev->priv.sriov;
-
-       /* Reversed translation of PCI VF function number to the internal
-        * function_id, which exists in the name of virtfn symlink.
-        */
-       for (id = 0; id < pci_num_vf(pf); id++) {
-               if (!sriov->vfs_ctx[id].enabled)
-                       continue;
-
-               if (vf->devfn == pci_iov_virtfn_devfn(pf, id))
-                       break;
-       }
-
-       if (id == pci_num_vf(pf) || !sriov->vfs_ctx[id].enabled)
+       id = pci_iov_vf_id(vf);
+       if (id < 0 || !sriov->vfs_ctx[id].enabled)
                return -EINVAL;
 
        return mlx5_set_msix_vec_count(dev, id + 1, msix_vec_count);
index 0267977..28ec952 100644 (file)
@@ -33,6 +33,49 @@ int pci_iov_virtfn_devfn(struct pci_dev *dev, int vf_id)
 }
 EXPORT_SYMBOL_GPL(pci_iov_virtfn_devfn);
 
+int pci_iov_vf_id(struct pci_dev *dev)
+{
+       struct pci_dev *pf;
+
+       if (!dev->is_virtfn)
+               return -EINVAL;
+
+       pf = pci_physfn(dev);
+       return (((dev->bus->number << 8) + dev->devfn) -
+               ((pf->bus->number << 8) + pf->devfn + pf->sriov->offset)) /
+              pf->sriov->stride;
+}
+EXPORT_SYMBOL_GPL(pci_iov_vf_id);
+
+/**
+ * pci_iov_get_pf_drvdata - Return the drvdata of a PF
+ * @dev - VF pci_dev
+ * @pf_driver - Device driver required to own the PF
+ *
+ * This must be called from a context that ensures that a VF driver is attached.
+ * The value returned is invalid once the VF driver completes its remove()
+ * callback.
+ *
+ * Locking is achieved by the driver core. A VF driver cannot be probed until
+ * pci_enable_sriov() is called and pci_disable_sriov() does not return until
+ * all VF drivers have completed their remove().
+ *
+ * The PF driver must call pci_disable_sriov() before it begins to destroy the
+ * drvdata.
+ */
+void *pci_iov_get_pf_drvdata(struct pci_dev *dev, struct pci_driver *pf_driver)
+{
+       struct pci_dev *pf_dev;
+
+       if (!dev->is_virtfn)
+               return ERR_PTR(-EINVAL);
+       pf_dev = dev->physfn;
+       if (pf_dev->driver != pf_driver)
+               return ERR_PTR(-EINVAL);
+       return pci_get_drvdata(pf_dev);
+}
+EXPORT_SYMBOL_GPL(pci_iov_get_pf_drvdata);
+
 /*
  * Per SR-IOV spec sec 3.3.10 and 3.3.11, First VF Offset and VF Stride may
  * change when NumVFs changes.
index 860424c..187b9c2 100644 (file)
@@ -43,4 +43,7 @@ config VFIO_PCI_IGD
 
          To enable Intel IGD assignment through vfio-pci, say Y.
 endif
+
+source "drivers/vfio/pci/mlx5/Kconfig"
+
 endif
index 349d68d..ed9d6f2 100644 (file)
@@ -7,3 +7,5 @@ obj-$(CONFIG_VFIO_PCI_CORE) += vfio-pci-core.o
 vfio-pci-y := vfio_pci.o
 vfio-pci-$(CONFIG_VFIO_PCI_IGD) += vfio_pci_igd.o
 obj-$(CONFIG_VFIO_PCI) += vfio-pci.o
+
+obj-$(CONFIG_MLX5_VFIO_PCI)           += mlx5/
diff --git a/drivers/vfio/pci/mlx5/Kconfig b/drivers/vfio/pci/mlx5/Kconfig
new file mode 100644 (file)
index 0000000..29ba9c5
--- /dev/null
@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: GPL-2.0-only
+config MLX5_VFIO_PCI
+       tristate "VFIO support for MLX5 PCI devices"
+       depends on MLX5_CORE
+       depends on VFIO_PCI_CORE
+       help
+         This provides migration support for MLX5 devices using the VFIO
+         framework.
+
+         If you don't know what to do here, say N.
diff --git a/drivers/vfio/pci/mlx5/Makefile b/drivers/vfio/pci/mlx5/Makefile
new file mode 100644 (file)
index 0000000..689627d
--- /dev/null
@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: GPL-2.0-only
+obj-$(CONFIG_MLX5_VFIO_PCI) += mlx5-vfio-pci.o
+mlx5-vfio-pci-y := main.o cmd.o
+
diff --git a/drivers/vfio/pci/mlx5/cmd.c b/drivers/vfio/pci/mlx5/cmd.c
new file mode 100644 (file)
index 0000000..5c9f921
--- /dev/null
@@ -0,0 +1,259 @@
+// SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB
+/*
+ * Copyright (c) 2021-2022, NVIDIA CORPORATION & AFFILIATES. All rights reserved
+ */
+
+#include "cmd.h"
+
+int mlx5vf_cmd_suspend_vhca(struct pci_dev *pdev, u16 vhca_id, u16 op_mod)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 out[MLX5_ST_SZ_DW(suspend_vhca_out)] = {};
+       u32 in[MLX5_ST_SZ_DW(suspend_vhca_in)] = {};
+       int ret;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       MLX5_SET(suspend_vhca_in, in, opcode, MLX5_CMD_OP_SUSPEND_VHCA);
+       MLX5_SET(suspend_vhca_in, in, vhca_id, vhca_id);
+       MLX5_SET(suspend_vhca_in, in, op_mod, op_mod);
+
+       ret = mlx5_cmd_exec_inout(mdev, suspend_vhca, in, out);
+       mlx5_vf_put_core_dev(mdev);
+       return ret;
+}
+
+int mlx5vf_cmd_resume_vhca(struct pci_dev *pdev, u16 vhca_id, u16 op_mod)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 out[MLX5_ST_SZ_DW(resume_vhca_out)] = {};
+       u32 in[MLX5_ST_SZ_DW(resume_vhca_in)] = {};
+       int ret;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       MLX5_SET(resume_vhca_in, in, opcode, MLX5_CMD_OP_RESUME_VHCA);
+       MLX5_SET(resume_vhca_in, in, vhca_id, vhca_id);
+       MLX5_SET(resume_vhca_in, in, op_mod, op_mod);
+
+       ret = mlx5_cmd_exec_inout(mdev, resume_vhca, in, out);
+       mlx5_vf_put_core_dev(mdev);
+       return ret;
+}
+
+int mlx5vf_cmd_query_vhca_migration_state(struct pci_dev *pdev, u16 vhca_id,
+                                         size_t *state_size)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 out[MLX5_ST_SZ_DW(query_vhca_migration_state_out)] = {};
+       u32 in[MLX5_ST_SZ_DW(query_vhca_migration_state_in)] = {};
+       int ret;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       MLX5_SET(query_vhca_migration_state_in, in, opcode,
+                MLX5_CMD_OP_QUERY_VHCA_MIGRATION_STATE);
+       MLX5_SET(query_vhca_migration_state_in, in, vhca_id, vhca_id);
+       MLX5_SET(query_vhca_migration_state_in, in, op_mod, 0);
+
+       ret = mlx5_cmd_exec_inout(mdev, query_vhca_migration_state, in, out);
+       if (ret)
+               goto end;
+
+       *state_size = MLX5_GET(query_vhca_migration_state_out, out,
+                              required_umem_size);
+
+end:
+       mlx5_vf_put_core_dev(mdev);
+       return ret;
+}
+
+int mlx5vf_cmd_get_vhca_id(struct pci_dev *pdev, u16 function_id, u16 *vhca_id)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 in[MLX5_ST_SZ_DW(query_hca_cap_in)] = {};
+       int out_size;
+       void *out;
+       int ret;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       out_size = MLX5_ST_SZ_BYTES(query_hca_cap_out);
+       out = kzalloc(out_size, GFP_KERNEL);
+       if (!out) {
+               ret = -ENOMEM;
+               goto end;
+       }
+
+       MLX5_SET(query_hca_cap_in, in, opcode, MLX5_CMD_OP_QUERY_HCA_CAP);
+       MLX5_SET(query_hca_cap_in, in, other_function, 1);
+       MLX5_SET(query_hca_cap_in, in, function_id, function_id);
+       MLX5_SET(query_hca_cap_in, in, op_mod,
+                MLX5_SET_HCA_CAP_OP_MOD_GENERAL_DEVICE << 1 |
+                HCA_CAP_OPMOD_GET_CUR);
+
+       ret = mlx5_cmd_exec_inout(mdev, query_hca_cap, in, out);
+       if (ret)
+               goto err_exec;
+
+       *vhca_id = MLX5_GET(query_hca_cap_out, out,
+                           capability.cmd_hca_cap.vhca_id);
+
+err_exec:
+       kfree(out);
+end:
+       mlx5_vf_put_core_dev(mdev);
+       return ret;
+}
+
+static int _create_state_mkey(struct mlx5_core_dev *mdev, u32 pdn,
+                             struct mlx5_vf_migration_file *migf, u32 *mkey)
+{
+       size_t npages = DIV_ROUND_UP(migf->total_length, PAGE_SIZE);
+       struct sg_dma_page_iter dma_iter;
+       int err = 0, inlen;
+       __be64 *mtt;
+       void *mkc;
+       u32 *in;
+
+       inlen = MLX5_ST_SZ_BYTES(create_mkey_in) +
+               sizeof(*mtt) * round_up(npages, 2);
+
+       in = kvzalloc(inlen, GFP_KERNEL);
+       if (!in)
+               return -ENOMEM;
+
+       MLX5_SET(create_mkey_in, in, translations_octword_actual_size,
+                DIV_ROUND_UP(npages, 2));
+       mtt = (__be64 *)MLX5_ADDR_OF(create_mkey_in, in, klm_pas_mtt);
+
+       for_each_sgtable_dma_page(&migf->table.sgt, &dma_iter, 0)
+               *mtt++ = cpu_to_be64(sg_page_iter_dma_address(&dma_iter));
+
+       mkc = MLX5_ADDR_OF(create_mkey_in, in, memory_key_mkey_entry);
+       MLX5_SET(mkc, mkc, access_mode_1_0, MLX5_MKC_ACCESS_MODE_MTT);
+       MLX5_SET(mkc, mkc, lr, 1);
+       MLX5_SET(mkc, mkc, lw, 1);
+       MLX5_SET(mkc, mkc, rr, 1);
+       MLX5_SET(mkc, mkc, rw, 1);
+       MLX5_SET(mkc, mkc, pd, pdn);
+       MLX5_SET(mkc, mkc, bsf_octword_size, 0);
+       MLX5_SET(mkc, mkc, qpn, 0xffffff);
+       MLX5_SET(mkc, mkc, log_page_size, PAGE_SHIFT);
+       MLX5_SET(mkc, mkc, translations_octword_size, DIV_ROUND_UP(npages, 2));
+       MLX5_SET64(mkc, mkc, len, migf->total_length);
+       err = mlx5_core_create_mkey(mdev, mkey, in, inlen);
+       kvfree(in);
+       return err;
+}
+
+int mlx5vf_cmd_save_vhca_state(struct pci_dev *pdev, u16 vhca_id,
+                              struct mlx5_vf_migration_file *migf)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 out[MLX5_ST_SZ_DW(save_vhca_state_out)] = {};
+       u32 in[MLX5_ST_SZ_DW(save_vhca_state_in)] = {};
+       u32 pdn, mkey;
+       int err;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       err = mlx5_core_alloc_pd(mdev, &pdn);
+       if (err)
+               goto end;
+
+       err = dma_map_sgtable(mdev->device, &migf->table.sgt, DMA_FROM_DEVICE,
+                             0);
+       if (err)
+               goto err_dma_map;
+
+       err = _create_state_mkey(mdev, pdn, migf, &mkey);
+       if (err)
+               goto err_create_mkey;
+
+       MLX5_SET(save_vhca_state_in, in, opcode,
+                MLX5_CMD_OP_SAVE_VHCA_STATE);
+       MLX5_SET(save_vhca_state_in, in, op_mod, 0);
+       MLX5_SET(save_vhca_state_in, in, vhca_id, vhca_id);
+       MLX5_SET(save_vhca_state_in, in, mkey, mkey);
+       MLX5_SET(save_vhca_state_in, in, size, migf->total_length);
+
+       err = mlx5_cmd_exec_inout(mdev, save_vhca_state, in, out);
+       if (err)
+               goto err_exec;
+
+       migf->total_length =
+               MLX5_GET(save_vhca_state_out, out, actual_image_size);
+
+       mlx5_core_destroy_mkey(mdev, mkey);
+       mlx5_core_dealloc_pd(mdev, pdn);
+       dma_unmap_sgtable(mdev->device, &migf->table.sgt, DMA_FROM_DEVICE, 0);
+       mlx5_vf_put_core_dev(mdev);
+
+       return 0;
+
+err_exec:
+       mlx5_core_destroy_mkey(mdev, mkey);
+err_create_mkey:
+       dma_unmap_sgtable(mdev->device, &migf->table.sgt, DMA_FROM_DEVICE, 0);
+err_dma_map:
+       mlx5_core_dealloc_pd(mdev, pdn);
+end:
+       mlx5_vf_put_core_dev(mdev);
+       return err;
+}
+
+int mlx5vf_cmd_load_vhca_state(struct pci_dev *pdev, u16 vhca_id,
+                              struct mlx5_vf_migration_file *migf)
+{
+       struct mlx5_core_dev *mdev = mlx5_vf_get_core_dev(pdev);
+       u32 out[MLX5_ST_SZ_DW(save_vhca_state_out)] = {};
+       u32 in[MLX5_ST_SZ_DW(save_vhca_state_in)] = {};
+       u32 pdn, mkey;
+       int err;
+
+       if (!mdev)
+               return -ENOTCONN;
+
+       mutex_lock(&migf->lock);
+       if (!migf->total_length) {
+               err = -EINVAL;
+               goto end;
+       }
+
+       err = mlx5_core_alloc_pd(mdev, &pdn);
+       if (err)
+               goto end;
+
+       err = dma_map_sgtable(mdev->device, &migf->table.sgt, DMA_TO_DEVICE, 0);
+       if (err)
+               goto err_reg;
+
+       err = _create_state_mkey(mdev, pdn, migf, &mkey);
+       if (err)
+               goto err_mkey;
+
+       MLX5_SET(load_vhca_state_in, in, opcode,
+                MLX5_CMD_OP_LOAD_VHCA_STATE);
+       MLX5_SET(load_vhca_state_in, in, op_mod, 0);
+       MLX5_SET(load_vhca_state_in, in, vhca_id, vhca_id);
+       MLX5_SET(load_vhca_state_in, in, mkey, mkey);
+       MLX5_SET(load_vhca_state_in, in, size, migf->total_length);
+
+       err = mlx5_cmd_exec_inout(mdev, load_vhca_state, in, out);
+
+       mlx5_core_destroy_mkey(mdev, mkey);
+err_mkey:
+       dma_unmap_sgtable(mdev->device, &migf->table.sgt, DMA_TO_DEVICE, 0);
+err_reg:
+       mlx5_core_dealloc_pd(mdev, pdn);
+end:
+       mlx5_vf_put_core_dev(mdev);
+       mutex_unlock(&migf->lock);
+       return err;
+}
diff --git a/drivers/vfio/pci/mlx5/cmd.h b/drivers/vfio/pci/mlx5/cmd.h
new file mode 100644 (file)
index 0000000..1392a11
--- /dev/null
@@ -0,0 +1,36 @@
+/* SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB */
+/*
+ * Copyright (c) 2021-2022, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+ */
+
+#ifndef MLX5_VFIO_CMD_H
+#define MLX5_VFIO_CMD_H
+
+#include <linux/kernel.h>
+#include <linux/mlx5/driver.h>
+
+struct mlx5_vf_migration_file {
+       struct file *filp;
+       struct mutex lock;
+       bool disabled;
+
+       struct sg_append_table table;
+       size_t total_length;
+       size_t allocated_length;
+
+       /* Optimize mlx5vf_get_migration_page() for sequential access */
+       struct scatterlist *last_offset_sg;
+       unsigned int sg_last_entry;
+       unsigned long last_offset;
+};
+
+int mlx5vf_cmd_suspend_vhca(struct pci_dev *pdev, u16 vhca_id, u16 op_mod);
+int mlx5vf_cmd_resume_vhca(struct pci_dev *pdev, u16 vhca_id, u16 op_mod);
+int mlx5vf_cmd_query_vhca_migration_state(struct pci_dev *pdev, u16 vhca_id,
+                                         size_t *state_size);
+int mlx5vf_cmd_get_vhca_id(struct pci_dev *pdev, u16 function_id, u16 *vhca_id);
+int mlx5vf_cmd_save_vhca_state(struct pci_dev *pdev, u16 vhca_id,
+                              struct mlx5_vf_migration_file *migf);
+int mlx5vf_cmd_load_vhca_state(struct pci_dev *pdev, u16 vhca_id,
+                              struct mlx5_vf_migration_file *migf);
+#endif /* MLX5_VFIO_CMD_H */
diff --git a/drivers/vfio/pci/mlx5/main.c b/drivers/vfio/pci/mlx5/main.c
new file mode 100644 (file)
index 0000000..282a9d4
--- /dev/null
@@ -0,0 +1,676 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Copyright (c) 2021-2022, NVIDIA CORPORATION & AFFILIATES. All rights reserved
+ */
+
+#include <linux/device.h>
+#include <linux/eventfd.h>
+#include <linux/file.h>
+#include <linux/interrupt.h>
+#include <linux/iommu.h>
+#include <linux/module.h>
+#include <linux/mutex.h>
+#include <linux/notifier.h>
+#include <linux/pci.h>
+#include <linux/pm_runtime.h>
+#include <linux/types.h>
+#include <linux/uaccess.h>
+#include <linux/vfio.h>
+#include <linux/sched/mm.h>
+#include <linux/vfio_pci_core.h>
+#include <linux/anon_inodes.h>
+
+#include "cmd.h"
+
+/* Arbitrary to prevent userspace from consuming endless memory */
+#define MAX_MIGRATION_SIZE (512*1024*1024)
+
+struct mlx5vf_pci_core_device {
+       struct vfio_pci_core_device core_device;
+       u16 vhca_id;
+       u8 migrate_cap:1;
+       u8 deferred_reset:1;
+       /* protect migration state */
+       struct mutex state_mutex;
+       enum vfio_device_mig_state mig_state;
+       /* protect the reset_done flow */
+       spinlock_t reset_lock;
+       struct mlx5_vf_migration_file *resuming_migf;
+       struct mlx5_vf_migration_file *saving_migf;
+};
+
+static struct page *
+mlx5vf_get_migration_page(struct mlx5_vf_migration_file *migf,
+                         unsigned long offset)
+{
+       unsigned long cur_offset = 0;
+       struct scatterlist *sg;
+       unsigned int i;
+
+       /* All accesses are sequential */
+       if (offset < migf->last_offset || !migf->last_offset_sg) {
+               migf->last_offset = 0;
+               migf->last_offset_sg = migf->table.sgt.sgl;
+               migf->sg_last_entry = 0;
+       }
+
+       cur_offset = migf->last_offset;
+
+       for_each_sg(migf->last_offset_sg, sg,
+                       migf->table.sgt.orig_nents - migf->sg_last_entry, i) {
+               if (offset < sg->length + cur_offset) {
+                       migf->last_offset_sg = sg;
+                       migf->sg_last_entry += i;
+                       migf->last_offset = cur_offset;
+                       return nth_page(sg_page(sg),
+                                       (offset - cur_offset) / PAGE_SIZE);
+               }
+               cur_offset += sg->length;
+       }
+       return NULL;
+}
+
+static int mlx5vf_add_migration_pages(struct mlx5_vf_migration_file *migf,
+                                     unsigned int npages)
+{
+       unsigned int to_alloc = npages;
+       struct page **page_list;
+       unsigned long filled;
+       unsigned int to_fill;
+       int ret;
+
+       to_fill = min_t(unsigned int, npages, PAGE_SIZE / sizeof(*page_list));
+       page_list = kvzalloc(to_fill * sizeof(*page_list), GFP_KERNEL);
+       if (!page_list)
+               return -ENOMEM;
+
+       do {
+               filled = alloc_pages_bulk_array(GFP_KERNEL, to_fill, page_list);
+               if (!filled) {
+                       ret = -ENOMEM;
+                       goto err;
+               }
+               to_alloc -= filled;
+               ret = sg_alloc_append_table_from_pages(
+                       &migf->table, page_list, filled, 0,
+                       filled << PAGE_SHIFT, UINT_MAX, SG_MAX_SINGLE_ALLOC,
+                       GFP_KERNEL);
+
+               if (ret)
+                       goto err;
+               migf->allocated_length += filled * PAGE_SIZE;
+               /* clean input for another bulk allocation */
+               memset(page_list, 0, filled * sizeof(*page_list));
+               to_fill = min_t(unsigned int, to_alloc,
+                               PAGE_SIZE / sizeof(*page_list));
+       } while (to_alloc > 0);
+
+       kvfree(page_list);
+       return 0;
+
+err:
+       kvfree(page_list);
+       return ret;
+}
+
+static void mlx5vf_disable_fd(struct mlx5_vf_migration_file *migf)
+{
+       struct sg_page_iter sg_iter;
+
+       mutex_lock(&migf->lock);
+       /* Undo alloc_pages_bulk_array() */
+       for_each_sgtable_page(&migf->table.sgt, &sg_iter, 0)
+               __free_page(sg_page_iter_page(&sg_iter));
+       sg_free_append_table(&migf->table);
+       migf->disabled = true;
+       migf->total_length = 0;
+       migf->allocated_length = 0;
+       migf->filp->f_pos = 0;
+       mutex_unlock(&migf->lock);
+}
+
+static int mlx5vf_release_file(struct inode *inode, struct file *filp)
+{
+       struct mlx5_vf_migration_file *migf = filp->private_data;
+
+       mlx5vf_disable_fd(migf);
+       mutex_destroy(&migf->lock);
+       kfree(migf);
+       return 0;
+}
+
+static ssize_t mlx5vf_save_read(struct file *filp, char __user *buf, size_t len,
+                              loff_t *pos)
+{
+       struct mlx5_vf_migration_file *migf = filp->private_data;
+       ssize_t done = 0;
+
+       if (pos)
+               return -ESPIPE;
+       pos = &filp->f_pos;
+
+       mutex_lock(&migf->lock);
+       if (*pos > migf->total_length) {
+               done = -EINVAL;
+               goto out_unlock;
+       }
+       if (migf->disabled) {
+               done = -ENODEV;
+               goto out_unlock;
+       }
+
+       len = min_t(size_t, migf->total_length - *pos, len);
+       while (len) {
+               size_t page_offset;
+               struct page *page;
+               size_t page_len;
+               u8 *from_buff;
+               int ret;
+
+               page_offset = (*pos) % PAGE_SIZE;
+               page = mlx5vf_get_migration_page(migf, *pos - page_offset);
+               if (!page) {
+                       if (done == 0)
+                               done = -EINVAL;
+                       goto out_unlock;
+               }
+
+               page_len = min_t(size_t, len, PAGE_SIZE - page_offset);
+               from_buff = kmap_local_page(page);
+               ret = copy_to_user(buf, from_buff + page_offset, page_len);
+               kunmap_local(from_buff);
+               if (ret) {
+                       done = -EFAULT;
+                       goto out_unlock;
+               }
+               *pos += page_len;
+               len -= page_len;
+               done += page_len;
+               buf += page_len;
+       }
+
+out_unlock:
+       mutex_unlock(&migf->lock);
+       return done;
+}
+
+static const struct file_operations mlx5vf_save_fops = {
+       .owner = THIS_MODULE,
+       .read = mlx5vf_save_read,
+       .release = mlx5vf_release_file,
+       .llseek = no_llseek,
+};
+
+static struct mlx5_vf_migration_file *
+mlx5vf_pci_save_device_data(struct mlx5vf_pci_core_device *mvdev)
+{
+       struct mlx5_vf_migration_file *migf;
+       int ret;
+
+       migf = kzalloc(sizeof(*migf), GFP_KERNEL);
+       if (!migf)
+               return ERR_PTR(-ENOMEM);
+
+       migf->filp = anon_inode_getfile("mlx5vf_mig", &mlx5vf_save_fops, migf,
+                                       O_RDONLY);
+       if (IS_ERR(migf->filp)) {
+               int err = PTR_ERR(migf->filp);
+
+               kfree(migf);
+               return ERR_PTR(err);
+       }
+
+       stream_open(migf->filp->f_inode, migf->filp);
+       mutex_init(&migf->lock);
+
+       ret = mlx5vf_cmd_query_vhca_migration_state(
+               mvdev->core_device.pdev, mvdev->vhca_id, &migf->total_length);
+       if (ret)
+               goto out_free;
+
+       ret = mlx5vf_add_migration_pages(
+               migf, DIV_ROUND_UP_ULL(migf->total_length, PAGE_SIZE));
+       if (ret)
+               goto out_free;
+
+       ret = mlx5vf_cmd_save_vhca_state(mvdev->core_device.pdev,
+                                        mvdev->vhca_id, migf);
+       if (ret)
+               goto out_free;
+       return migf;
+out_free:
+       fput(migf->filp);
+       return ERR_PTR(ret);
+}
+
+static ssize_t mlx5vf_resume_write(struct file *filp, const char __user *buf,
+                                  size_t len, loff_t *pos)
+{
+       struct mlx5_vf_migration_file *migf = filp->private_data;
+       loff_t requested_length;
+       ssize_t done = 0;
+
+       if (pos)
+               return -ESPIPE;
+       pos = &filp->f_pos;
+
+       if (*pos < 0 ||
+           check_add_overflow((loff_t)len, *pos, &requested_length))
+               return -EINVAL;
+
+       if (requested_length > MAX_MIGRATION_SIZE)
+               return -ENOMEM;
+
+       mutex_lock(&migf->lock);
+       if (migf->disabled) {
+               done = -ENODEV;
+               goto out_unlock;
+       }
+
+       if (migf->allocated_length < requested_length) {
+               done = mlx5vf_add_migration_pages(
+                       migf,
+                       DIV_ROUND_UP(requested_length - migf->allocated_length,
+                                    PAGE_SIZE));
+               if (done)
+                       goto out_unlock;
+       }
+
+       while (len) {
+               size_t page_offset;
+               struct page *page;
+               size_t page_len;
+               u8 *to_buff;
+               int ret;
+
+               page_offset = (*pos) % PAGE_SIZE;
+               page = mlx5vf_get_migration_page(migf, *pos - page_offset);
+               if (!page) {
+                       if (done == 0)
+                               done = -EINVAL;
+                       goto out_unlock;
+               }
+
+               page_len = min_t(size_t, len, PAGE_SIZE - page_offset);
+               to_buff = kmap_local_page(page);
+               ret = copy_from_user(to_buff + page_offset, buf, page_len);
+               kunmap_local(to_buff);
+               if (ret) {
+                       done = -EFAULT;
+                       goto out_unlock;
+               }
+               *pos += page_len;
+               len -= page_len;
+               done += page_len;
+               buf += page_len;
+               migf->total_length += page_len;
+       }
+out_unlock:
+       mutex_unlock(&migf->lock);
+       return done;
+}
+
+static const struct file_operations mlx5vf_resume_fops = {
+       .owner = THIS_MODULE,
+       .write = mlx5vf_resume_write,
+       .release = mlx5vf_release_file,
+       .llseek = no_llseek,
+};
+
+static struct mlx5_vf_migration_file *
+mlx5vf_pci_resume_device_data(struct mlx5vf_pci_core_device *mvdev)
+{
+       struct mlx5_vf_migration_file *migf;
+
+       migf = kzalloc(sizeof(*migf), GFP_KERNEL);
+       if (!migf)
+               return ERR_PTR(-ENOMEM);
+
+       migf->filp = anon_inode_getfile("mlx5vf_mig", &mlx5vf_resume_fops, migf,
+                                       O_WRONLY);
+       if (IS_ERR(migf->filp)) {
+               int err = PTR_ERR(migf->filp);
+
+               kfree(migf);
+               return ERR_PTR(err);
+       }
+       stream_open(migf->filp->f_inode, migf->filp);
+       mutex_init(&migf->lock);
+       return migf;
+}
+
+static void mlx5vf_disable_fds(struct mlx5vf_pci_core_device *mvdev)
+{
+       if (mvdev->resuming_migf) {
+               mlx5vf_disable_fd(mvdev->resuming_migf);
+               fput(mvdev->resuming_migf->filp);
+               mvdev->resuming_migf = NULL;
+       }
+       if (mvdev->saving_migf) {
+               mlx5vf_disable_fd(mvdev->saving_migf);
+               fput(mvdev->saving_migf->filp);
+               mvdev->saving_migf = NULL;
+       }
+}
+
+static struct file *
+mlx5vf_pci_step_device_state_locked(struct mlx5vf_pci_core_device *mvdev,
+                                   u32 new)
+{
+       u32 cur = mvdev->mig_state;
+       int ret;
+
+       if (cur == VFIO_DEVICE_STATE_RUNNING_P2P && new == VFIO_DEVICE_STATE_STOP) {
+               ret = mlx5vf_cmd_suspend_vhca(
+                       mvdev->core_device.pdev, mvdev->vhca_id,
+                       MLX5_SUSPEND_VHCA_IN_OP_MOD_SUSPEND_RESPONDER);
+               if (ret)
+                       return ERR_PTR(ret);
+               return NULL;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_STOP && new == VFIO_DEVICE_STATE_RUNNING_P2P) {
+               ret = mlx5vf_cmd_resume_vhca(
+                       mvdev->core_device.pdev, mvdev->vhca_id,
+                       MLX5_RESUME_VHCA_IN_OP_MOD_RESUME_RESPONDER);
+               if (ret)
+                       return ERR_PTR(ret);
+               return NULL;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_RUNNING && new == VFIO_DEVICE_STATE_RUNNING_P2P) {
+               ret = mlx5vf_cmd_suspend_vhca(
+                       mvdev->core_device.pdev, mvdev->vhca_id,
+                       MLX5_SUSPEND_VHCA_IN_OP_MOD_SUSPEND_INITIATOR);
+               if (ret)
+                       return ERR_PTR(ret);
+               return NULL;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_RUNNING_P2P && new == VFIO_DEVICE_STATE_RUNNING) {
+               ret = mlx5vf_cmd_resume_vhca(
+                       mvdev->core_device.pdev, mvdev->vhca_id,
+                       MLX5_RESUME_VHCA_IN_OP_MOD_RESUME_INITIATOR);
+               if (ret)
+                       return ERR_PTR(ret);
+               return NULL;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_STOP && new == VFIO_DEVICE_STATE_STOP_COPY) {
+               struct mlx5_vf_migration_file *migf;
+
+               migf = mlx5vf_pci_save_device_data(mvdev);
+               if (IS_ERR(migf))
+                       return ERR_CAST(migf);
+               get_file(migf->filp);
+               mvdev->saving_migf = migf;
+               return migf->filp;
+       }
+
+       if ((cur == VFIO_DEVICE_STATE_STOP_COPY && new == VFIO_DEVICE_STATE_STOP)) {
+               mlx5vf_disable_fds(mvdev);
+               return 0;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_STOP && new == VFIO_DEVICE_STATE_RESUMING) {
+               struct mlx5_vf_migration_file *migf;
+
+               migf = mlx5vf_pci_resume_device_data(mvdev);
+               if (IS_ERR(migf))
+                       return ERR_CAST(migf);
+               get_file(migf->filp);
+               mvdev->resuming_migf = migf;
+               return migf->filp;
+       }
+
+       if (cur == VFIO_DEVICE_STATE_RESUMING && new == VFIO_DEVICE_STATE_STOP) {
+               ret = mlx5vf_cmd_load_vhca_state(mvdev->core_device.pdev,
+                                                mvdev->vhca_id,
+                                                mvdev->resuming_migf);
+               if (ret)
+                       return ERR_PTR(ret);
+               mlx5vf_disable_fds(mvdev);
+               return 0;
+       }
+
+       /*
+        * vfio_mig_get_next_state() does not use arcs other than the above
+        */
+       WARN_ON(true);
+       return ERR_PTR(-EINVAL);
+}
+
+/*
+ * This function is called in all state_mutex unlock cases to
+ * handle a 'deferred_reset' if exists.
+ */
+static void mlx5vf_state_mutex_unlock(struct mlx5vf_pci_core_device *mvdev)
+{
+again:
+       spin_lock(&mvdev->reset_lock);
+       if (mvdev->deferred_reset) {
+               mvdev->deferred_reset = false;
+               spin_unlock(&mvdev->reset_lock);
+               mvdev->mig_state = VFIO_DEVICE_STATE_RUNNING;
+               mlx5vf_disable_fds(mvdev);
+               goto again;
+       }
+       mutex_unlock(&mvdev->state_mutex);
+       spin_unlock(&mvdev->reset_lock);
+}
+
+static struct file *
+mlx5vf_pci_set_device_state(struct vfio_device *vdev,
+                           enum vfio_device_mig_state new_state)
+{
+       struct mlx5vf_pci_core_device *mvdev = container_of(
+               vdev, struct mlx5vf_pci_core_device, core_device.vdev);
+       enum vfio_device_mig_state next_state;
+       struct file *res = NULL;
+       int ret;
+
+       mutex_lock(&mvdev->state_mutex);
+       while (new_state != mvdev->mig_state) {
+               ret = vfio_mig_get_next_state(vdev, mvdev->mig_state,
+                                             new_state, &next_state);
+               if (ret) {
+                       res = ERR_PTR(ret);
+                       break;
+               }
+               res = mlx5vf_pci_step_device_state_locked(mvdev, next_state);
+               if (IS_ERR(res))
+                       break;
+               mvdev->mig_state = next_state;
+               if (WARN_ON(res && new_state != mvdev->mig_state)) {
+                       fput(res);
+                       res = ERR_PTR(-EINVAL);
+                       break;
+               }
+       }
+       mlx5vf_state_mutex_unlock(mvdev);
+       return res;
+}
+
+static int mlx5vf_pci_get_device_state(struct vfio_device *vdev,
+                                      enum vfio_device_mig_state *curr_state)
+{
+       struct mlx5vf_pci_core_device *mvdev = container_of(
+               vdev, struct mlx5vf_pci_core_device, core_device.vdev);
+
+       mutex_lock(&mvdev->state_mutex);
+       *curr_state = mvdev->mig_state;
+       mlx5vf_state_mutex_unlock(mvdev);
+       return 0;
+}
+
+static void mlx5vf_pci_aer_reset_done(struct pci_dev *pdev)
+{
+       struct mlx5vf_pci_core_device *mvdev = dev_get_drvdata(&pdev->dev);
+
+       if (!mvdev->migrate_cap)
+               return;
+
+       /*
+        * As the higher VFIO layers are holding locks across reset and using
+        * those same locks with the mm_lock we need to prevent ABBA deadlock
+        * with the state_mutex and mm_lock.
+        * In case the state_mutex was taken already we defer the cleanup work
+        * to the unlock flow of the other running context.
+        */
+       spin_lock(&mvdev->reset_lock);
+       mvdev->deferred_reset = true;
+       if (!mutex_trylock(&mvdev->state_mutex)) {
+               spin_unlock(&mvdev->reset_lock);
+               return;
+       }
+       spin_unlock(&mvdev->reset_lock);
+       mlx5vf_state_mutex_unlock(mvdev);
+}
+
+static int mlx5vf_pci_open_device(struct vfio_device *core_vdev)
+{
+       struct mlx5vf_pci_core_device *mvdev = container_of(
+               core_vdev, struct mlx5vf_pci_core_device, core_device.vdev);
+       struct vfio_pci_core_device *vdev = &mvdev->core_device;
+       int vf_id;
+       int ret;
+
+       ret = vfio_pci_core_enable(vdev);
+       if (ret)
+               return ret;
+
+       if (!mvdev->migrate_cap) {
+               vfio_pci_core_finish_enable(vdev);
+               return 0;
+       }
+
+       vf_id = pci_iov_vf_id(vdev->pdev);
+       if (vf_id < 0) {
+               ret = vf_id;
+               goto out_disable;
+       }
+
+       ret = mlx5vf_cmd_get_vhca_id(vdev->pdev, vf_id + 1, &mvdev->vhca_id);
+       if (ret)
+               goto out_disable;
+
+       mvdev->mig_state = VFIO_DEVICE_STATE_RUNNING;
+       vfio_pci_core_finish_enable(vdev);
+       return 0;
+out_disable:
+       vfio_pci_core_disable(vdev);
+       return ret;
+}
+
+static void mlx5vf_pci_close_device(struct vfio_device *core_vdev)
+{
+       struct mlx5vf_pci_core_device *mvdev = container_of(
+               core_vdev, struct mlx5vf_pci_core_device, core_device.vdev);
+
+       mlx5vf_disable_fds(mvdev);
+       vfio_pci_core_close_device(core_vdev);
+}
+
+static const struct vfio_device_ops mlx5vf_pci_ops = {
+       .name = "mlx5-vfio-pci",
+       .open_device = mlx5vf_pci_open_device,
+       .close_device = mlx5vf_pci_close_device,
+       .ioctl = vfio_pci_core_ioctl,
+       .device_feature = vfio_pci_core_ioctl_feature,
+       .read = vfio_pci_core_read,
+       .write = vfio_pci_core_write,
+       .mmap = vfio_pci_core_mmap,
+       .request = vfio_pci_core_request,
+       .match = vfio_pci_core_match,
+       .migration_set_state = mlx5vf_pci_set_device_state,
+       .migration_get_state = mlx5vf_pci_get_device_state,
+};
+
+static int mlx5vf_pci_probe(struct pci_dev *pdev,
+                           const struct pci_device_id *id)
+{
+       struct mlx5vf_pci_core_device *mvdev;
+       int ret;
+
+       mvdev = kzalloc(sizeof(*mvdev), GFP_KERNEL);
+       if (!mvdev)
+               return -ENOMEM;
+       vfio_pci_core_init_device(&mvdev->core_device, pdev, &mlx5vf_pci_ops);
+
+       if (pdev->is_virtfn) {
+               struct mlx5_core_dev *mdev =
+                       mlx5_vf_get_core_dev(pdev);
+
+               if (mdev) {
+                       if (MLX5_CAP_GEN(mdev, migration)) {
+                               mvdev->migrate_cap = 1;
+                               mvdev->core_device.vdev.migration_flags =
+                                       VFIO_MIGRATION_STOP_COPY |
+                                       VFIO_MIGRATION_P2P;
+                               mutex_init(&mvdev->state_mutex);
+                               spin_lock_init(&mvdev->reset_lock);
+                       }
+                       mlx5_vf_put_core_dev(mdev);
+               }
+       }
+
+       ret = vfio_pci_core_register_device(&mvdev->core_device);
+       if (ret)
+               goto out_free;
+
+       dev_set_drvdata(&pdev->dev, mvdev);
+       return 0;
+
+out_free:
+       vfio_pci_core_uninit_device(&mvdev->core_device);
+       kfree(mvdev);
+       return ret;
+}
+
+static void mlx5vf_pci_remove(struct pci_dev *pdev)
+{
+       struct mlx5vf_pci_core_device *mvdev = dev_get_drvdata(&pdev->dev);
+
+       vfio_pci_core_unregister_device(&mvdev->core_device);
+       vfio_pci_core_uninit_device(&mvdev->core_device);
+       kfree(mvdev);
+}
+
+static const struct pci_device_id mlx5vf_pci_table[] = {
+       { PCI_DRIVER_OVERRIDE_DEVICE_VFIO(PCI_VENDOR_ID_MELLANOX, 0x101e) }, /* ConnectX Family mlx5Gen Virtual Function */
+       {}
+};
+
+MODULE_DEVICE_TABLE(pci, mlx5vf_pci_table);
+
+static const struct pci_error_handlers mlx5vf_err_handlers = {
+       .reset_done = mlx5vf_pci_aer_reset_done,
+       .error_detected = vfio_pci_core_aer_err_detected,
+};
+
+static struct pci_driver mlx5vf_pci_driver = {
+       .name = KBUILD_MODNAME,
+       .id_table = mlx5vf_pci_table,
+       .probe = mlx5vf_pci_probe,
+       .remove = mlx5vf_pci_remove,
+       .err_handler = &mlx5vf_err_handlers,
+};
+
+static void __exit mlx5vf_pci_cleanup(void)
+{
+       pci_unregister_driver(&mlx5vf_pci_driver);
+}
+
+static int __init mlx5vf_pci_init(void)
+{
+       return pci_register_driver(&mlx5vf_pci_driver);
+}
+
+module_init(mlx5vf_pci_init);
+module_exit(mlx5vf_pci_cleanup);
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Max Gurtovoy <mgurtovoy@nvidia.com>");
+MODULE_AUTHOR("Yishai Hadas <yishaih@nvidia.com>");
+MODULE_DESCRIPTION(
+       "MLX5 VFIO PCI - User Level meta-driver for MLX5 device family");
index a5ce92b..2b04746 100644 (file)
@@ -130,6 +130,7 @@ static const struct vfio_device_ops vfio_pci_ops = {
        .open_device    = vfio_pci_open_device,
        .close_device   = vfio_pci_core_close_device,
        .ioctl          = vfio_pci_core_ioctl,
+       .device_feature = vfio_pci_core_ioctl_feature,
        .read           = vfio_pci_core_read,
        .write          = vfio_pci_core_write,
        .mmap           = vfio_pci_core_mmap,
index f948e6c..e301092 100644 (file)
@@ -1114,70 +1114,50 @@ hot_reset_release:
 
                return vfio_pci_ioeventfd(vdev, ioeventfd.offset,
                                          ioeventfd.data, count, ioeventfd.fd);
-       } else if (cmd == VFIO_DEVICE_FEATURE) {
-               struct vfio_device_feature feature;
-               uuid_t uuid;
-
-               minsz = offsetofend(struct vfio_device_feature, flags);
-
-               if (copy_from_user(&feature, (void __user *)arg, minsz))
-                       return -EFAULT;
-
-               if (feature.argsz < minsz)
-                       return -EINVAL;
-
-               /* Check unknown flags */
-               if (feature.flags & ~(VFIO_DEVICE_FEATURE_MASK |
-                                     VFIO_DEVICE_FEATURE_SET |
-                                     VFIO_DEVICE_FEATURE_GET |
-                                     VFIO_DEVICE_FEATURE_PROBE))
-                       return -EINVAL;
-
-               /* GET & SET are mutually exclusive except with PROBE */
-               if (!(feature.flags & VFIO_DEVICE_FEATURE_PROBE) &&
-                   (feature.flags & VFIO_DEVICE_FEATURE_SET) &&
-                   (feature.flags & VFIO_DEVICE_FEATURE_GET))
-                       return -EINVAL;
-
-               switch (feature.flags & VFIO_DEVICE_FEATURE_MASK) {
-               case VFIO_DEVICE_FEATURE_PCI_VF_TOKEN:
-                       if (!vdev->vf_token)
-                               return -ENOTTY;
-
-                       /*
-                        * We do not support GET of the VF Token UUID as this
-                        * could expose the token of the previous device user.
-                        */
-                       if (feature.flags & VFIO_DEVICE_FEATURE_GET)
-                               return -EINVAL;
-
-                       if (feature.flags & VFIO_DEVICE_FEATURE_PROBE)
-                               return 0;
+       }
+       return -ENOTTY;
+}
+EXPORT_SYMBOL_GPL(vfio_pci_core_ioctl);
 
-                       /* Don't SET unless told to do so */
-                       if (!(feature.flags & VFIO_DEVICE_FEATURE_SET))
-                               return -EINVAL;
+static int vfio_pci_core_feature_token(struct vfio_device *device, u32 flags,
+                                      void __user *arg, size_t argsz)
+{
+       struct vfio_pci_core_device *vdev =
+               container_of(device, struct vfio_pci_core_device, vdev);
+       uuid_t uuid;
+       int ret;
 
-                       if (feature.argsz < minsz + sizeof(uuid))
-                               return -EINVAL;
+       if (!vdev->vf_token)
+               return -ENOTTY;
+       /*
+        * We do not support GET of the VF Token UUID as this could
+        * expose the token of the previous device user.
+        */
+       ret = vfio_check_feature(flags, argsz, VFIO_DEVICE_FEATURE_SET,
+                                sizeof(uuid));
+       if (ret != 1)
+               return ret;
 
-                       if (copy_from_user(&uuid, (void __user *)(arg + minsz),
-                                          sizeof(uuid)))
-                               return -EFAULT;
+       if (copy_from_user(&uuid, arg, sizeof(uuid)))
+               return -EFAULT;
 
-                       mutex_lock(&vdev->vf_token->lock);
-                       uuid_copy(&vdev->vf_token->uuid, &uuid);
-                       mutex_unlock(&vdev->vf_token->lock);
+       mutex_lock(&vdev->vf_token->lock);
+       uuid_copy(&vdev->vf_token->uuid, &uuid);
+       mutex_unlock(&vdev->vf_token->lock);
+       return 0;
+}
 
-                       return 0;
-               default:
-                       return -ENOTTY;
-               }
+int vfio_pci_core_ioctl_feature(struct vfio_device *device, u32 flags,
+                               void __user *arg, size_t argsz)
+{
+       switch (flags & VFIO_DEVICE_FEATURE_MASK) {
+       case VFIO_DEVICE_FEATURE_PCI_VF_TOKEN:
+               return vfio_pci_core_feature_token(device, flags, arg, argsz);
+       default:
+               return -ENOTTY;
        }
-
-       return -ENOTTY;
 }
-EXPORT_SYMBOL_GPL(vfio_pci_core_ioctl);
+EXPORT_SYMBOL_GPL(vfio_pci_core_ioctl_feature);
 
 static ssize_t vfio_pci_rw(struct vfio_pci_core_device *vdev, char __user *buf,
                           size_t count, loff_t *ppos, bool iswrite)
@@ -1891,8 +1871,8 @@ void vfio_pci_core_unregister_device(struct vfio_pci_core_device *vdev)
 }
 EXPORT_SYMBOL_GPL(vfio_pci_core_unregister_device);
 
-static pci_ers_result_t vfio_pci_aer_err_detected(struct pci_dev *pdev,
-                                                 pci_channel_state_t state)
+pci_ers_result_t vfio_pci_core_aer_err_detected(struct pci_dev *pdev,
+                                               pci_channel_state_t state)
 {
        struct vfio_pci_core_device *vdev;
        struct vfio_device *device;
@@ -1914,6 +1894,7 @@ static pci_ers_result_t vfio_pci_aer_err_detected(struct pci_dev *pdev,
 
        return PCI_ERS_RESULT_CAN_RECOVER;
 }
+EXPORT_SYMBOL_GPL(vfio_pci_core_aer_err_detected);
 
 int vfio_pci_core_sriov_configure(struct pci_dev *pdev, int nr_virtfn)
 {
@@ -1936,7 +1917,7 @@ int vfio_pci_core_sriov_configure(struct pci_dev *pdev, int nr_virtfn)
 EXPORT_SYMBOL_GPL(vfio_pci_core_sriov_configure);
 
 const struct pci_error_handlers vfio_pci_core_err_handlers = {
-       .error_detected = vfio_pci_aer_err_detected,
+       .error_detected = vfio_pci_core_aer_err_detected,
 };
 EXPORT_SYMBOL_GPL(vfio_pci_core_err_handlers);
 
index 735d1d3..a455501 100644 (file)
@@ -1557,15 +1557,303 @@ static int vfio_device_fops_release(struct inode *inode, struct file *filep)
        return 0;
 }
 
+/*
+ * vfio_mig_get_next_state - Compute the next step in the FSM
+ * @cur_fsm - The current state the device is in
+ * @new_fsm - The target state to reach
+ * @next_fsm - Pointer to the next step to get to new_fsm
+ *
+ * Return 0 upon success, otherwise -errno
+ * Upon success the next step in the state progression between cur_fsm and
+ * new_fsm will be set in next_fsm.
+ *
+ * This breaks down requests for combination transitions into smaller steps and
+ * returns the next step to get to new_fsm. The function may need to be called
+ * multiple times before reaching new_fsm.
+ *
+ */
+int vfio_mig_get_next_state(struct vfio_device *device,
+                           enum vfio_device_mig_state cur_fsm,
+                           enum vfio_device_mig_state new_fsm,
+                           enum vfio_device_mig_state *next_fsm)
+{
+       enum { VFIO_DEVICE_NUM_STATES = VFIO_DEVICE_STATE_RUNNING_P2P + 1 };
+       /*
+        * The coding in this table requires the driver to implement the
+        * following FSM arcs:
+        *         RESUMING -> STOP
+        *         STOP -> RESUMING
+        *         STOP -> STOP_COPY
+        *         STOP_COPY -> STOP
+        *
+        * If P2P is supported then the driver must also implement these FSM
+        * arcs:
+        *         RUNNING -> RUNNING_P2P
+        *         RUNNING_P2P -> RUNNING
+        *         RUNNING_P2P -> STOP
+        *         STOP -> RUNNING_P2P
+        * Without P2P the driver must implement:
+        *         RUNNING -> STOP
+        *         STOP -> RUNNING
+        *
+        * The coding will step through multiple states for some combination
+        * transitions; if all optional features are supported, this means the
+        * following ones:
+        *         RESUMING -> STOP -> RUNNING_P2P
+        *         RESUMING -> STOP -> RUNNING_P2P -> RUNNING
+        *         RESUMING -> STOP -> STOP_COPY
+        *         RUNNING -> RUNNING_P2P -> STOP
+        *         RUNNING -> RUNNING_P2P -> STOP -> RESUMING
+        *         RUNNING -> RUNNING_P2P -> STOP -> STOP_COPY
+        *         RUNNING_P2P -> STOP -> RESUMING
+        *         RUNNING_P2P -> STOP -> STOP_COPY
+        *         STOP -> RUNNING_P2P -> RUNNING
+        *         STOP_COPY -> STOP -> RESUMING
+        *         STOP_COPY -> STOP -> RUNNING_P2P
+        *         STOP_COPY -> STOP -> RUNNING_P2P -> RUNNING
+        */
+       static const u8 vfio_from_fsm_table[VFIO_DEVICE_NUM_STATES][VFIO_DEVICE_NUM_STATES] = {
+               [VFIO_DEVICE_STATE_STOP] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_STOP_COPY,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_RESUMING,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+               [VFIO_DEVICE_STATE_RUNNING] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_RUNNING,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+               [VFIO_DEVICE_STATE_STOP_COPY] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_STOP_COPY,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+               [VFIO_DEVICE_STATE_RESUMING] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_RESUMING,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+               [VFIO_DEVICE_STATE_RUNNING_P2P] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_RUNNING,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_STOP,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_RUNNING_P2P,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+               [VFIO_DEVICE_STATE_ERROR] = {
+                       [VFIO_DEVICE_STATE_STOP] = VFIO_DEVICE_STATE_ERROR,
+                       [VFIO_DEVICE_STATE_RUNNING] = VFIO_DEVICE_STATE_ERROR,
+                       [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_DEVICE_STATE_ERROR,
+                       [VFIO_DEVICE_STATE_RESUMING] = VFIO_DEVICE_STATE_ERROR,
+                       [VFIO_DEVICE_STATE_RUNNING_P2P] = VFIO_DEVICE_STATE_ERROR,
+                       [VFIO_DEVICE_STATE_ERROR] = VFIO_DEVICE_STATE_ERROR,
+               },
+       };
+
+       static const unsigned int state_flags_table[VFIO_DEVICE_NUM_STATES] = {
+               [VFIO_DEVICE_STATE_STOP] = VFIO_MIGRATION_STOP_COPY,
+               [VFIO_DEVICE_STATE_RUNNING] = VFIO_MIGRATION_STOP_COPY,
+               [VFIO_DEVICE_STATE_STOP_COPY] = VFIO_MIGRATION_STOP_COPY,
+               [VFIO_DEVICE_STATE_RESUMING] = VFIO_MIGRATION_STOP_COPY,
+               [VFIO_DEVICE_STATE_RUNNING_P2P] =
+                       VFIO_MIGRATION_STOP_COPY | VFIO_MIGRATION_P2P,
+               [VFIO_DEVICE_STATE_ERROR] = ~0U,
+       };
+
+       if (WARN_ON(cur_fsm >= ARRAY_SIZE(vfio_from_fsm_table) ||
+                   (state_flags_table[cur_fsm] & device->migration_flags) !=
+                       state_flags_table[cur_fsm]))
+               return -EINVAL;
+
+       if (new_fsm >= ARRAY_SIZE(vfio_from_fsm_table) ||
+          (state_flags_table[new_fsm] & device->migration_flags) !=
+                       state_flags_table[new_fsm])
+               return -EINVAL;
+
+       /*
+        * Arcs touching optional and unsupported states are skipped over. The
+        * driver will instead see an arc from the original state to the next
+        * logical state, as per the above comment.
+        */
+       *next_fsm = vfio_from_fsm_table[cur_fsm][new_fsm];
+       while ((state_flags_table[*next_fsm] & device->migration_flags) !=
+                       state_flags_table[*next_fsm])
+               *next_fsm = vfio_from_fsm_table[*next_fsm][new_fsm];
+
+       return (*next_fsm != VFIO_DEVICE_STATE_ERROR) ? 0 : -EINVAL;
+}
+EXPORT_SYMBOL_GPL(vfio_mig_get_next_state);
+
+/*
+ * Convert the drivers's struct file into a FD number and return it to userspace
+ */
+static int vfio_ioct_mig_return_fd(struct file *filp, void __user *arg,
+                                  struct vfio_device_feature_mig_state *mig)
+{
+       int ret;
+       int fd;
+
+       fd = get_unused_fd_flags(O_CLOEXEC);
+       if (fd < 0) {
+               ret = fd;
+               goto out_fput;
+       }
+
+       mig->data_fd = fd;
+       if (copy_to_user(arg, mig, sizeof(*mig))) {
+               ret = -EFAULT;
+               goto out_put_unused;
+       }
+       fd_install(fd, filp);
+       return 0;
+
+out_put_unused:
+       put_unused_fd(fd);
+out_fput:
+       fput(filp);
+       return ret;
+}
+
+static int
+vfio_ioctl_device_feature_mig_device_state(struct vfio_device *device,
+                                          u32 flags, void __user *arg,
+                                          size_t argsz)
+{
+       size_t minsz =
+               offsetofend(struct vfio_device_feature_mig_state, data_fd);
+       struct vfio_device_feature_mig_state mig;
+       struct file *filp = NULL;
+       int ret;
+
+       if (!device->ops->migration_set_state ||
+           !device->ops->migration_get_state)
+               return -ENOTTY;
+
+       ret = vfio_check_feature(flags, argsz,
+                                VFIO_DEVICE_FEATURE_SET |
+                                VFIO_DEVICE_FEATURE_GET,
+                                sizeof(mig));
+       if (ret != 1)
+               return ret;
+
+       if (copy_from_user(&mig, arg, minsz))
+               return -EFAULT;
+
+       if (flags & VFIO_DEVICE_FEATURE_GET) {
+               enum vfio_device_mig_state curr_state;
+
+               ret = device->ops->migration_get_state(device, &curr_state);
+               if (ret)
+                       return ret;
+               mig.device_state = curr_state;
+               goto out_copy;
+       }
+
+       /* Handle the VFIO_DEVICE_FEATURE_SET */
+       filp = device->ops->migration_set_state(device, mig.device_state);
+       if (IS_ERR(filp) || !filp)
+               goto out_copy;
+
+       return vfio_ioct_mig_return_fd(filp, arg, &mig);
+out_copy:
+       mig.data_fd = -1;
+       if (copy_to_user(arg, &mig, sizeof(mig)))
+               return -EFAULT;
+       if (IS_ERR(filp))
+               return PTR_ERR(filp);
+       return 0;
+}
+
+static int vfio_ioctl_device_feature_migration(struct vfio_device *device,
+                                              u32 flags, void __user *arg,
+                                              size_t argsz)
+{
+       struct vfio_device_feature_migration mig = {
+               .flags = device->migration_flags,
+       };
+       int ret;
+
+       if (!device->ops->migration_set_state ||
+           !device->ops->migration_get_state)
+               return -ENOTTY;
+
+       ret = vfio_check_feature(flags, argsz, VFIO_DEVICE_FEATURE_GET,
+                                sizeof(mig));
+       if (ret != 1)
+               return ret;
+       if (copy_to_user(arg, &mig, sizeof(mig)))
+               return -EFAULT;
+       return 0;
+}
+
+static int vfio_ioctl_device_feature(struct vfio_device *device,
+                                    struct vfio_device_feature __user *arg)
+{
+       size_t minsz = offsetofend(struct vfio_device_feature, flags);
+       struct vfio_device_feature feature;
+
+       if (copy_from_user(&feature, arg, minsz))
+               return -EFAULT;
+
+       if (feature.argsz < minsz)
+               return -EINVAL;
+
+       /* Check unknown flags */
+       if (feature.flags &
+           ~(VFIO_DEVICE_FEATURE_MASK | VFIO_DEVICE_FEATURE_SET |
+             VFIO_DEVICE_FEATURE_GET | VFIO_DEVICE_FEATURE_PROBE))
+               return -EINVAL;
+
+       /* GET & SET are mutually exclusive except with PROBE */
+       if (!(feature.flags & VFIO_DEVICE_FEATURE_PROBE) &&
+           (feature.flags & VFIO_DEVICE_FEATURE_SET) &&
+           (feature.flags & VFIO_DEVICE_FEATURE_GET))
+               return -EINVAL;
+
+       switch (feature.flags & VFIO_DEVICE_FEATURE_MASK) {
+       case VFIO_DEVICE_FEATURE_MIGRATION:
+               return vfio_ioctl_device_feature_migration(
+                       device, feature.flags, arg->data,
+                       feature.argsz - minsz);
+       case VFIO_DEVICE_FEATURE_MIG_DEVICE_STATE:
+               return vfio_ioctl_device_feature_mig_device_state(
+                       device, feature.flags, arg->data,
+                       feature.argsz - minsz);
+       default:
+               if (unlikely(!device->ops->device_feature))
+                       return -EINVAL;
+               return device->ops->device_feature(device, feature.flags,
+                                                  arg->data,
+                                                  feature.argsz - minsz);
+       }
+}
+
 static long vfio_device_fops_unl_ioctl(struct file *filep,
                                       unsigned int cmd, unsigned long arg)
 {
        struct vfio_device *device = filep->private_data;
 
-       if (unlikely(!device->ops->ioctl))
-               return -EINVAL;
-
-       return device->ops->ioctl(device, cmd, arg);
+       switch (cmd) {
+       case VFIO_DEVICE_FEATURE:
+               return vfio_ioctl_device_feature(device, (void __user *)arg);
+       default:
+               if (unlikely(!device->ops->ioctl))
+                       return -EINVAL;
+               return device->ops->ioctl(device, cmd, arg);
+       }
 }
 
 static ssize_t vfio_device_fops_read(struct file *filep, char __user *buf,
index 78655d8..319322a 100644 (file)
@@ -1143,6 +1143,9 @@ int mlx5_dm_sw_icm_alloc(struct mlx5_core_dev *dev, enum mlx5_sw_icm_type type,
 int mlx5_dm_sw_icm_dealloc(struct mlx5_core_dev *dev, enum mlx5_sw_icm_type type,
                           u64 length, u16 uid, phys_addr_t addr, u32 obj_id);
 
+struct mlx5_core_dev *mlx5_vf_get_core_dev(struct pci_dev *pdev);
+void mlx5_vf_put_core_dev(struct mlx5_core_dev *mdev);
+
 #ifdef CONFIG_MLX5_CORE_IPOIB
 struct net_device *mlx5_rdma_netdev_alloc(struct mlx5_core_dev *mdev,
                                          struct ib_device *ibdev,
index 598ac3b..b1c2740 100644 (file)
@@ -127,6 +127,11 @@ enum {
        MLX5_CMD_OP_QUERY_SF_PARTITION            = 0x111,
        MLX5_CMD_OP_ALLOC_SF                      = 0x113,
        MLX5_CMD_OP_DEALLOC_SF                    = 0x114,
+       MLX5_CMD_OP_SUSPEND_VHCA                  = 0x115,
+       MLX5_CMD_OP_RESUME_VHCA                   = 0x116,
+       MLX5_CMD_OP_QUERY_VHCA_MIGRATION_STATE    = 0x117,
+       MLX5_CMD_OP_SAVE_VHCA_STATE               = 0x118,
+       MLX5_CMD_OP_LOAD_VHCA_STATE               = 0x119,
        MLX5_CMD_OP_CREATE_MKEY                   = 0x200,
        MLX5_CMD_OP_QUERY_MKEY                    = 0x201,
        MLX5_CMD_OP_DESTROY_MKEY                  = 0x202,
@@ -1757,7 +1762,9 @@ struct mlx5_ifc_cmd_hca_cap_bits {
        u8         reserved_at_682[0x1];
        u8         log_max_sf[0x5];
        u8         apu[0x1];
-       u8         reserved_at_689[0x7];
+       u8         reserved_at_689[0x4];
+       u8         migration[0x1];
+       u8         reserved_at_68e[0x2];
        u8         log_min_sf_size[0x8];
        u8         max_num_sf_partitions[0x8];
 
@@ -11519,4 +11526,142 @@ enum {
        MLX5_MTT_PERM_RW        = MLX5_MTT_PERM_READ | MLX5_MTT_PERM_WRITE,
 };
 
+enum {
+       MLX5_SUSPEND_VHCA_IN_OP_MOD_SUSPEND_INITIATOR  = 0x0,
+       MLX5_SUSPEND_VHCA_IN_OP_MOD_SUSPEND_RESPONDER  = 0x1,
+};
+
+struct mlx5_ifc_suspend_vhca_in_bits {
+       u8         opcode[0x10];
+       u8         uid[0x10];
+
+       u8         reserved_at_20[0x10];
+       u8         op_mod[0x10];
+
+       u8         reserved_at_40[0x10];
+       u8         vhca_id[0x10];
+
+       u8         reserved_at_60[0x20];
+};
+
+struct mlx5_ifc_suspend_vhca_out_bits {
+       u8         status[0x8];
+       u8         reserved_at_8[0x18];
+
+       u8         syndrome[0x20];
+
+       u8         reserved_at_40[0x40];
+};
+
+enum {
+       MLX5_RESUME_VHCA_IN_OP_MOD_RESUME_RESPONDER  = 0x0,
+       MLX5_RESUME_VHCA_IN_OP_MOD_RESUME_INITIATOR  = 0x1,
+};
+
+struct mlx5_ifc_resume_vhca_in_bits {
+       u8         opcode[0x10];
+       u8         uid[0x10];
+
+       u8         reserved_at_20[0x10];
+       u8         op_mod[0x10];
+
+       u8         reserved_at_40[0x10];
+       u8         vhca_id[0x10];
+
+       u8         reserved_at_60[0x20];
+};
+
+struct mlx5_ifc_resume_vhca_out_bits {
+       u8         status[0x8];
+       u8         reserved_at_8[0x18];
+
+       u8         syndrome[0x20];
+
+       u8         reserved_at_40[0x40];
+};
+
+struct mlx5_ifc_query_vhca_migration_state_in_bits {
+       u8         opcode[0x10];
+       u8         uid[0x10];
+
+       u8         reserved_at_20[0x10];
+       u8         op_mod[0x10];
+
+       u8         reserved_at_40[0x10];
+       u8         vhca_id[0x10];
+
+       u8         reserved_at_60[0x20];
+};
+
+struct mlx5_ifc_query_vhca_migration_state_out_bits {
+       u8         status[0x8];
+       u8         reserved_at_8[0x18];
+
+       u8         syndrome[0x20];
+
+       u8         reserved_at_40[0x40];
+
+       u8         required_umem_size[0x20];
+
+       u8         reserved_at_a0[0x160];
+};
+
+struct mlx5_ifc_save_vhca_state_in_bits {
+       u8         opcode[0x10];
+       u8         uid[0x10];
+
+       u8         reserved_at_20[0x10];
+       u8         op_mod[0x10];
+
+       u8         reserved_at_40[0x10];
+       u8         vhca_id[0x10];
+
+       u8         reserved_at_60[0x20];
+
+       u8         va[0x40];
+
+       u8         mkey[0x20];
+
+       u8         size[0x20];
+};
+
+struct mlx5_ifc_save_vhca_state_out_bits {
+       u8         status[0x8];
+       u8         reserved_at_8[0x18];
+
+       u8         syndrome[0x20];
+
+       u8         actual_image_size[0x20];
+
+       u8         reserved_at_60[0x20];
+};
+
+struct mlx5_ifc_load_vhca_state_in_bits {
+       u8         opcode[0x10];
+       u8         uid[0x10];
+
+       u8         reserved_at_20[0x10];
+       u8         op_mod[0x10];
+
+       u8         reserved_at_40[0x10];
+       u8         vhca_id[0x10];
+
+       u8         reserved_at_60[0x20];
+
+       u8         va[0x40];
+
+       u8         mkey[0x20];
+
+       u8         size[0x20];
+};
+
+struct mlx5_ifc_load_vhca_state_out_bits {
+       u8         status[0x8];
+       u8         reserved_at_8[0x18];
+
+       u8         syndrome[0x20];
+
+       u8         reserved_at_40[0x40];
+};
+
 #endif /* MLX5_IFC_H */
index 8253a54..60d423d 100644 (file)
@@ -2166,7 +2166,8 @@ void __iomem *pci_ioremap_wc_bar(struct pci_dev *pdev, int bar);
 #ifdef CONFIG_PCI_IOV
 int pci_iov_virtfn_bus(struct pci_dev *dev, int id);
 int pci_iov_virtfn_devfn(struct pci_dev *dev, int id);
-
+int pci_iov_vf_id(struct pci_dev *dev);
+void *pci_iov_get_pf_drvdata(struct pci_dev *dev, struct pci_driver *pf_driver);
 int pci_enable_sriov(struct pci_dev *dev, int nr_virtfn);
 void pci_disable_sriov(struct pci_dev *dev);
 
@@ -2194,6 +2195,18 @@ static inline int pci_iov_virtfn_devfn(struct pci_dev *dev, int id)
 {
        return -ENOSYS;
 }
+
+static inline int pci_iov_vf_id(struct pci_dev *dev)
+{
+       return -ENOSYS;
+}
+
+static inline void *pci_iov_get_pf_drvdata(struct pci_dev *dev,
+                                          struct pci_driver *pf_driver)
+{
+       return ERR_PTR(-EINVAL);
+}
+
 static inline int pci_enable_sriov(struct pci_dev *dev, int nr_virtfn)
 { return -ENODEV; }
 
index 76191d7..66dda06 100644 (file)
@@ -33,6 +33,7 @@ struct vfio_device {
        struct vfio_group *group;
        struct vfio_device_set *dev_set;
        struct list_head dev_set_list;
+       unsigned int migration_flags;
 
        /* Members below here are private, not for driver use */
        refcount_t refcount;
@@ -55,6 +56,17 @@ struct vfio_device {
  * @match: Optional device name match callback (return: 0 for no-match, >0 for
  *         match, -errno for abort (ex. match with insufficient or incorrect
  *         additional args)
+ * @device_feature: Optional, fill in the VFIO_DEVICE_FEATURE ioctl
+ * @migration_set_state: Optional callback to change the migration state for
+ *         devices that support migration. It's mandatory for
+ *         VFIO_DEVICE_FEATURE_MIGRATION migration support.
+ *         The returned FD is used for data transfer according to the FSM
+ *         definition. The driver is responsible to ensure that FD reaches end
+ *         of stream or error whenever the migration FSM leaves a data transfer
+ *         state or before close_device() returns.
+ * @migration_get_state: Optional callback to get the migration state for
+ *         devices that support migration. It's mandatory for
+ *         VFIO_DEVICE_FEATURE_MIGRATION migration support.
  */
 struct vfio_device_ops {
        char    *name;
@@ -69,8 +81,44 @@ struct vfio_device_ops {
        int     (*mmap)(struct vfio_device *vdev, struct vm_area_struct *vma);
        void    (*request)(struct vfio_device *vdev, unsigned int count);
        int     (*match)(struct vfio_device *vdev, char *buf);
+       int     (*device_feature)(struct vfio_device *device, u32 flags,
+                                 void __user *arg, size_t argsz);
+       struct file *(*migration_set_state)(
+               struct vfio_device *device,
+               enum vfio_device_mig_state new_state);
+       int (*migration_get_state)(struct vfio_device *device,
+                                  enum vfio_device_mig_state *curr_state);
 };
 
+/**
+ * vfio_check_feature - Validate user input for the VFIO_DEVICE_FEATURE ioctl
+ * @flags: Arg from the device_feature op
+ * @argsz: Arg from the device_feature op
+ * @supported_ops: Combination of VFIO_DEVICE_FEATURE_GET and SET the driver
+ *                 supports
+ * @minsz: Minimum data size the driver accepts
+ *
+ * For use in a driver's device_feature op. Checks that the inputs to the
+ * VFIO_DEVICE_FEATURE ioctl are correct for the driver's feature. Returns 1 if
+ * the driver should execute the get or set, otherwise the relevant
+ * value should be returned.
+ */
+static inline int vfio_check_feature(u32 flags, size_t argsz, u32 supported_ops,
+                                   size_t minsz)
+{
+       if ((flags & (VFIO_DEVICE_FEATURE_GET | VFIO_DEVICE_FEATURE_SET)) &
+           ~supported_ops)
+               return -EINVAL;
+       if (flags & VFIO_DEVICE_FEATURE_PROBE)
+               return 0;
+       /* Without PROBE one of GET or SET must be requested */
+       if (!(flags & (VFIO_DEVICE_FEATURE_GET | VFIO_DEVICE_FEATURE_SET)))
+               return -EINVAL;
+       if (argsz < minsz)
+               return -EINVAL;
+       return 1;
+}
+
 void vfio_init_group_dev(struct vfio_device *device, struct device *dev,
                         const struct vfio_device_ops *ops);
 void vfio_uninit_group_dev(struct vfio_device *device);
@@ -82,6 +130,11 @@ extern void vfio_device_put(struct vfio_device *device);
 
 int vfio_assign_device_set(struct vfio_device *device, void *set_id);
 
+int vfio_mig_get_next_state(struct vfio_device *device,
+                           enum vfio_device_mig_state cur_fsm,
+                           enum vfio_device_mig_state new_fsm,
+                           enum vfio_device_mig_state *next_fsm);
+
 /*
  * External user API
  */
index ef9a44b..9f1bf8e 100644 (file)
@@ -220,6 +220,8 @@ int vfio_pci_core_sriov_configure(struct pci_dev *pdev, int nr_virtfn);
 extern const struct pci_error_handlers vfio_pci_core_err_handlers;
 long vfio_pci_core_ioctl(struct vfio_device *core_vdev, unsigned int cmd,
                unsigned long arg);
+int vfio_pci_core_ioctl_feature(struct vfio_device *device, u32 flags,
+                               void __user *arg, size_t argsz);
 ssize_t vfio_pci_core_read(struct vfio_device *core_vdev, char __user *buf,
                size_t count, loff_t *ppos);
 ssize_t vfio_pci_core_write(struct vfio_device *core_vdev, const char __user *buf,
@@ -230,6 +232,8 @@ int vfio_pci_core_match(struct vfio_device *core_vdev, char *buf);
 int vfio_pci_core_enable(struct vfio_pci_core_device *vdev);
 void vfio_pci_core_disable(struct vfio_pci_core_device *vdev);
 void vfio_pci_core_finish_enable(struct vfio_pci_core_device *vdev);
+pci_ers_result_t vfio_pci_core_aer_err_detected(struct pci_dev *pdev,
+                                               pci_channel_state_t state);
 
 static inline bool vfio_pci_is_vga(struct pci_dev *pdev)
 {
index ef33ea0..fea8606 100644 (file)
@@ -323,7 +323,7 @@ struct vfio_region_info_cap_type {
 #define VFIO_REGION_TYPE_PCI_VENDOR_MASK       (0xffff)
 #define VFIO_REGION_TYPE_GFX                    (1)
 #define VFIO_REGION_TYPE_CCW                   (2)
-#define VFIO_REGION_TYPE_MIGRATION              (3)
+#define VFIO_REGION_TYPE_MIGRATION_DEPRECATED   (3)
 
 /* sub-types for VFIO_REGION_TYPE_PCI_* */
 
@@ -405,225 +405,29 @@ struct vfio_region_gfx_edid {
 #define VFIO_REGION_SUBTYPE_CCW_CRW            (3)
 
 /* sub-types for VFIO_REGION_TYPE_MIGRATION */
-#define VFIO_REGION_SUBTYPE_MIGRATION           (1)
-
-/*
- * The structure vfio_device_migration_info is placed at the 0th offset of
- * the VFIO_REGION_SUBTYPE_MIGRATION region to get and set VFIO device related
- * migration information. Field accesses from this structure are only supported
- * at their native width and alignment. Otherwise, the result is undefined and
- * vendor drivers should return an error.
- *
- * device_state: (read/write)
- *      - The user application writes to this field to inform the vendor driver
- *        about the device state to be transitioned to.
- *      - The vendor driver should take the necessary actions to change the
- *        device state. After successful transition to a given state, the
- *        vendor driver should return success on write(device_state, state)
- *        system call. If the device state transition fails, the vendor driver
- *        should return an appropriate -errno for the fault condition.
- *      - On the user application side, if the device state transition fails,
- *       that is, if write(device_state, state) returns an error, read
- *       device_state again to determine the current state of the device from
- *       the vendor driver.
- *      - The vendor driver should return previous state of the device unless
- *        the vendor driver has encountered an internal error, in which case
- *        the vendor driver may report the device_state VFIO_DEVICE_STATE_ERROR.
- *      - The user application must use the device reset ioctl to recover the
- *        device from VFIO_DEVICE_STATE_ERROR state. If the device is
- *        indicated to be in a valid device state by reading device_state, the
- *        user application may attempt to transition the device to any valid
- *        state reachable from the current state or terminate itself.
- *
- *      device_state consists of 3 bits:
- *      - If bit 0 is set, it indicates the _RUNNING state. If bit 0 is clear,
- *        it indicates the _STOP state. When the device state is changed to
- *        _STOP, driver should stop the device before write() returns.
- *      - If bit 1 is set, it indicates the _SAVING state, which means that the
- *        driver should start gathering device state information that will be
- *        provided to the VFIO user application to save the device's state.
- *      - If bit 2 is set, it indicates the _RESUMING state, which means that
- *        the driver should prepare to resume the device. Data provided through
- *        the migration region should be used to resume the device.
- *      Bits 3 - 31 are reserved for future use. To preserve them, the user
- *      application should perform a read-modify-write operation on this
- *      field when modifying the specified bits.
- *
- *  +------- _RESUMING
- *  |+------ _SAVING
- *  ||+----- _RUNNING
- *  |||
- *  000b => Device Stopped, not saving or resuming
- *  001b => Device running, which is the default state
- *  010b => Stop the device & save the device state, stop-and-copy state
- *  011b => Device running and save the device state, pre-copy state
- *  100b => Device stopped and the device state is resuming
- *  101b => Invalid state
- *  110b => Error state
- *  111b => Invalid state
- *
- * State transitions:
- *
- *              _RESUMING  _RUNNING    Pre-copy    Stop-and-copy   _STOP
- *                (100b)     (001b)     (011b)        (010b)       (000b)
- * 0. Running or default state
- *                             |
- *
- * 1. Normal Shutdown (optional)
- *                             |------------------------------------->|
- *
- * 2. Save the state or suspend
- *                             |------------------------->|---------->|
- *
- * 3. Save the state during live migration
- *                             |----------->|------------>|---------->|
- *
- * 4. Resuming
- *                  |<---------|
- *
- * 5. Resumed
- *                  |--------->|
- *
- * 0. Default state of VFIO device is _RUNNING when the user application starts.
- * 1. During normal shutdown of the user application, the user application may
- *    optionally change the VFIO device state from _RUNNING to _STOP. This
- *    transition is optional. The vendor driver must support this transition but
- *    must not require it.
- * 2. When the user application saves state or suspends the application, the
- *    device state transitions from _RUNNING to stop-and-copy and then to _STOP.
- *    On state transition from _RUNNING to stop-and-copy, driver must stop the
- *    device, save the device state and send it to the application through the
- *    migration region. The sequence to be followed for such transition is given
- *    below.
- * 3. In live migration of user application, the state transitions from _RUNNING
- *    to pre-copy, to stop-and-copy, and to _STOP.
- *    On state transition from _RUNNING to pre-copy, the driver should start
- *    gathering the device state while the application is still running and send
- *    the device state data to application through the migration region.
- *    On state transition from pre-copy to stop-and-copy, the driver must stop
- *    the device, save the device state and send it to the user application
- *    through the migration region.
- *    Vendor drivers must support the pre-copy state even for implementations
- *    where no data is provided to the user before the stop-and-copy state. The
- *    user must not be required to consume all migration data before the device
- *    transitions to a new state, including the stop-and-copy state.
- *    The sequence to be followed for above two transitions is given below.
- * 4. To start the resuming phase, the device state should be transitioned from
- *    the _RUNNING to the _RESUMING state.
- *    In the _RESUMING state, the driver should use the device state data
- *    received through the migration region to resume the device.
- * 5. After providing saved device data to the driver, the application should
- *    change the state from _RESUMING to _RUNNING.
- *
- * reserved:
- *      Reads on this field return zero and writes are ignored.
- *
- * pending_bytes: (read only)
- *      The number of pending bytes still to be migrated from the vendor driver.
- *
- * data_offset: (read only)
- *      The user application should read data_offset field from the migration
- *      region. The user application should read the device data from this
- *      offset within the migration region during the _SAVING state or write
- *      the device data during the _RESUMING state. See below for details of
- *      sequence to be followed.
- *
- * data_size: (read/write)
- *      The user application should read data_size to get the size in bytes of
- *      the data copied in the migration region during the _SAVING state and
- *      write the size in bytes of the data copied in the migration region
- *      during the _RESUMING state.
- *
- * The format of the migration region is as follows:
- *  ------------------------------------------------------------------
- * |vfio_device_migration_info|    data section                      |
- * |                          |     ///////////////////////////////  |
- * ------------------------------------------------------------------
- *   ^                              ^
- *  offset 0-trapped part        data_offset
- *
- * The structure vfio_device_migration_info is always followed by the data
- * section in the region, so data_offset will always be nonzero. The offset
- * from where the data is copied is decided by the kernel driver. The data
- * section can be trapped, mmapped, or partitioned, depending on how the kernel
- * driver defines the data section. The data section partition can be defined
- * as mapped by the sparse mmap capability. If mmapped, data_offset must be
- * page aligned, whereas initial section which contains the
- * vfio_device_migration_info structure, might not end at the offset, which is
- * page aligned. The user is not required to access through mmap regardless
- * of the capabilities of the region mmap.
- * The vendor driver should determine whether and how to partition the data
- * section. The vendor driver should return data_offset accordingly.
- *
- * The sequence to be followed while in pre-copy state and stop-and-copy state
- * is as follows:
- * a. Read pending_bytes, indicating the start of a new iteration to get device
- *    data. Repeated read on pending_bytes at this stage should have no side
- *    effects.
- *    If pending_bytes == 0, the user application should not iterate to get data
- *    for that device.
- *    If pending_bytes > 0, perform the following steps.
- * b. Read data_offset, indicating that the vendor driver should make data
- *    available through the data section. The vendor driver should return this
- *    read operation only after data is available from (region + data_offset)
- *    to (region + data_offset + data_size).
- * c. Read data_size, which is the amount of data in bytes available through
- *    the migration region.
- *    Read on data_offset and data_size should return the offset and size of
- *    the current buffer if the user application reads data_offset and
- *    data_size more than once here.
- * d. Read data_size bytes of data from (region + data_offset) from the
- *    migration region.
- * e. Process the data.
- * f. Read pending_bytes, which indicates that the data from the previous
- *    iteration has been read. If pending_bytes > 0, go to step b.
- *
- * The user application can transition from the _SAVING|_RUNNING
- * (pre-copy state) to the _SAVING (stop-and-copy) state regardless of the
- * number of pending bytes. The user application should iterate in _SAVING
- * (stop-and-copy) until pending_bytes is 0.
- *
- * The sequence to be followed while _RESUMING device state is as follows:
- * While data for this device is available, repeat the following steps:
- * a. Read data_offset from where the user application should write data.
- * b. Write migration data starting at the migration region + data_offset for
- *    the length determined by data_size from the migration source.
- * c. Write data_size, which indicates to the vendor driver that data is
- *    written in the migration region. Vendor driver must return this write
- *    operations on consuming data. Vendor driver should apply the
- *    user-provided migration region data to the device resume state.
- *
- * If an error occurs during the above sequences, the vendor driver can return
- * an error code for next read() or write() operation, which will terminate the
- * loop. The user application should then take the next necessary action, for
- * example, failing migration or terminating the user application.
- *
- * For the user application, data is opaque. The user application should write
- * data in the same order as the data is received and the data should be of
- * same transaction size at the source.
- */
+#define VFIO_REGION_SUBTYPE_MIGRATION_DEPRECATED (1)
 
 struct vfio_device_migration_info {
        __u32 device_state;         /* VFIO device state */
-#define VFIO_DEVICE_STATE_STOP      (0)
-#define VFIO_DEVICE_STATE_RUNNING   (1 << 0)
-#define VFIO_DEVICE_STATE_SAVING    (1 << 1)
-#define VFIO_DEVICE_STATE_RESUMING  (1 << 2)
-#define VFIO_DEVICE_STATE_MASK      (VFIO_DEVICE_STATE_RUNNING | \
-                                    VFIO_DEVICE_STATE_SAVING |  \
-                                    VFIO_DEVICE_STATE_RESUMING)
+#define VFIO_DEVICE_STATE_V1_STOP      (0)
+#define VFIO_DEVICE_STATE_V1_RUNNING   (1 << 0)
+#define VFIO_DEVICE_STATE_V1_SAVING    (1 << 1)
+#define VFIO_DEVICE_STATE_V1_RESUMING  (1 << 2)
+#define VFIO_DEVICE_STATE_MASK      (VFIO_DEVICE_STATE_V1_RUNNING | \
+                                    VFIO_DEVICE_STATE_V1_SAVING |  \
+                                    VFIO_DEVICE_STATE_V1_RESUMING)
 
 #define VFIO_DEVICE_STATE_VALID(state) \
-       (state & VFIO_DEVICE_STATE_RESUMING ? \
-       (state & VFIO_DEVICE_STATE_MASK) == VFIO_DEVICE_STATE_RESUMING : 1)
+       (state & VFIO_DEVICE_STATE_V1_RESUMING ? \
+       (state & VFIO_DEVICE_STATE_MASK) == VFIO_DEVICE_STATE_V1_RESUMING : 1)
 
 #define VFIO_DEVICE_STATE_IS_ERROR(state) \
-       ((state & VFIO_DEVICE_STATE_MASK) == (VFIO_DEVICE_STATE_SAVING | \
-                                             VFIO_DEVICE_STATE_RESUMING))
+       ((state & VFIO_DEVICE_STATE_MASK) == (VFIO_DEVICE_STATE_V1_SAVING | \
+                                             VFIO_DEVICE_STATE_V1_RESUMING))
 
 #define VFIO_DEVICE_STATE_SET_ERROR(state) \
-       ((state & ~VFIO_DEVICE_STATE_MASK) | VFIO_DEVICE_SATE_SAVING | \
-                                            VFIO_DEVICE_STATE_RESUMING)
+       ((state & ~VFIO_DEVICE_STATE_MASK) | VFIO_DEVICE_STATE_V1_SAVING | \
+                                            VFIO_DEVICE_STATE_V1_RESUMING)
 
        __u32 reserved;
        __u64 pending_bytes;
@@ -1002,6 +806,186 @@ struct vfio_device_feature {
  */
 #define VFIO_DEVICE_FEATURE_PCI_VF_TOKEN       (0)
 
+/*
+ * Indicates the device can support the migration API through
+ * VFIO_DEVICE_FEATURE_MIG_DEVICE_STATE. If this GET succeeds, the RUNNING and
+ * ERROR states are always supported. Support for additional states is
+ * indicated via the flags field; at least VFIO_MIGRATION_STOP_COPY must be
+ * set.
+ *
+ * VFIO_MIGRATION_STOP_COPY means that STOP, STOP_COPY and
+ * RESUMING are supported.
+ *
+ * VFIO_MIGRATION_STOP_COPY | VFIO_MIGRATION_P2P means that RUNNING_P2P
+ * is supported in addition to the STOP_COPY states.
+ *
+ * Other combinations of flags have behavior to be defined in the future.
+ */
+struct vfio_device_feature_migration {
+       __aligned_u64 flags;
+#define VFIO_MIGRATION_STOP_COPY       (1 << 0)
+#define VFIO_MIGRATION_P2P             (1 << 1)
+};
+#define VFIO_DEVICE_FEATURE_MIGRATION 1
+
+/*
+ * Upon VFIO_DEVICE_FEATURE_SET, execute a migration state change on the VFIO
+ * device. The new state is supplied in device_state, see enum
+ * vfio_device_mig_state for details
+ *
+ * The kernel migration driver must fully transition the device to the new state
+ * value before the operation returns to the user.
+ *
+ * The kernel migration driver must not generate asynchronous device state
+ * transitions outside of manipulation by the user or the VFIO_DEVICE_RESET
+ * ioctl as described above.
+ *
+ * If this function fails then current device_state may be the original
+ * operating state or some other state along the combination transition path.
+ * The user can then decide if it should execute a VFIO_DEVICE_RESET, attempt
+ * to return to the original state, or attempt to return to some other state
+ * such as RUNNING or STOP.
+ *
+ * If the new_state starts a new data transfer session then the FD associated
+ * with that session is returned in data_fd. The user is responsible to close
+ * this FD when it is finished. The user must consider the migration data stream
+ * carried over the FD to be opaque and must preserve the byte order of the
+ * stream. The user is not required to preserve buffer segmentation when writing
+ * the data stream during the RESUMING operation.
+ *
+ * Upon VFIO_DEVICE_FEATURE_GET, get the current migration state of the VFIO
+ * device, data_fd will be -1.
+ */
+struct vfio_device_feature_mig_state {
+       __u32 device_state; /* From enum vfio_device_mig_state */
+       __s32 data_fd;
+};
+#define VFIO_DEVICE_FEATURE_MIG_DEVICE_STATE 2
+
+/*
+ * The device migration Finite State Machine is described by the enum
+ * vfio_device_mig_state. Some of the FSM arcs will create a migration data
+ * transfer session by returning a FD, in this case the migration data will
+ * flow over the FD using read() and write() as discussed below.
+ *
+ * There are 5 states to support VFIO_MIGRATION_STOP_COPY:
+ *  RUNNING - The device is running normally
+ *  STOP - The device does not change the internal or external state
+ *  STOP_COPY - The device internal state can be read out
+ *  RESUMING - The device is stopped and is loading a new internal state
+ *  ERROR - The device has failed and must be reset
+ *
+ * And 1 optional state to support VFIO_MIGRATION_P2P:
+ *  RUNNING_P2P - RUNNING, except the device cannot do peer to peer DMA
+ *
+ * The FSM takes actions on the arcs between FSM states. The driver implements
+ * the following behavior for the FSM arcs:
+ *
+ * RUNNING_P2P -> STOP
+ * STOP_COPY -> STOP
+ *   While in STOP the device must stop the operation of the device. The device
+ *   must not generate interrupts, DMA, or any other change to external state.
+ *   It must not change its internal state. When stopped the device and kernel
+ *   migration driver must accept and respond to interaction to support external
+ *   subsystems in the STOP state, for example PCI MSI-X and PCI config space.
+ *   Failure by the user to restrict device access while in STOP must not result
+ *   in error conditions outside the user context (ex. host system faults).
+ *
+ *   The STOP_COPY arc will terminate a data transfer session.
+ *
+ * RESUMING -> STOP
+ *   Leaving RESUMING terminates a data transfer session and indicates the
+ *   device should complete processing of the data delivered by write(). The
+ *   kernel migration driver should complete the incorporation of data written
+ *   to the data transfer FD into the device internal state and perform
+ *   final validity and consistency checking of the new device state. If the
+ *   user provided data is found to be incomplete, inconsistent, or otherwise
+ *   invalid, the migration driver must fail the SET_STATE ioctl and
+ *   optionally go to the ERROR state as described below.
+ *
+ *   While in STOP the device has the same behavior as other STOP states
+ *   described above.
+ *
+ *   To abort a RESUMING session the device must be reset.
+ *
+ * RUNNING_P2P -> RUNNING
+ *   While in RUNNING the device is fully operational, the device may generate
+ *   interrupts, DMA, respond to MMIO, all vfio device regions are functional,
+ *   and the device may advance its internal state.
+ *
+ * RUNNING -> RUNNING_P2P
+ * STOP -> RUNNING_P2P
+ *   While in RUNNING_P2P the device is partially running in the P2P quiescent
+ *   state defined below.
+ *
+ * STOP -> STOP_COPY
+ *   This arc begin the process of saving the device state and will return a
+ *   new data_fd.
+ *
+ *   While in the STOP_COPY state the device has the same behavior as STOP
+ *   with the addition that the data transfers session continues to stream the
+ *   migration state. End of stream on the FD indicates the entire device
+ *   state has been transferred.
+ *
+ *   The user should take steps to restrict access to vfio device regions while
+ *   the device is in STOP_COPY or risk corruption of the device migration data
+ *   stream.
+ *
+ * STOP -> RESUMING
+ *   Entering the RESUMING state starts a process of restoring the device state
+ *   and will return a new data_fd. The data stream fed into the data_fd should
+ *   be taken from the data transfer output of a single FD during saving from
+ *   a compatible device. The migration driver may alter/reset the internal
+ *   device state for this arc if required to prepare the device to receive the
+ *   migration data.
+ *
+ * any -> ERROR
+ *   ERROR cannot be specified as a device state, however any transition request
+ *   can be failed with an errno return and may then move the device_state into
+ *   ERROR. In this case the device was unable to execute the requested arc and
+ *   was also unable to restore the device to any valid device_state.
+ *   To recover from ERROR VFIO_DEVICE_RESET must be used to return the
+ *   device_state back to RUNNING.
+ *
+ * The optional peer to peer (P2P) quiescent state is intended to be a quiescent
+ * state for the device for the purposes of managing multiple devices within a
+ * user context where peer-to-peer DMA between devices may be active. The
+ * RUNNING_P2P states must prevent the device from initiating
+ * any new P2P DMA transactions. If the device can identify P2P transactions
+ * then it can stop only P2P DMA, otherwise it must stop all DMA. The migration
+ * driver must complete any such outstanding operations prior to completing the
+ * FSM arc into a P2P state. For the purpose of specification the states
+ * behave as though the device was fully running if not supported. Like while in
+ * STOP or STOP_COPY the user must not touch the device, otherwise the state
+ * can be exited.
+ *
+ * The remaining possible transitions are interpreted as combinations of the
+ * above FSM arcs. As there are multiple paths through the FSM arcs the path
+ * should be selected based on the following rules:
+ *   - Select the shortest path.
+ * Refer to vfio_mig_get_next_state() for the result of the algorithm.
+ *
+ * The automatic transit through the FSM arcs that make up the combination
+ * transition is invisible to the user. When working with combination arcs the
+ * user may see any step along the path in the device_state if SET_STATE
+ * fails. When handling these types of errors users should anticipate future
+ * revisions of this protocol using new states and those states becoming
+ * visible in this case.
+ *
+ * The optional states cannot be used with SET_STATE if the device does not
+ * support them. The user can discover if these states are supported by using
+ * VFIO_DEVICE_FEATURE_MIGRATION. By using combination transitions the user can
+ * avoid knowing about these optional states if the kernel driver supports them.
+ */
+enum vfio_device_mig_state {
+       VFIO_DEVICE_STATE_ERROR = 0,
+       VFIO_DEVICE_STATE_STOP = 1,
+       VFIO_DEVICE_STATE_RUNNING = 2,
+       VFIO_DEVICE_STATE_STOP_COPY = 3,
+       VFIO_DEVICE_STATE_RESUMING = 4,
+       VFIO_DEVICE_STATE_RUNNING_P2P = 5,
+};
+
 /* -------- API for Type1 VFIO IOMMU -------- */
 
 /**