mirror of
				https://github.com/smaeul/u-boot.git
				synced 2025-10-31 12:08:19 +00:00 
			
		
		
		
	%s/Synopis/Synopsis/g Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
		
			
				
	
	
		
			232 lines
		
	
	
		
			6.7 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			232 lines
		
	
	
		
			6.7 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 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).
 |