linux-kernel - Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20151118021727.GA14351@GLSMBP.INI.CMU.EDU>
Date:	Tue, 17 Nov 2015 21:17:27 -0500
From:	"Gabriel L. Somlo" <somlo@....edu>
To:	Rob Herring <robh@...nel.org>
Cc:	Paolo Bonzini <pbonzini@...hat.com>,
	Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
	Pawel Moll <pawel.moll@....com>,
	Mark Rutland <mark.rutland@....com>,
	Ian Campbell <ijc+devicetree@...lion.org.uk>,
	Kumar Gala <galak@...eaurora.org>,
	Arnd Bergmann <arnd@...db.de>,
	Laszlo Ersek <lersek@...hat.com>,
	Ralf Baechle <ralf@...ux-mips.org>,
	Russell King <rmk+kernel@....linux.org.uk>,
	Eric Anholt <eric@...olt.net>,
	Hanjun Guo <hanjun.guo@...aro.org>,
	Rafał Miłecki <zajec5@...il.com>,
	Sudeep Holla <sudeep.holla@....com>,
	Andy Gross <agross@...eaurora.org>,
	"linux-api@...r.kernel.org" <linux-api@...r.kernel.org>,
	"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
	"devicetree@...r.kernel.org" <devicetree@...r.kernel.org>,
	Peter Maydell <peter.maydell@...aro.org>,
	"matt.fleming@...el.com" <matt.fleming@...el.com>, mst@...hat.com,
	jordan.l.justen@...el.com, kernelnewbies@...nelnewbies.org,
	QEMU Developers <qemu-devel@...gnu.org>,
	Leif Lindholm <leif.lindholm@...aro.org>,
	Andy Lutomirski <luto@...capital.net>,
	Ard Biesheuvel <ard.biesheuvel@...aro.org>, kraxel@...hat.com,
	stefanha@...il.com
Subject: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for
 fw_cfg ARM bindings

On Tue, Nov 17, 2015 at 04:14:42PM -0600, Rob Herring wrote:
> On Mon, Nov 16, 2015 at 2:38 AM, Paolo Bonzini <pbonzini@...hat.com> wrote:
> >
> >
> > On 15/11/2015 03:07, Rob Herring wrote:
> >> We generally don't want DT docs to depend on other kernel documentation.
> >
> > DT docs do not contain a copy of the data sheets, either.  There is no
> > reason to say how to use the device (and even then, only doing so
> > partially) in the DT docs.
> 
> The difference is datasheets apply to all OS's, kernel documentation
> does not. In theory at least this could be used for other OS's, right?
> 
> Perhaps QEMU is the right place to thoroughly describe this and DT and
> sysfs docs can refer to it.

So, leave only ARM/DT specifc details in 
Documentation/devicetree/bindings/arm/fw-cfg.txt,
and rework the fw_cfg sysfs patch (1/4) to only document
sysfs specific details in
Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg ?

The fw_cfg "datasheet" does exist in QEMU already, so there is
something to point at from either/both of the above.

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