linux-kernel - Re: [PATCH] Documentation: dt-bindings: Document 'rng-seed' for /chosen

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]

Date:   Thu, 2 Apr 2020 07:35:41 -0600
From:   Rob Herring <robh@...nel.org>
To:     Will Deacon <will@...nel.org>,
        Florian Fainelli <f.fainelli@...il.com>
Cc:     "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        Hsin-Yi Wang <hsinyi@...omium.org>,
        Geert Uytterhoeven <geert+renesas@...der.be>,
        Stephen Boyd <swboyd@...omium.org>,
        "Theodore Ts'o" <tytso@....edu>
Subject: Re: [PATCH] Documentation: dt-bindings: Document 'rng-seed' for /chosen

On Thu, Apr 2, 2020 at 2:13 AM Will Deacon <will@...nel.org> wrote:
>
> Hi Florian,
>
> On Wed, Apr 01, 2020 at 08:36:40PM -0700, Florian Fainelli wrote:
> > The /chosen node can have a 'rng-seed' property read as a u32 quantity
> > which would contain a random number provided by the boot agent. This is
> > useful in configurations where the kernel does not have access to a
> > random number generator.
> >
> > Signed-off-by: Florian Fainelli <f.fainelli@...il.com>
> > ---
> >  Documentation/devicetree/bindings/chosen.txt | 13 +++++++++++++
> >  1 file changed, 13 insertions(+)
>
> Thanks for doing this; I realised it was undocumented the other day when I
> tried to look it up myself.

Already documented here[1]. I've been meaning to delete chosen.txt so
that's a bit more obvious.

I realize it's a bit harder to find what's documented where. Long term
we'd like to generate documentation from the schema and integrate as
part of the spec. Short term, it would be quite trivial to make a 'am
I documented' utility.

Rob

[1] https://github.com/devicetree-org/dt-schema/blob/master/schemas/chosen.yaml