Re: [PATCH v10 6/7] PCI: document SR-IOV sysfs entries

Randy Dunlap
2009-03-06T22:33:57Z

Matthew Wilcox wrote:
> Randy, can you wordsmith this one?

I'll try.

> I think I'm starting to understand the difference between physfn and
> dep_link, but an example would definitely help. It may or may not be
> appropriate to put it in.
>
> On Fri, Feb 20, 2009 at 02:54:47PM +0800, Yu Zhao wrote:
>> Signed-off-by: Yu Zhao <yu.zhao@intel.com>
>> ---
>> Documentation/ABI/testing/sysfs-bus-pci | 27 +++++++++++++++++++++++++++
>> 1 files changed, 27 insertions(+), 0 deletions(-)
>>
>> diff --git a/Documentation/ABI/testing/sysfs-bus-pci b/Documentation/ABI/testing/sysfs-bus-pci
>> index ceddcff..84dc100 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-pci
>> +++ b/Documentation/ABI/testing/sysfs-bus-pci
>> @@ -9,3 +9,30 @@ Description:
>> that some devices may have malformatted data. If the
>> underlying VPD has a writable section then the
>> corresponding section of this file will be writable.
>> +
>> +What: /sys/bus/pci/devices/.../virtfn/N
>> +Date: February 2009
>> +Contact: Yu Zhao <yu.zhao@intel.com>
>> +Description:
>> + This symbol link appears when hardware supports SR-IOV

symbolic supports the SR-IOV

>> + capability and Physical Function driver has enabled it.

^the | its | a

>> + The symbol link points to the PCI device sysfs entry of

symbolic

>> + Virtual Function whose index is N (0...MaxVFs-1).

the Virtual Function

>> +
>> +What: /sys/bus/pci/devices/.../virtfn/dep_link
>> +Date: February 2009
>> +Contact: Yu Zhao <yu.zhao@intel.com>
>> +Description:
>> + This symbol link appears when hardware supports SR-IOV

symbolic supports the SR-IOV

>> + capability and Physical Function driver has enabled it,

^its | the | a

>> + and this device has vendor specific dependencies with
>> + others. The symbol link points to the PCI device sysfs

symbolic

>> + entry of Physical Function this device depends on.
>> +
>> +What: /sys/bus/pci/devices/.../physfn
>> +Date: February 2009
>> +Contact: Yu Zhao <yu.zhao@intel.com>
>> +Description:
>> + This symbol link appears when a device is Virtual Function.

symbolic is a Virtual Function.

>> + The symbol link points to the PCI device sysfs entry of

symbolic entry of the

>> + Physical Function this device associates with.