linux-kernel - Re: 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: Windows password security audit tool. GUI, reports in PDF.

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

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

On 17/11/2015 23:14, 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?

Would be nice indeed, as it's part of their intended purpose.

For now we have to shoehorn things into linux-only stuff (like initrd)
because well, nobody cares enough about NetBSD to compile U-Boot with
its internal API, so let alone adding custom Haiku code.

And of course, for things linux doesn't care about (like framebuffer
description) then we're stuck trying to guess where it's at and writing
drivers for our bootloader.

So if at least people were considering they aren't the only users of
this, that'd make life better for everyone.

> Perhaps QEMU is the right place to thoroughly describe this and DT and
> sysfs docs can refer to it.

The brilliant idea of FDT was that we could have a canonical source and
blob for it where people could send patches, but of course Linux and BSD
freaks disagreed, so you now find Linux-flavoured DTs for rPi and other
things, as well as BSD versions.

Please, at least get the binding documentation for this unique and
usable for everyone!

François.

--
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/