| .. SPDX-License-Identifier: GPL-2.0+: |
| |
| part command |
| =============== |
| |
| Synopis |
| ------- |
| |
| :: |
| |
| 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 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' commnad sets an environment variable to the start of the partition (in blocks), |
| part can be either partition number 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 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 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 partition number value into |
| |
| 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 |
| |
| Return value |
| ------------ |
| |
| The return value $? is set to 0 (true) if the command succededd. If an |
| error occurs, the return value $? is set to 1 (false). |