Skip to content
Snippets Groups Projects
Select Git revision
  • 4f535093cf8f6da8cfda7c36c2c1ecd2e9586ee4
  • vme-testing default
  • ci-test
  • master
  • remoteproc
  • am625-sk-ov5640
  • pcal6534-upstreaming
  • lps22df-upstreaming
  • msc-upstreaming
  • imx8mp
  • iio/noa1305
  • vme-next
  • vme-next-4.14-rc4
  • v4.14-rc4
  • v4.14-rc3
  • v4.14-rc2
  • v4.14-rc1
  • v4.13
  • vme-next-4.13-rc7
  • v4.13-rc7
  • v4.13-rc6
  • v4.13-rc5
  • v4.13-rc4
  • v4.13-rc3
  • v4.13-rc2
  • v4.13-rc1
  • v4.12
  • v4.12-rc7
  • v4.12-rc6
  • v4.12-rc5
  • v4.12-rc4
  • v4.12-rc3
32 results

iov.c

Blame
  • iov.c 17.69 KiB
    /*
     * drivers/pci/iov.c
     *
     * Copyright (C) 2009 Intel Corporation, Yu Zhao <yu.zhao@intel.com>
     *
     * PCI Express I/O Virtualization (IOV) support.
     *   Single Root IOV 1.0
     *   Address Translation Service 1.0
     */
    
    #include <linux/pci.h>
    #include <linux/slab.h>
    #include <linux/mutex.h>
    #include <linux/export.h>
    #include <linux/string.h>
    #include <linux/delay.h>
    #include <linux/pci-ats.h>
    #include "pci.h"
    
    #define VIRTFN_ID_LEN	16
    
    static inline u8 virtfn_bus(struct pci_dev *dev, int id)
    {
    	return dev->bus->number + ((dev->devfn + dev->sriov->offset +
    				    dev->sriov->stride * id) >> 8);
    }
    
    static inline u8 virtfn_devfn(struct pci_dev *dev, int id)
    {
    	return (dev->devfn + dev->sriov->offset +
    		dev->sriov->stride * id) & 0xff;
    }
    
    static struct pci_bus *virtfn_add_bus(struct pci_bus *bus, int busnr)
    {
    	int rc;
    	struct pci_bus *child;
    
    	if (bus->number == busnr)
    		return bus;
    
    	child = pci_find_bus(pci_domain_nr(bus), busnr);
    	if (child)
    		return child;
    
    	child = pci_add_new_bus(bus, NULL, busnr);
    	if (!child)
    		return NULL;
    
    	pci_bus_insert_busn_res(child, busnr, busnr);
    	bus->is_added = 1;
    
    	return child;
    }
    
    static void virtfn_remove_bus(struct pci_bus *bus, int busnr)
    {
    	struct pci_bus *child;
    
    	if (bus->number == busnr)
    		return;
    
    	child = pci_find_bus(pci_domain_nr(bus), busnr);
    	BUG_ON(!child);
    
    	if (list_empty(&child->devices))
    		pci_remove_bus(child);
    }
    
    static int virtfn_add(struct pci_dev *dev, int id, int reset)
    {
    	int i;
    	int rc;
    	u64 size;
    	char buf[VIRTFN_ID_LEN];
    	struct pci_dev *virtfn;
    	struct resource *res;
    	struct pci_sriov *iov = dev->sriov;
    
    	virtfn = alloc_pci_dev();
    	if (!virtfn)
    		return -ENOMEM;
    
    	mutex_lock(&iov->dev->sriov->lock);
    	virtfn->bus = virtfn_add_bus(dev->bus, virtfn_bus(dev, id));
    	if (!virtfn->bus) {
    		kfree(virtfn);
    		mutex_unlock(&iov->dev->sriov->lock);
    		return -ENOMEM;
    	}
    	virtfn->devfn = virtfn_devfn(dev, id);
    	virtfn->vendor = dev->vendor;
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_VF_DID, &virtfn->device);
    	pci_setup_device(virtfn);
    	virtfn->dev.parent = dev->dev.parent;
    
    	for (i = 0; i < PCI_SRIOV_NUM_BARS; i++) {
    		res = dev->resource + PCI_IOV_RESOURCES + i;
    		if (!res->parent)
    			continue;
    		virtfn->resource[i].name = pci_name(virtfn);
    		virtfn->resource[i].flags = res->flags;
    		size = resource_size(res);
    		do_div(size, iov->total_VFs);
    		virtfn->resource[i].start = res->start + size * id;
    		virtfn->resource[i].end = virtfn->resource[i].start + size - 1;
    		rc = request_resource(res, &virtfn->resource[i]);
    		BUG_ON(rc);
    	}
    
    	if (reset)
    		__pci_reset_function(virtfn);
    
    	pci_device_add(virtfn, virtfn->bus);
    	mutex_unlock(&iov->dev->sriov->lock);
    
    	virtfn->physfn = pci_dev_get(dev);
    	virtfn->is_virtfn = 1;
    
    	rc = pci_bus_add_device(virtfn);
    	sprintf(buf, "virtfn%u", id);
    	rc = sysfs_create_link(&dev->dev.kobj, &virtfn->dev.kobj, buf);
    	if (rc)
    		goto failed1;
    	rc = sysfs_create_link(&virtfn->dev.kobj, &dev->dev.kobj, "physfn");
    	if (rc)
    		goto failed2;
    
    	kobject_uevent(&virtfn->dev.kobj, KOBJ_CHANGE);
    
    	return 0;
    
    failed2:
    	sysfs_remove_link(&dev->dev.kobj, buf);
    failed1:
    	pci_dev_put(dev);
    	mutex_lock(&iov->dev->sriov->lock);
    	pci_stop_and_remove_bus_device(virtfn);
    	virtfn_remove_bus(dev->bus, virtfn_bus(dev, id));
    	mutex_unlock(&iov->dev->sriov->lock);
    
    	return rc;
    }
    
    static void virtfn_remove(struct pci_dev *dev, int id, int reset)
    {
    	char buf[VIRTFN_ID_LEN];
    	struct pci_bus *bus;
    	struct pci_dev *virtfn;
    	struct pci_sriov *iov = dev->sriov;
    
    	bus = pci_find_bus(pci_domain_nr(dev->bus), virtfn_bus(dev, id));
    	if (!bus)
    		return;
    
    	virtfn = pci_get_slot(bus, virtfn_devfn(dev, id));
    	if (!virtfn)
    		return;
    
    	pci_dev_put(virtfn);
    
    	if (reset) {
    		device_release_driver(&virtfn->dev);
    		__pci_reset_function(virtfn);
    	}
    
    	sprintf(buf, "virtfn%u", id);
    	sysfs_remove_link(&dev->dev.kobj, buf);
    	/*
    	 * pci_stop_dev() could have been called for this virtfn already,
    	 * so the directory for the virtfn may have been removed before.
    	 * Double check to avoid spurious sysfs warnings.
    	 */
    	if (virtfn->dev.kobj.sd)
    		sysfs_remove_link(&virtfn->dev.kobj, "physfn");
    
    	mutex_lock(&iov->dev->sriov->lock);
    	pci_stop_and_remove_bus_device(virtfn);
    	virtfn_remove_bus(dev->bus, virtfn_bus(dev, id));
    	mutex_unlock(&iov->dev->sriov->lock);
    
    	pci_dev_put(dev);
    }
    
    static int sriov_migration(struct pci_dev *dev)
    {
    	u16 status;
    	struct pci_sriov *iov = dev->sriov;
    
    	if (!iov->num_VFs)
    		return 0;
    
    	if (!(iov->cap & PCI_SRIOV_CAP_VFM))
    		return 0;
    
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_STATUS, &status);
    	if (!(status & PCI_SRIOV_STATUS_VFM))
    		return 0;
    
    	schedule_work(&iov->mtask);
    
    	return 1;
    }
    
    static void sriov_migration_task(struct work_struct *work)
    {
    	int i;
    	u8 state;
    	u16 status;
    	struct pci_sriov *iov = container_of(work, struct pci_sriov, mtask);
    
    	for (i = iov->initial_VFs; i < iov->num_VFs; i++) {
    		state = readb(iov->mstate + i);
    		if (state == PCI_SRIOV_VFM_MI) {
    			writeb(PCI_SRIOV_VFM_AV, iov->mstate + i);
    			state = readb(iov->mstate + i);
    			if (state == PCI_SRIOV_VFM_AV)
    				virtfn_add(iov->self, i, 1);
    		} else if (state == PCI_SRIOV_VFM_MO) {
    			virtfn_remove(iov->self, i, 1);
    			writeb(PCI_SRIOV_VFM_UA, iov->mstate + i);
    			state = readb(iov->mstate + i);
    			if (state == PCI_SRIOV_VFM_AV)
    				virtfn_add(iov->self, i, 0);
    		}
    	}
    
    	pci_read_config_word(iov->self, iov->pos + PCI_SRIOV_STATUS, &status);
    	status &= ~PCI_SRIOV_STATUS_VFM;
    	pci_write_config_word(iov->self, iov->pos + PCI_SRIOV_STATUS, status);
    }
    
    static int sriov_enable_migration(struct pci_dev *dev, int nr_virtfn)
    {
    	int bir;
    	u32 table;
    	resource_size_t pa;
    	struct pci_sriov *iov = dev->sriov;
    
    	if (nr_virtfn <= iov->initial_VFs)
    		return 0;
    
    	pci_read_config_dword(dev, iov->pos + PCI_SRIOV_VFM, &table);
    	bir = PCI_SRIOV_VFM_BIR(table);
    	if (bir > PCI_STD_RESOURCE_END)
    		return -EIO;
    
    	table = PCI_SRIOV_VFM_OFFSET(table);
    	if (table + nr_virtfn > pci_resource_len(dev, bir))
    		return -EIO;
    
    	pa = pci_resource_start(dev, bir) + table;
    	iov->mstate = ioremap(pa, nr_virtfn);
    	if (!iov->mstate)
    		return -ENOMEM;
    
    	INIT_WORK(&iov->mtask, sriov_migration_task);
    
    	iov->ctrl |= PCI_SRIOV_CTRL_VFM | PCI_SRIOV_CTRL_INTR;
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    
    	return 0;
    }
    
    static void sriov_disable_migration(struct pci_dev *dev)
    {
    	struct pci_sriov *iov = dev->sriov;
    
    	iov->ctrl &= ~(PCI_SRIOV_CTRL_VFM | PCI_SRIOV_CTRL_INTR);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    
    	cancel_work_sync(&iov->mtask);
    	iounmap(iov->mstate);
    }
    
    static int sriov_enable(struct pci_dev *dev, int nr_virtfn)
    {
    	int rc;
    	int i, j;
    	int nres;
    	u16 offset, stride, initial;
    	struct resource *res;
    	struct pci_dev *pdev;
    	struct pci_sriov *iov = dev->sriov;
    	int bars = 0;
    
    	if (!nr_virtfn)
    		return 0;
    
    	if (iov->num_VFs)
    		return -EINVAL;
    
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_INITIAL_VF, &initial);
    	if (initial > iov->total_VFs ||
    	    (!(iov->cap & PCI_SRIOV_CAP_VFM) && (initial != iov->total_VFs)))
    		return -EIO;
    
    	if (nr_virtfn < 0 || nr_virtfn > iov->total_VFs ||
    	    (!(iov->cap & PCI_SRIOV_CAP_VFM) && (nr_virtfn > initial)))
    		return -EINVAL;
    
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_NUM_VF, nr_virtfn);
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_VF_OFFSET, &offset);
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_VF_STRIDE, &stride);
    	if (!offset || (nr_virtfn > 1 && !stride))
    		return -EIO;
    
    	nres = 0;
    	for (i = 0; i < PCI_SRIOV_NUM_BARS; i++) {
    		bars |= (1 << (i + PCI_IOV_RESOURCES));
    		res = dev->resource + PCI_IOV_RESOURCES + i;
    		if (res->parent)
    			nres++;
    	}
    	if (nres != iov->nres) {
    		dev_err(&dev->dev, "not enough MMIO resources for SR-IOV\n");
    		return -ENOMEM;
    	}
    
    	iov->offset = offset;
    	iov->stride = stride;
    
    	if (virtfn_bus(dev, nr_virtfn - 1) > dev->bus->busn_res.end) {
    		dev_err(&dev->dev, "SR-IOV: bus number out of range\n");
    		return -ENOMEM;
    	}
    
    	if (pci_enable_resources(dev, bars)) {
    		dev_err(&dev->dev, "SR-IOV: IOV BARS not allocated\n");
    		return -ENOMEM;
    	}
    
    	if (iov->link != dev->devfn) {
    		pdev = pci_get_slot(dev->bus, iov->link);
    		if (!pdev)
    			return -ENODEV;
    
    		pci_dev_put(pdev);
    
    		if (!pdev->is_physfn)
    			return -ENODEV;
    
    		rc = sysfs_create_link(&dev->dev.kobj,
    					&pdev->dev.kobj, "dep_link");
    		if (rc)
    			return rc;
    	}
    
    	iov->ctrl |= PCI_SRIOV_CTRL_VFE | PCI_SRIOV_CTRL_MSE;
    	pci_cfg_access_lock(dev);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    	msleep(100);
    	pci_cfg_access_unlock(dev);
    
    	iov->initial_VFs = initial;
    	if (nr_virtfn < initial)
    		initial = nr_virtfn;
    
    	for (i = 0; i < initial; i++) {
    		rc = virtfn_add(dev, i, 0);
    		if (rc)
    			goto failed;
    	}
    
    	if (iov->cap & PCI_SRIOV_CAP_VFM) {
    		rc = sriov_enable_migration(dev, nr_virtfn);
    		if (rc)
    			goto failed;
    	}
    
    	kobject_uevent(&dev->dev.kobj, KOBJ_CHANGE);
    	iov->num_VFs = nr_virtfn;
    
    	return 0;
    
    failed:
    	for (j = 0; j < i; j++)
    		virtfn_remove(dev, j, 0);
    
    	iov->ctrl &= ~(PCI_SRIOV_CTRL_VFE | PCI_SRIOV_CTRL_MSE);
    	pci_cfg_access_lock(dev);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    	ssleep(1);
    	pci_cfg_access_unlock(dev);
    
    	if (iov->link != dev->devfn)
    		sysfs_remove_link(&dev->dev.kobj, "dep_link");
    
    	return rc;
    }
    
    static void sriov_disable(struct pci_dev *dev)
    {
    	int i;
    	struct pci_sriov *iov = dev->sriov;
    
    	if (!iov->num_VFs)
    		return;
    
    	if (iov->cap & PCI_SRIOV_CAP_VFM)
    		sriov_disable_migration(dev);
    
    	for (i = 0; i < iov->num_VFs; i++)
    		virtfn_remove(dev, i, 0);
    
    	iov->ctrl &= ~(PCI_SRIOV_CTRL_VFE | PCI_SRIOV_CTRL_MSE);
    	pci_cfg_access_lock(dev);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    	ssleep(1);
    	pci_cfg_access_unlock(dev);
    
    	if (iov->link != dev->devfn)
    		sysfs_remove_link(&dev->dev.kobj, "dep_link");
    
    	iov->num_VFs = 0;
    }
    
    static int sriov_init(struct pci_dev *dev, int pos)
    {
    	int i;
    	int rc;
    	int nres;
    	u32 pgsz;
    	u16 ctrl, total, offset, stride;
    	struct pci_sriov *iov;
    	struct resource *res;
    	struct pci_dev *pdev;
    
    	if (pci_pcie_type(dev) != PCI_EXP_TYPE_RC_END &&
    	    pci_pcie_type(dev) != PCI_EXP_TYPE_ENDPOINT)
    		return -ENODEV;
    
    	pci_read_config_word(dev, pos + PCI_SRIOV_CTRL, &ctrl);
    	if (ctrl & PCI_SRIOV_CTRL_VFE) {
    		pci_write_config_word(dev, pos + PCI_SRIOV_CTRL, 0);
    		ssleep(1);
    	}
    
    	pci_read_config_word(dev, pos + PCI_SRIOV_TOTAL_VF, &total);
    	if (!total)
    		return 0;
    
    	ctrl = 0;
    	list_for_each_entry(pdev, &dev->bus->devices, bus_list)
    		if (pdev->is_physfn)
    			goto found;
    
    	pdev = NULL;
    	if (pci_ari_enabled(dev->bus))
    		ctrl |= PCI_SRIOV_CTRL_ARI;
    
    found:
    	pci_write_config_word(dev, pos + PCI_SRIOV_CTRL, ctrl);
    	pci_read_config_word(dev, pos + PCI_SRIOV_VF_OFFSET, &offset);
    	pci_read_config_word(dev, pos + PCI_SRIOV_VF_STRIDE, &stride);
    	if (!offset || (total > 1 && !stride))
    		return -EIO;
    
    	pci_read_config_dword(dev, pos + PCI_SRIOV_SUP_PGSIZE, &pgsz);
    	i = PAGE_SHIFT > 12 ? PAGE_SHIFT - 12 : 0;
    	pgsz &= ~((1 << i) - 1);
    	if (!pgsz)
    		return -EIO;
    
    	pgsz &= ~(pgsz - 1);
    	pci_write_config_dword(dev, pos + PCI_SRIOV_SYS_PGSIZE, pgsz);
    
    	nres = 0;
    	for (i = 0; i < PCI_SRIOV_NUM_BARS; i++) {
    		res = dev->resource + PCI_IOV_RESOURCES + i;
    		i += __pci_read_base(dev, pci_bar_unknown, res,
    				     pos + PCI_SRIOV_BAR + i * 4);
    		if (!res->flags)
    			continue;
    		if (resource_size(res) & (PAGE_SIZE - 1)) {
    			rc = -EIO;
    			goto failed;
    		}
    		res->end = res->start + resource_size(res) * total - 1;
    		nres++;
    	}
    
    	iov = kzalloc(sizeof(*iov), GFP_KERNEL);
    	if (!iov) {
    		rc = -ENOMEM;
    		goto failed;
    	}
    
    	iov->pos = pos;
    	iov->nres = nres;
    	iov->ctrl = ctrl;
    	iov->total_VFs = total;
    	iov->offset = offset;
    	iov->stride = stride;
    	iov->pgsz = pgsz;
    	iov->self = dev;
    	pci_read_config_dword(dev, pos + PCI_SRIOV_CAP, &iov->cap);
    	pci_read_config_byte(dev, pos + PCI_SRIOV_FUNC_LINK, &iov->link);
    	if (pci_pcie_type(dev) == PCI_EXP_TYPE_RC_END)
    		iov->link = PCI_DEVFN(PCI_SLOT(dev->devfn), iov->link);
    
    	if (pdev)
    		iov->dev = pci_dev_get(pdev);
    	else
    		iov->dev = dev;
    
    	mutex_init(&iov->lock);
    
    	dev->sriov = iov;
    	dev->is_physfn = 1;
    
    	return 0;
    
    failed:
    	for (i = 0; i < PCI_SRIOV_NUM_BARS; i++) {
    		res = dev->resource + PCI_IOV_RESOURCES + i;
    		res->flags = 0;
    	}
    
    	return rc;
    }
    
    static void sriov_release(struct pci_dev *dev)
    {
    	BUG_ON(dev->sriov->num_VFs);
    
    	if (dev != dev->sriov->dev)
    		pci_dev_put(dev->sriov->dev);
    
    	mutex_destroy(&dev->sriov->lock);
    
    	kfree(dev->sriov);
    	dev->sriov = NULL;
    }
    
    static void sriov_restore_state(struct pci_dev *dev)
    {
    	int i;
    	u16 ctrl;
    	struct pci_sriov *iov = dev->sriov;
    
    	pci_read_config_word(dev, iov->pos + PCI_SRIOV_CTRL, &ctrl);
    	if (ctrl & PCI_SRIOV_CTRL_VFE)
    		return;
    
    	for (i = PCI_IOV_RESOURCES; i <= PCI_IOV_RESOURCE_END; i++)
    		pci_update_resource(dev, i);
    
    	pci_write_config_dword(dev, iov->pos + PCI_SRIOV_SYS_PGSIZE, iov->pgsz);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_NUM_VF, iov->num_VFs);
    	pci_write_config_word(dev, iov->pos + PCI_SRIOV_CTRL, iov->ctrl);
    	if (iov->ctrl & PCI_SRIOV_CTRL_VFE)
    		msleep(100);
    }
    
    /**
     * pci_iov_init - initialize the IOV capability
     * @dev: the PCI device
     *
     * Returns 0 on success, or negative on failure.
     */
    int pci_iov_init(struct pci_dev *dev)
    {
    	int pos;
    
    	if (!pci_is_pcie(dev))
    		return -ENODEV;
    
    	pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_SRIOV);
    	if (pos)
    		return sriov_init(dev, pos);
    
    	return -ENODEV;
    }
    
    /**
     * pci_iov_release - release resources used by the IOV capability
     * @dev: the PCI device
     */
    void pci_iov_release(struct pci_dev *dev)
    {
    	if (dev->is_physfn)
    		sriov_release(dev);
    }
    
    /**
     * pci_iov_resource_bar - get position of the SR-IOV BAR
     * @dev: the PCI device
     * @resno: the resource number
     * @type: the BAR type to be filled in
     *
     * Returns position of the BAR encapsulated in the SR-IOV capability.
     */
    int pci_iov_resource_bar(struct pci_dev *dev, int resno,
    			 enum pci_bar_type *type)
    {
    	if (resno < PCI_IOV_RESOURCES || resno > PCI_IOV_RESOURCE_END)
    		return 0;
    
    	BUG_ON(!dev->is_physfn);
    
    	*type = pci_bar_unknown;
    
    	return dev->sriov->pos + PCI_SRIOV_BAR +
    		4 * (resno - PCI_IOV_RESOURCES);
    }
    
    /**
     * pci_sriov_resource_alignment - get resource alignment for VF BAR
     * @dev: the PCI device
     * @resno: the resource number
     *
     * Returns the alignment of the VF BAR found in the SR-IOV capability.
     * This is not the same as the resource size which is defined as
     * the VF BAR size multiplied by the number of VFs.  The alignment
     * is just the VF BAR size.
     */
    resource_size_t pci_sriov_resource_alignment(struct pci_dev *dev, int resno)
    {
    	struct resource tmp;
    	enum pci_bar_type type;
    	int reg = pci_iov_resource_bar(dev, resno, &type);
    	
    	if (!reg)
    		return 0;
    
    	 __pci_read_base(dev, type, &tmp, reg);
    	return resource_alignment(&tmp);
    }
    
    /**
     * pci_restore_iov_state - restore the state of the IOV capability
     * @dev: the PCI device
     */
    void pci_restore_iov_state(struct pci_dev *dev)
    {
    	if (dev->is_physfn)
    		sriov_restore_state(dev);
    }
    
    /**
     * pci_iov_bus_range - find bus range used by Virtual Function
     * @bus: the PCI bus
     *
     * Returns max number of buses (exclude current one) used by Virtual
     * Functions.
     */
    int pci_iov_bus_range(struct pci_bus *bus)
    {
    	int max = 0;
    	u8 busnr;
    	struct pci_dev *dev;
    
    	list_for_each_entry(dev, &bus->devices, bus_list) {
    		if (!dev->is_physfn)
    			continue;
    		busnr = virtfn_bus(dev, dev->sriov->total_VFs - 1);
    		if (busnr > max)
    			max = busnr;
    	}
    
    	return max ? max - bus->number : 0;
    }
    
    /**
     * pci_enable_sriov - enable the SR-IOV capability
     * @dev: the PCI device
     * @nr_virtfn: number of virtual functions to enable
     *
     * Returns 0 on success, or negative on failure.
     */
    int pci_enable_sriov(struct pci_dev *dev, int nr_virtfn)
    {
    	might_sleep();
    
    	if (!dev->is_physfn)
    		return -ENODEV;
    
    	return sriov_enable(dev, nr_virtfn);
    }
    EXPORT_SYMBOL_GPL(pci_enable_sriov);
    
    /**
     * pci_disable_sriov - disable the SR-IOV capability
     * @dev: the PCI device
     */
    void pci_disable_sriov(struct pci_dev *dev)
    {
    	might_sleep();
    
    	if (!dev->is_physfn)
    		return;
    
    	sriov_disable(dev);
    }
    EXPORT_SYMBOL_GPL(pci_disable_sriov);
    
    /**
     * pci_sriov_migration - notify SR-IOV core of Virtual Function Migration
     * @dev: the PCI device
     *
     * Returns IRQ_HANDLED if the IRQ is handled, or IRQ_NONE if not.
     *
     * Physical Function driver is responsible to register IRQ handler using
     * VF Migration Interrupt Message Number, and call this function when the
     * interrupt is generated by the hardware.
     */
    irqreturn_t pci_sriov_migration(struct pci_dev *dev)
    {
    	if (!dev->is_physfn)
    		return IRQ_NONE;
    
    	return sriov_migration(dev) ? IRQ_HANDLED : IRQ_NONE;
    }
    EXPORT_SYMBOL_GPL(pci_sriov_migration);
    
    /**
     * pci_num_vf - return number of VFs associated with a PF device_release_driver
     * @dev: the PCI device
     *
     * Returns number of VFs, or 0 if SR-IOV is not enabled.
     */
    int pci_num_vf(struct pci_dev *dev)
    {
    	if (!dev->is_physfn)
    		return 0;
    
    	return dev->sriov->num_VFs;
    }
    EXPORT_SYMBOL_GPL(pci_num_vf);
    
    /**
     * pci_sriov_set_totalvfs -- reduce the TotalVFs available
     * @dev: the PCI PF device
     * numvfs: number that should be used for TotalVFs supported
     *
     * Should be called from PF driver's probe routine with
     * device's mutex held.
     *
     * Returns 0 if PF is an SRIOV-capable device and
     * value of numvfs valid. If not a PF with VFS, return -EINVAL;
     * if VFs already enabled, return -EBUSY.
     */
    int pci_sriov_set_totalvfs(struct pci_dev *dev, u16 numvfs)
    {
    	if (!dev->is_physfn || (numvfs > dev->sriov->total_VFs))
    		return -EINVAL;
    
    	/* Shouldn't change if VFs already enabled */
    	if (dev->sriov->ctrl & PCI_SRIOV_CTRL_VFE)
    		return -EBUSY;
    	else
    		dev->sriov->driver_max_VFs = numvfs;
    
    	return 0;
    }
    EXPORT_SYMBOL_GPL(pci_sriov_set_totalvfs);
    
    /**
     * pci_sriov_get_totalvfs -- get total VFs supported on this devic3
     * @dev: the PCI PF device
     *
     * For a PCIe device with SRIOV support, return the PCIe
     * SRIOV capability value of TotalVFs or the value of driver_max_VFs
     * if the driver reduced it.  Otherwise, -EINVAL.
     */
    int pci_sriov_get_totalvfs(struct pci_dev *dev)
    {
    	if (!dev->is_physfn)
    		return -EINVAL;
    
    	if (dev->sriov->driver_max_VFs)
    		return dev->sriov->driver_max_VFs;
    
    	return dev->sriov->total_VFs;
    }
    EXPORT_SYMBOL_GPL(pci_sriov_get_totalvfs);