81 lines
2.6 KiB
ReStructuredText
81 lines
2.6 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+
|
|
.. _partitions:
|
|
|
|
Partitions
|
|
==========
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
<command> <interface> [devnum][.hwpartnum][:partnum|#partname]
|
|
|
|
Description
|
|
-----------
|
|
|
|
Many U-Boot commands allow specifying partitions (or whole disks) using a
|
|
generic syntax.
|
|
|
|
interface
|
|
The interface used to access the partition's device, like ``mmc`` or
|
|
``scsi``. For a full list of supported interfaces, consult the
|
|
``if_typename_str`` array in ``drivers/block/blk-uclass.c``
|
|
|
|
devnum
|
|
The device number. This defaults to 0.
|
|
|
|
hwpartnum
|
|
The hardware partition number. All devices have at least one hardware
|
|
partition. On most devices, hardware partition 0 specifies the whole
|
|
device. On eMMC devices, hardware partition 0 is the user partition,
|
|
hardware partitions 1 and 2 are the boot partitions, hardware partition
|
|
3 is the RPMB partition, and further partitions are general-purpose
|
|
user-created partitions. The default hardware partition number is 0.
|
|
|
|
partnum
|
|
The partition number, starting from 1. The partition number 0 specifies
|
|
that the whole device is to be used as one "partition."
|
|
|
|
partname
|
|
The partition name. This is the partition label for GPT partitions. For
|
|
MBR partitions, the following syntax is used::
|
|
|
|
<devtype><devletter><partnum>
|
|
|
|
devtype
|
|
A device type like ``mmcsd`` or ``hd``. See the
|
|
``part_set_generic_name`` function in ``disk/part.c`` for a
|
|
complete list.
|
|
|
|
devletter
|
|
The device number as an offset from ``a``. For example, device
|
|
number 2 would have a device letter of ``c``.
|
|
|
|
partnum
|
|
The partition number. This is the same as above.
|
|
|
|
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 "partition." If none of ``devnum``, ``hwpartnum``,
|
|
``partnum``, or ``partname`` is specified, or only ``-`` is specified, then
|
|
``devnum`` defaults to the value of the ``bootdevice`` environmental variable.
|
|
|
|
Examples
|
|
--------
|
|
|
|
List the root directory contents on MMC device 2, hardware partition 1,
|
|
and partition number 3::
|
|
|
|
ls mmc 2.1:3 /
|
|
|
|
Load ``/kernel.itb`` to address ``0x80000000`` from SCSI device 0, hardware partition
|
|
0, and the partition labeled ``boot``::
|
|
|
|
load scsi #boot 0x80000000 /kernel.itb
|
|
|
|
Print the partition UUID of the SATA device ``$bootdevice``, hardware partition
|
|
0, and partition number 0::
|
|
|
|
part uuid sata -
|