From: Roland Hieber <rhi@pengutronix.de>
To: barebox@lists.infradead.org
Cc: Roland Hieber <rhi@pengutronix.de>
Subject: [PATCH 2/4] doc: dt-bindings: improve docs for barebox 'partuuid' property
Date: Tue, 8 Aug 2023 11:26:15 +0200 [thread overview]
Message-ID: <20230808092617.2037996-2-rhi@pengutronix.de> (raw)
In-Reply-To: <20230808092617.2037996-1-rhi@pengutronix.de>
Explain what the partuuid is, and make the lists valid reStructuredText
syntax.
Signed-off-by: Roland Hieber <rhi@pengutronix.de>
---
.../devicetree/bindings/mtd/partition.rst | 17 +++++++++++++----
1 file changed, 13 insertions(+), 4 deletions(-)
diff --git a/Documentation/devicetree/bindings/mtd/partition.rst b/Documentation/devicetree/bindings/mtd/partition.rst
index 627b59eda04b..0f64dee3c3b3 100644
--- a/Documentation/devicetree/bindings/mtd/partition.rst
+++ b/Documentation/devicetree/bindings/mtd/partition.rst
@@ -4,13 +4,22 @@ Representing flash partitions in devicetree
In addition to the upstream binding, another property is added:
Optional properties:
-- ``partuuid`` : The global partition UUID for this partition.
+
+* ``partuuid``: The global partition UUID for this partition.
+ For GPT partitions, the partuuid is the 16-byte GPT Partition UUID (e.g.
+ ``de6f4f5c-c055-4374-09f7-8c6821dfb60e``).
+ For MBR partitions, the partuuid is the 4-byte disk identifier
+ followed by a dash and the partition number (starting with 1, e.g.
+ ``c9178f9d-01``).
+
+ The partuuid is case-insensitive.
Additionally, barebox also supports partitioning the eMMC boot partitions if
the partition table node is named appropriately:
-- ``partitions`` : user partition
-- ``boot0-partitions`` : boot0 partition
-- ``boot1-partitions`` : boot1 partition
+
+* ``partitions`` : user partition
+* ``boot0-partitions`` : boot0 partition
+* ``boot1-partitions`` : boot1 partition
Examples:
--
2.39.2
next prev parent reply other threads:[~2023-08-08 9:27 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-08-08 9:26 [PATCH 1/4] doc: dt-bindings: barebox,environment: fix typo Roland Hieber
2023-08-08 9:26 ` Roland Hieber [this message]
2023-08-08 9:26 ` [PATCH 3/4] doc: user: state: update note about redefining existing partitions Roland Hieber
2023-08-08 9:26 ` [PATCH 4/4] doc: user: state: document backend references using GPT/MBR partitions Roland Hieber
2023-08-08 9:37 ` [PATCH 1/4] doc: dt-bindings: barebox,environment: fix typo Ahmad Fatoum
2023-08-09 5:40 ` Sascha Hauer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230808092617.2037996-2-rhi@pengutronix.de \
--to=rhi@pengutronix.de \
--cc=barebox@lists.infradead.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox