linux-kernel - [PATCH] dt-bindings: chosen: document rng-seed property

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-next>] [day] [month] [year] [list]

Message-Id: <20220627152107.645860-1-Jason@zx2c4.com>
Date:   Mon, 27 Jun 2022 17:21:07 +0200
From:   "Jason A. Donenfeld" <Jason@...c4.com>
To:     krzysztof.kozlowski@...aro.org, robh@...nel.org,
        devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
        Jonathan Neuschäfer <j.neuschaefer@....net>
Cc:     "Jason A. Donenfeld" <Jason@...c4.com>,
        Hsin-Yi Wang <hsinyi@...omium.org>,
        Kees Cook <keescook@...omium.org>,
        Geert Uytterhoeven <geert@...ux-m68k.org>
Subject: [PATCH] dt-bindings: chosen: document rng-seed property

Document the /chosen/rng-seed property, which has existed for quite some
time but without an entry in this file.

Fixes: 428826f5358c ("fdt: add support for rng-seed")
Cc: Hsin-Yi Wang <hsinyi@...omium.org>
Cc: Kees Cook <keescook@...omium.org>
Cc: Rob Herring <robh@...nel.org>
Cc: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
Reported-by: Geert Uytterhoeven <geert@...ux-m68k.org>
Signed-off-by: Jason A. Donenfeld <Jason@...c4.com>
---
 Documentation/devicetree/bindings/chosen.txt | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/Documentation/devicetree/bindings/chosen.txt b/Documentation/devicetree/bindings/chosen.txt
index 1cc3aa10dcb1..49b175e133b2 100644
--- a/Documentation/devicetree/bindings/chosen.txt
+++ b/Documentation/devicetree/bindings/chosen.txt
@@ -7,6 +7,21 @@ arguments. Data in the chosen node does not represent the hardware.
 
 The following properties are recognized:
 
+rng-seed
+--------
+
+This property is used to initialize the kernel's random number generator at
+the earliest possible opportunity, and will be credited if CONFIG_RANDOM_
+TRUST_BOOTLOADER is set. All hardware that has an opportunity to set this
+with high quality randomness is encouraged to do so. It is parsed as a byte
+array, which should be at least 32 bytes long:
+
+/ {
+	chosen {
+		rng-seed = <... random bytes ...>;
+	};
+};
+
 
 kaslr-seed
 -----------
-- 
2.35.1