On 12/31/20 11:48 PM, Sean Anderson wrote:
This documents the new partition names added in the previous commit.
Signed-off-by: Sean Anderson sean.anderson@seco.com
doc/android/fastboot.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+)
diff --git a/doc/android/fastboot.rst b/doc/android/fastboot.rst index 2877c3cbaa..2ca80ae844 100644 --- a/doc/android/fastboot.rst +++ b/doc/android/fastboot.rst @@ -151,6 +151,34 @@ The device index starts from ``a`` and refers to the interface (e.g. USB controller, SD/MMC controller) or disk index. The partition index starts from ``1`` and describes the partition number on the particular device.
+Alternate Partition Names +^^^^^^^^^^^^^^^^^^^^^^^^^
+Partitions may also be specified like::
- devnum.hwpartnum#partname
Thank you for getting this all documented.
Don't we need the interface (mmc), too?
+or like::
- devnum.hwpartnum:partnum
I think this is the wrong place to document how partitions are addressed as it is not Android specific. I would prefer a sub-chapter of doc/usage/.
Cf. https://u-boot.readthedocs.io/en/latest/usage/index.html
Best regards
Heinrich
+Where
- ``devnum`` is the MMC device number. This defaults to 0.
- ``hwpartnum`` is the hardware partition number. This defaults to 0 (the user
- partition on eMMC devices).
- ``partname`` is the partition name on GPT devices. Partitions do not have
- names on MBR devices.
- ``partnum`` is the partition number, starting from 1. The partition number 0
- is special, and specifies that the whole device is to be used as one
- "partition."
+If neither ``partname`` nor ``partnum`` is specified and there is a partition +table, then partition 1 is used. If there is no partition table, then the whole +device is used as one "partion." Examples of alternate partition names include +``0.1``, ``0#boot``, and ``:3``.
Writing Partition Table