1 .. SPDX-License-Identifier: GPL-2.0
2 .. include:: <isonum.txt>
3 .. include:: ../disclaimer-zh_CN.rst
5 :Original: Documentation/PCI/pci-iov-howto.rst
9 司延腾 Yanteng Si <siyanteng@loongson.cn>
17 ==========================
19 ==========================
21 :版权: |copy| 2009 Intel Corporation
22 :作者: - Yu Zhao <yu.zhao@intel.com>
23 - Donald Dutile <ddutile@redhat.com>
31 单根I/O虚拟化(SR-IOV)是一种PCI Express扩展功能,它使一个物理设备显示为多个
32 虚拟设备。物理设备被称为物理功能(PF),而虚拟设备被称为虚拟功能(VF)。VF的分
33 配可以由PF通过封装在该功能中的寄存器动态控制。默认情况下,该功能未被启用,PF表
34 现为传统的PCIe设备。一旦开启,每个VF的PCI配置空间都可以通过自己的总线、设备和
35 功能编号(路由ID)来访问。而且每个VF也有PCI内存空间,用于映射其寄存器集。VF设
36 备驱动程序对寄存器集进行操作,这样它就可以发挥功能,并作为一个真正的现有PCI设备
43 ------------------------
45 有多种方法可用于SR-IOV的启用。在第一种方法中,设备驱动(PF驱动)将通过SR-IOV
46 核心提供的API控制功能的启用和禁用。如果硬件具有SR-IOV能力,加载其PF驱动器将启
47 用它和与PF相关的所有VF。一些PF驱动需要设置一个模块参数,以确定要启用的VF的数量。
48 在第二种方法中,对sysfs文件sriov_numvfs的写入将启用和禁用与PCIe PF相关的VF。
49 这种方法实现了每个PF的VF启用/禁用值,而第一种方法则适用于同一设备的所有PF。此外,
50 PCI SRIOV核心支持确保启用/禁用操作是有效的,以减少同一检查在多个驱动程序中的重
51 复,例如,如果启用VF,检查numvfs == 0,确保numvfs <= totalvfs。
52 第二种方法是对新的/未来的VF设备的推荐方法。
55 ----------------------
57 在内核中,VF被视为热插拔的PCI设备,所以它们应该能够以与真正的PCI设备相同的方式
58 工作。VF需要的设备驱动与普通PCI设备的驱动相同。
70 int pci_enable_sriov(struct pci_dev *dev, int nr_virtfn);
77 /sys/bus/pci/devices/<DOMAIN:BUS:DEVICE.FUNCTION>/sriov_numvfs
83 void pci_disable_sriov(struct pci_dev *dev);
88 /sys/bus/pci/devices/<DOMAIN:BUS:DEVICE.FUNCTION>/sriov_numvfs
90 要想通过主机上的兼容驱动启用自动探测VF,在启用SR-IOV功能之前运行下面的命令。这
95 /sys/bus/pci/devices/<DOMAIN:BUS:DEVICE.FUNCTION>/sriov_drivers_autoprobe
97 要禁止主机上的兼容驱动自动探测VF,请在启用SR-IOV功能之前运行以下命令。更新这个
102 /sys/bus/pci/devices/<DOMAIN:BUS:DEVICE.FUNCTION>/sriov_drivers_autoprobe
107 下面的代码演示了SR-IOV API的用法
110 static int dev_probe(struct pci_dev *dev, const struct pci_device_id *id)
112 pci_enable_sriov(dev, NR_VIRTFN);
119 static void dev_remove(struct pci_dev *dev)
121 pci_disable_sriov(dev);
126 static int dev_suspend(struct pci_dev *dev, pm_message_t state)
133 static int dev_resume(struct pci_dev *dev)
140 static void dev_shutdown(struct pci_dev *dev)
145 static int dev_sriov_configure(struct pci_dev *dev, int numvfs)
149 pci_enable_sriov(dev, numvfs);
155 pci_disable_sriov(dev);
161 static struct pci_driver dev_driver = {
162 .name = "SR-IOV Physical Function driver",
163 .id_table = dev_id_table,
165 .remove = dev_remove,
166 .suspend = dev_suspend,
167 .resume = dev_resume,
168 .shutdown = dev_shutdown,
169 .sriov_configure = dev_sriov_configure,