Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752562AbaG1NEV (ORCPT ); Mon, 28 Jul 2014 09:04:21 -0400 Received: from smtp.citrix.com ([66.165.176.89]:18198 "EHLO SMTP.CITRIX.COM" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751802AbaG1NEU (ORCPT ); Mon, 28 Jul 2014 09:04:20 -0400 X-IronPort-AV: E=Sophos;i="5.01,749,1400025600"; d="scan'208";a="156358718" Message-ID: <53D64A52.7030705@citrix.com> Date: Mon, 28 Jul 2014 14:04:18 +0100 From: David Vrabel User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Icedove/24.5.0 MIME-Version: 1.0 To: Konrad Rzeszutek Wilk , , , , Subject: Re: [PATCH v5 1/6] xen-pciback: Document the various parameters and attributes in SysFS References: <1405354736-7358-1-git-send-email-konrad.wilk@oracle.com> <1405354736-7358-2-git-send-email-konrad.wilk@oracle.com> In-Reply-To: <1405354736-7358-2-git-send-email-konrad.wilk@oracle.com> Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: 7bit X-Originating-IP: [10.80.2.76] X-DLP: MIA1 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 14/07/14 17:18, Konrad Rzeszutek Wilk wrote: > Which hadn't been done with the initial commit. > > Signed-off-by: Konrad Rzeszutek Wilk > --- > v2: Dropped the parameters and one that is unlikeable. > --- > Documentation/ABI/testing/sysfs-driver-pciback | 25 +++++++++++++++++++++++++ > 1 file changed, 25 insertions(+) > 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..cdc8340 > --- /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@lists.xenproject.org > +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: "...write and read the PCI device's configuration space." > + 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@lists.xenproject.org > +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. That's not very nice sysfs file. This sort of thing ought to be in debugfs. Perhaps we shouldn't document it for now and try to move it to debugfs later? David -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/