2009-03-06 21:16:28

by Matthew Wilcox

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


Randy, can you wordsmith this one?

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 <[email protected]>
> ---
> 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 <[email protected]>
> +Description:
> + This symbol link appears when hardware supports SR-IOV
> + capability and Physical Function driver has enabled it.
> + The symbol link points to the PCI device sysfs entry of
> + Virtual Function whose index is N (0...MaxVFs-1).
> +
> +What: /sys/bus/pci/devices/.../virtfn/dep_link
> +Date: February 2009
> +Contact: Yu Zhao <[email protected]>
> +Description:
> + This symbol link appears when hardware supports SR-IOV
> + capability and Physical Function driver has enabled it,
> + and this device has vendor specific dependencies with
> + others. The symbol link points to the PCI device sysfs
> + entry of Physical Function this device depends on.
> +
> +What: /sys/bus/pci/devices/.../physfn
> +Date: February 2009
> +Contact: Yu Zhao <[email protected]>
> +Description:
> + This symbol link appears when a device is Virtual Function.
> + The symbol link points to the PCI device sysfs entry of
> + Physical Function this device associates with.
> --
> 1.6.1
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-pci" in
> the body of a message to [email protected]
> More majordomo info at http://vger.kernel.org/majordomo-info.html

--
Matthew Wilcox Intel Open Source Technology Centre
"Bill, look, we understand that you're interested in selling us this
operating system, but compare it to ours. We can't possibly take such
a retrograde step."


2009-03-06 22:33:57

by Randy Dunlap

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

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 <[email protected]>
>> ---
>> 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 <[email protected]>
>> +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 <[email protected]>
>> +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 <[email protected]>
>> +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.