"Das U-Boot" Source Tree
doc: cmd: gpt: add information on type partition
Add information on type partition, copied from README.gpt.
I also correct issue for gpt_parts variable and add example of
"gpt read" usage.
Signed-off-by: Patrick Delaunay <patrick.delaunay@foss.st.com>
Reviewed-by: Patrice Chotard <patrice.chotard@foss.st.com>
authored by
Patrick Delaunay
and committed by
Tom Rini
a3a5179b
73d5a68f
+84
-9
+84
-9
doc/usage/cmd/gpt.rst
+84
-9
doc/usage/cmd/gpt.rst
···
54
54
55
55
* name=<NAME> - The partition name, required
56
56
* start=<BYTES> - The partition start offset in bytes, required
57
-
* size=<BYTES> - The partition size in bytes or "-" to expand it to the whole free area
57
+
* size=<BYTES> - The partition size in bytes or "-" for the last partition to expand it to the whole free area
58
58
* bootable - Set the legacy bootable flag
59
59
* uuid=<UUID> - The partition UUID, optional if CONFIG_RANDOM_UUID=y is enabled
60
60
* type=<UUID> - The partition type GUID, requires CONFIG_PARTITION_TYPE_GUID=y
···
62
62
63
63
If 'uuid' is not specified, but CONFIG_RANDOM_UUID is enabled, a random UUID
64
64
will be generated for the partition
65
+
66
+
If 'type' is not specified or without CONFIG_PARTITION_TYPE_GUID=y,
67
+
the used partition type GUID is PARTITION_BASIC_DATA_GUID.
68
+
69
+
Some strings can be also used at the place of the known partition type GUID:
70
+
* "mbr" = LEGACY_MBR_PARTITION_GUID (024DEE41-33E7-11D3-9D69-0008C781F39F)
71
+
* "msft" = PARTITION_MSFT_RESERVED_GUID (E3C9E316-0B5C-4DB8-817D-F92DF00215AE)
72
+
* "data" = PARTITION_BASIC_DATA_GUID (EBD0A0A2-B9E5-4433-87C0-68B6B72699C7)
73
+
* "linux" = PARTITION_LINUX_FILE_SYSTEM_DATA_GUID (0FC63DAF-8483-4772-8E79-3D69D8477DE4)
74
+
* "raid" = PARTITION_LINUX_RAID_GUID (A19D880F-05FC-4D3B-A006-743F0F84911E)
75
+
* "swap" = PARTITION_LINUX_SWAP_GUID (0657FD6D-A4AB-43C4-84E5-0933C84B4F4F)
76
+
* "lvm" = PARTITION_LINUX_LVM_GUID (E6D6D379-F507-44C2-A23C-238F2A3DF928)
77
+
* "u-boot-env" = PARTITION_U_BOOT_ENVIRONMENT(3DE21764-95BD-54BD-A5C3-4ABE786F38A8)
78
+
* "system" = PARTITION_SYSTEM_GUID (C12A7328-F81F-11D2-BA4B-00A0C93EC93B)
79
+
80
+
The GPT partitions layout and associated 'type' are also printed with the
81
+
:doc:`part command <part>` command by typing "part list".
65
82
66
83
gpt enumerate
67
84
~~~~~~~~~~~~~
···
162
179
163
180
Create 6 partitions on a disk::
164
181
165
-
=> setenv gpt_parts 'uuid_disk=bec9fc2a-86c1-483d-8a0e-0109732277d7;
166
-
name=boot,start=4M,size=128M,bootable,type=ebd0a0a2-b9e5-4433-87c0-68b6b72699c7,
167
-
name=rootfs,size=3072M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;
168
-
name=system-data,size=512M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;
169
-
name=[ext],size=-,type=0fc63daf-8483-4772-8e79-3d69d8477de4;
170
-
name=user,size=-,type=0fc63daf-8483-4772-8e79-3d69d8477de4;
171
-
name=modules,size=100M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;
172
-
name=ramdisk,size=8M,type=0fc63daf-8483-4772-8e79-3d69d8477de4
182
+
=> setenv gpt_parts 'uuid_disk=bec9fc2a-86c1-483d-8a0e-0109732277d7;\
183
+
name=boot,start=4M,size=128M,bootable,type=ebd0a0a2-b9e5-4433-87c0-68b6b72699c7;\
184
+
name=rootfs,size=3072M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;\
185
+
name=system-data,size=512M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;\
186
+
name=user,size=512M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;\
187
+
name=modules,size=100M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;\
188
+
name=ramdisk,size=8M,type=0fc63daf-8483-4772-8e79-3d69d8477de4;\
189
+
name=[ext],size=-,type=0fc63daf-8483-4772-8e79-3d69d8477de4'
173
190
=> gpt write mmc 0 $gpt_parts
174
191
192
+
Last partition "[ext]" with '-' is extended up to the end of the disk
175
193
176
194
Verify that the device matches the partition layout described in the variable
177
195
$gpt_parts::
···
228
246
=> gpt setenv mmc 0 boot
229
247
=> echo ${gpt_partition_entry}
230
248
2
249
+
250
+
Other example: a disk with known partition types::
251
+
252
+
=> setenv gpt_parts 'name=u-boot,size=32M,type=data;\
253
+
name=env,size=1M,type=u-boot-env;
254
+
name=ESP,size=128M,type=system;
255
+
name=rootfs,size=3072M,type=linux;
256
+
name=swap,size=100M,type=swap;
257
+
name=user,size=-,type=linux'
258
+
=> gpt write mmc 0 $gpt_parts
259
+
260
+
=> part list mmc 0
261
+
Partition Map for mmc device 0 -- Partition Type: EFI
262
+
Part Start LBA End LBA Name
263
+
Attributes
264
+
Type GUID
265
+
Partition GUID
266
+
1 0x00000022 0x00010021 "u-boot"
267
+
attrs: 0x0000000000000000
268
+
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
269
+
(data)
270
+
guid: 502d48f6-81c0-488f-bdc0-ad602498f3ce
271
+
2 0x00010022 0x00010821 "env"
272
+
attrs: 0x0000000000000000
273
+
type: 3de21764-95bd-54bd-a5c3-4abe786f38a8
274
+
(u-boot-env)
275
+
guid: 9dc62338-459a-485e-bd8f-b3fbf728d9c0
276
+
3 0x00010822 0x00050821 "ESP"
277
+
attrs: 0x0000000000000000
278
+
type: c12a7328-f81f-11d2-ba4b-00a0c93ec93b
279
+
(EFI System Partition)
280
+
guid: 8a3a1168-6af8-4ba7-a95d-9cd0d14e1b3d
281
+
4 0x00050822 0x00650821 "rootfs"
282
+
attrs: 0x0000000000000000
283
+
type: 0fc63daf-8483-4772-8e79-3d69d8477de4
284
+
(linux)
285
+
guid: 411ffebc-8a19-469d-99a9-0982409a6851
286
+
5 0x00650822 0x00682821 "swap"
287
+
attrs: 0x0000000000000000
288
+
type: 0657fd6d-a4ab-43c4-84e5-0933c84b4f4f
289
+
(swap)
290
+
guid: f8ec0410-95ec-4e3e-8b98-fb8cf271a201
291
+
6 0x00682822 0x01dacbde "user"
292
+
attrs: 0x0000000000000000
293
+
type: 0fc63daf-8483-4772-8e79-3d69d8477de4
294
+
(linux)
295
+
guid: c5543e1c-566d-4502-99ad-20545007e673
296
+
297
+
Modifying GPT partition layout from U-Boot::
298
+
299
+
=> gpt read mmc 0 current_partitions
300
+
=> env edit current_partitions
301
+
edit: uuid_disk=[...];name=part1,start=0x4000,size=0x4000,uuid=[...];
302
+
name=part2,start=0xc000,size=0xc000,uuid=[...];[ . . . ]
303
+
304
+
=> gpt write mmc 0 $current_partitions
305
+
=> gpt verify mmc 0 $current_partitions