Skip to content

Commit 1776470

Browse files
committed
chapter2: Clarify that hashed-nodes is only a signer hint
The hashed-nodes property is not itself protected by a hash, so a loader cannot rely on it for validation. Clarify that it serves only as a hint for the signer. Also mention that both hash-nodes and sign-images are not necessarily in sorted order. Signed-off-by: Simon Glass <sjg@chromium.org>
1 parent 1be2a60 commit 1776470

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

source/chapter2-source-file-format.rst

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -471,7 +471,7 @@ key-name-hint
471471
<name>.crt.
472472

473473
sign-images
474-
A list of images to sign, each being a property of the conf
474+
An unsorted list of images to sign, each being a property of the conf
475475
node that contains them. The default is "kernel,fdt" which means that these
476476
two images will be looked up in the config and signed if present. This is
477477
used by mkimage to determine which images to sign.
@@ -482,8 +482,11 @@ value
482482
Actual signature value. This is added by mkimage.
483483

484484
hashed-nodes
485-
A list of nodes which were :index:`hashed <pair: nodes; hashed>` by the
486-
signer. Each is a string - the full path to node. A typical value might be::
485+
An unsorted list of nodes which were :index:`hashed <pair: nodes; hashed>`
486+
by the signer. Each is a string - the full path to node. Since this
487+
property is not itself protected by a hash, it serves only as a hint for
488+
the signer and must not be relied upon by the loader for validation
489+
purposes. A typical value might be::
487490

488491
hashed-nodes = "/", "/configurations/conf-1", "/images/kernel",
489492
"/images/kernel/hash-1", "/images/fdt-1",

0 commit comments

Comments
 (0)