| .. 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 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' 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 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 |
| => |
| |
| 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). |
