mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2026-06-11 06:06:52 +03:00
703f8c313d
The 'part' command currently allows looking up a partition only by its number or name. Extend the 'number', 'start', and 'size' subcommands to support looking up the partition via its UUID. Unlike names, UUIDs guarantee unique partition identification, avoiding ambiguity. The logic is updated to check if the provided string is a valid UUID before falling back to a name-based search. The help strings for these subcommands are updated accordingly. Signed-off-by: Dario Binacchi <dario.binacchi@amarulasolutions.com> Reviewed-by: Simon Glass <sjg@chromium.org>
239 lines
7.0 KiB
ReStructuredText
239 lines
7.0 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+:
|
|
|
|
.. index::
|
|
single: part (command)
|
|
|
|
part command
|
|
============
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
part uuid <interface> <dev>:<part> [varname]
|
|
part list <interface> <dev> [flags] [varname]
|
|
part start <interface> <dev> <part> <varname>
|
|
part size <interface> <dev> <part> <varname>
|
|
part number <interface> <dev> <part> <varname>
|
|
part name <interface> <dev> <part> <varname>
|
|
part set <interface> <dev> <part> <type>
|
|
part type <interface> <dev>:<part> [varname]
|
|
part types
|
|
|
|
Description
|
|
-----------
|
|
|
|
The `part` command is used to manage disk partition related commands.
|
|
|
|
The 'part uuid' command prints or sets an environment variable to partition UUID
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
varname
|
|
an optional environment variable to store the current partition UUID value into.
|
|
|
|
The 'part list' command prints or sets an environment variable to the list of partitions
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
flags
|
|
-bootable
|
|
lists only bootable partitions
|
|
varname
|
|
an optional environment variable to store the list of partitions value into.
|
|
|
|
The 'part start' command sets an environment variable to the start of the partition (in blocks),
|
|
part can be either partition number, partition UUID or partition name.
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
varname
|
|
a variable to store the current start of the partition value into.
|
|
|
|
The 'part size' command sets an environment variable to the size of the partition (in blocks),
|
|
part can be either partition number, partition UUID or partition name.
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
varname
|
|
a variable to store the current size of the partition value into.
|
|
|
|
The 'part number' command sets an environment variable to the partition number using the partition name,
|
|
part must be specified as partition UUID or partition name.
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition name
|
|
varname
|
|
a variable to store the current partition number value into
|
|
|
|
The 'part name' command sets an environment variable to the partition name using the partition number,
|
|
part must be specified as partition number.
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
varname
|
|
a variable to store the current partition name into
|
|
|
|
The 'part set' command sets the type of a partition. This is useful when
|
|
autodetection fails or does not do the correct thing:
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
type
|
|
partition type to use (see 'part types') to check available types
|
|
|
|
The 'part type' command prints or sets an environment variable to the partition type UUID.
|
|
|
|
interface
|
|
interface for accessing the block device (mmc, sata, scsi, usb, ....)
|
|
dev
|
|
device number
|
|
part
|
|
partition number
|
|
varname
|
|
a variable to store the current partition type UUID value into
|
|
|
|
The 'part types' command list supported partition table types.
|
|
|
|
Examples
|
|
--------
|
|
|
|
::
|
|
|
|
=> host bind 0 ./test_gpt_disk_image.bin
|
|
=> part uuid host 0:1
|
|
24156b69-3378-497f-bb3e-b982223de528
|
|
=> part uuid host 0:1 varname
|
|
=> env print varname
|
|
varname=24156b69-3378-497f-bb3e-b982223de528
|
|
=>
|
|
=> part list host 0
|
|
|
|
Partition Map for HOST device 0 -- Partition Type: EFI
|
|
|
|
Part Start LBA End LBA Name
|
|
Attributes
|
|
Type GUID
|
|
Partition GUID
|
|
1 0x00000800 0x00000fff "second"
|
|
attrs: 0x0000000000000000
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
(data)
|
|
guid: 24156b69-3378-497f-bb3e-b982223de528
|
|
2 0x00001000 0x00001bff "first"
|
|
attrs: 0x0000000000000000
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
(data)
|
|
guid: 5272ee44-29ab-4d46-af6c-4b45ac67d3b7
|
|
=>
|
|
=> part start host 0 2 varname
|
|
=> env print varname
|
|
varname=1000
|
|
=>
|
|
=> part size host 0 2 varname
|
|
=> env print varname
|
|
varname=c00
|
|
=>
|
|
=> part number host 0 2 varname
|
|
=> env print varname
|
|
varname=0x2
|
|
=>
|
|
=> part type host 0:1
|
|
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
=> part type host 0:1 varname
|
|
=> env print varname
|
|
varname=ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
=>
|
|
=> part types
|
|
Supported partition tables: EFI, AMIGA, DOS, ISO, MAC
|
|
|
|
This shows looking at a device with multiple partition tables::
|
|
|
|
=> virtio scan
|
|
=> part list virtio 0
|
|
|
|
Partition Map for VirtIO device 0 -- Partition Type: EFI
|
|
|
|
Part Start LBA End LBA Name
|
|
Attributes
|
|
Type GUID
|
|
Partition GUID
|
|
1 0x00000040 0x0092b093 "ISO9660"
|
|
attrs: 0x1000000000000001
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
guid: a0891d7e-b930-4513-94d8-f629dbd637b2
|
|
2 0x0092b094 0x0092d7e7 "Appended2"
|
|
attrs: 0x0000000000000000
|
|
type: c12a7328-f81f-11d2-ba4b-00a0c93ec93b
|
|
guid: a0891d7e-b930-4513-94db-f629dbd637b2
|
|
3 0x0092d7e8 0x0092da3f "Gap1"
|
|
attrs: 0x1000000000000001
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
guid: a0891d7e-b930-4513-94da-f629dbd637b2
|
|
=> ls virtio 0:3
|
|
=> part types
|
|
Supported partition tables: EFI, DOS, ISO
|
|
=> part set virtio 0 dos
|
|
|
|
Partition Map for VirtIO device 0 -- Partition Type: DOS
|
|
|
|
Part Start Sector Num Sectors UUID Type
|
|
1 1 9624191 00000000-01 ee
|
|
=> part set virtio 0 iso
|
|
|
|
Partition Map for VirtIO device 0 -- Partition Type: ISO
|
|
|
|
Part Start Sect x Size Type
|
|
1 3020 4 512 U-Boot
|
|
2 9613460 10068 512 U-Boot
|
|
=> part set virtio 0 efi
|
|
|
|
Partition Map for VirtIO device 0 -- Partition Type: EFI
|
|
|
|
Part Start LBA End LBA Name
|
|
Attributes
|
|
Type GUID
|
|
Partition GUID
|
|
1 0x00000040 0x0092b093 "ISO9660"
|
|
attrs: 0x1000000000000001
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
guid: a0891d7e-b930-4513-94d8-f629dbd637b2
|
|
2 0x0092b094 0x0092d7e7 "Appended2"
|
|
attrs: 0x0000000000000000
|
|
type: c12a7328-f81f-11d2-ba4b-00a0c93ec93b
|
|
guid: a0891d7e-b930-4513-94db-f629dbd637b2
|
|
3 0x0092d7e8 0x0092da3f "Gap1"
|
|
attrs: 0x1000000000000001
|
|
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
|
|
guid: a0891d7e-b930-4513-94da-f629dbd637b2
|
|
=>
|