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
orscsi
. For a full list of supported interfaces, consult theif_typename_str
array indrivers/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
orhd
. See thepart_set_generic_name
function indisk/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 ofc
. - 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 -