Re: [PATCH v4 1/5] xen-pciback: Document the various parameters and attributes in SysFS

From: Konrad Rzeszutek Wilk
Date: Mon Jul 14 2014 - 12:29:14 EST


On Fri, Jul 11, 2014 at 04:46:31PM -0400, Boris Ostrovsky wrote:
> On 07/11/2014 04:08 PM, konrad@xxxxxxxxxx wrote:
> >From: Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> >
> >Which hadn't been done with the initial commit.
> >
> >Signed-off-by: Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> >---
> >v2: Dropped the parameters and one that is unlikeable.
> >---
> > Documentation/ABI/testing/sysfs-driver-pciback | 25 ++++++++++++++++++++++++
> > 1 files changed, 25 insertions(+), 0 deletions(-)
> > create mode 100644 Documentation/ABI/testing/sysfs-driver-pciback
> >
> >diff --git a/Documentation/ABI/testing/sysfs-driver-pciback b/Documentation/ABI/testing/sysfs-driver-pciback
> >new file mode 100644
> >index 0000000..e482240
> >--- /dev/null
> >+++ b/Documentation/ABI/testing/sysfs-driver-pciback
> >@@ -0,0 +1,25 @@
> >+What: /sys/bus/pci/drivers/pciback/quirks
> >+Date: Oct 2011
> >+KernelVersion: 3.1
> >+Contact: xen-devel@xxxxxxxxxxxxxxxxxxxx
> >+Description:
> >+ If the permissive attribute is set, then writing a string in
> >+ the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest
> >+ to write and read from the PCI device. That is Domain:Bus:
> >+ Device.Function-Register:Size:Mask (Domain is optional).
> >+ For example:
> >+ #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
> >+ will allow the guest to read and write to the configuration
> >+ register 0x0E.
> >+
> >+What: /sys/bus/pci/drivers/pciback/irq_handlers
> >+Date: Oct 2011
> >+KernelVersion: 3.1
> >+Contact: xen-devel@xxxxxxxxxxxxxxxxxxxx
> >+Description:
> >+ A list of all of the PCI devices owned by Xen PCI back and
> >+ whether Xen PCI backend will acknowledge the interrupts received
> >+ and the amount of interrupts received. Xen PCI back acknowledges
> >+ said interrupts only when they are level, shared with another
> >+ guest, and enabled by the guest.
>
> There are 4 fields per device. This description misses isr_on.

Grrr. I missed this in my repost. Will fix it to say on the last line:
'guest, whether it will acknowledge interrupts, and enabled by the guest'.

>
> -boris
>
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/