Blame view
include/part.h
16.1 KB
83d290c56 SPDX: Convert all... |
1 |
/* SPDX-License-Identifier: GPL-2.0+ */ |
012771d88 Initial revision |
2 |
/* |
42dfe7a18 Code cleanup; mak... |
3 |
* (C) Copyright 2000-2004 |
012771d88 Initial revision |
4 |
* Wolfgang Denk, DENX Software Engineering, wd@denx.de. |
012771d88 Initial revision |
5 6 7 |
*/ #ifndef _PART_H #define _PART_H |
735dd97b1 [PATCH 1_4] Merge... |
8 |
|
1a73661bc dm: Add a new hea... |
9 |
#include <blk.h> |
6e5923851 * Cleanup, minor ... |
10 |
#include <ide.h> |
db9b6200a EFI: replace numb... |
11 |
#include <uuid.h> |
09a49930e GPT: read partiti... |
12 |
#include <linux/list.h> |
012771d88 Initial revision |
13 |
|
d96a98045 disk/part.c: Expo... |
14 15 |
struct block_drvr { char *name; |
d96a98045 disk/part.c: Expo... |
16 17 |
int (*select_hwpart)(int dev_num, int hwpart); }; |
0472fbfd3 part/dev_desc: Ad... |
18 19 20 21 |
#define LOG2(x) (((x & 0xaaaaaaaa) ? 1 : 0) + ((x & 0xcccccccc) ? 2 : 0) + \ ((x & 0xf0f0f0f0) ? 4 : 0) + ((x & 0xff00ff00) ? 8 : 0) + \ ((x & 0xffff0000) ? 16 : 0)) #define LOG2_INVALID(type) ((type)((sizeof(type)<<3)-1)) |
ae1768a72 disk/gpt: Fix GPT... |
22 |
|
012771d88 Initial revision |
23 |
/* Part types */ |
42dfe7a18 Code cleanup; mak... |
24 |
#define PART_TYPE_UNKNOWN 0x00 |
012771d88 Initial revision |
25 26 27 |
#define PART_TYPE_MAC 0x01 #define PART_TYPE_DOS 0x02 #define PART_TYPE_ISO 0x03 |
42dfe7a18 Code cleanup; mak... |
28 |
#define PART_TYPE_AMIGA 0x04 |
07f3d789b Add support for C... |
29 |
#define PART_TYPE_EFI 0x05 |
c7de829c7 * Patch by Thomas... |
30 |
|
87b8530fe disk: part: imple... |
31 32 33 34 35 |
/* maximum number of partition entries supported by search */ #define DOS_ENTRY_NUMBERS 8 #define ISO_ENTRY_NUMBERS 64 #define MAC_ENTRY_NUMBERS 64 #define AMIGA_ENTRY_NUMBERS 8 |
b0fce99bf Fix some missing ... |
36 37 38 39 40 |
/* * Type string for U-Boot bootable partitions */ #define BOOT_PART_TYPE "U-Boot" /* primary boot partition type */ #define BOOT_PART_COMP "PPCBoot" /* PPCBoot compatibility type */ |
012771d88 Initial revision |
41 |
/* device types */ |
b0fce99bf Fix some missing ... |
42 43 |
#define DEV_TYPE_UNKNOWN 0xff /* not connected */ #define DEV_TYPE_HARDDISK 0x00 /* harddisk */ |
42dfe7a18 Code cleanup; mak... |
44 45 46 |
#define DEV_TYPE_TAPE 0x01 /* Tape */ #define DEV_TYPE_CDROM 0x05 /* CD-ROM */ #define DEV_TYPE_OPDISK 0x07 /* optical disk */ |
012771d88 Initial revision |
47 |
|
92856b489 disk_partition: i... |
48 49 |
#define PART_NAME_LEN 32 #define PART_TYPE_LEN 32 |
e6faf21f2 partitions: incre... |
50 |
#define MAX_SEARCH_PARTITIONS 64 |
92856b489 disk_partition: i... |
51 |
|
42dfe7a18 Code cleanup; mak... |
52 |
typedef struct disk_partition { |
04735e9c5 Fix ext2/ext4 fil... |
53 54 |
lbaint_t start; /* # of first block in partition */ lbaint_t size; /* number of blocks in partition */ |
012771d88 Initial revision |
55 |
ulong blksz; /* block size in bytes */ |
92856b489 disk_partition: i... |
56 57 |
uchar name[PART_NAME_LEN]; /* partition name */ uchar type[PART_TYPE_LEN]; /* string type description */ |
40e0e5686 disk/part: check ... |
58 |
int bootable; /* Active/Bootable flag is set */ |
b331cd620 cmd, disk: conver... |
59 |
#if CONFIG_IS_ENABLED(PARTITION_UUIDS) |
db9b6200a EFI: replace numb... |
60 |
char uuid[UUID_STR_LEN + 1]; /* filesystem UUID as string, if exists */ |
894bfbbfb disk: part_efi: p... |
61 |
#endif |
7561b258a gpt: add optional... |
62 |
#ifdef CONFIG_PARTITION_TYPE_GUID |
db9b6200a EFI: replace numb... |
63 |
char type_guid[UUID_STR_LEN + 1]; /* type GUID as string, if exists */ |
7561b258a gpt: add optional... |
64 |
#endif |
f0fb4fa7d SPL: add support ... |
65 66 67 |
#ifdef CONFIG_DOS_PARTITION uchar sys_ind; /* partition type */ #endif |
012771d88 Initial revision |
68 |
} disk_partition_t; |
09a49930e GPT: read partiti... |
69 70 71 72 73 |
struct disk_part { int partnum; disk_partition_t gpt_part_info; struct list_head list; }; |
735dd97b1 [PATCH 1_4] Merge... |
74 |
/* Misc _get_dev functions */ |
df3fc5260 disk/part.c: Make... |
75 |
#ifdef CONFIG_PARTITIONS |
fb1b7be95 dm: blk: Add comm... |
76 |
/** |
db1d9e78e dm: blk: Rename g... |
77 |
* blk_get_dev() - get a pointer to a block device given its type and number |
fb1b7be95 dm: blk: Add comm... |
78 79 80 81 82 83 84 85 86 87 88 |
* * Each interface allocates its own devices and typically struct blk_desc is * contained with the interface's data structure. There is no global * numbering for block devices, so the interface name must be provided. * * @ifname: Interface name (e.g. "ide", "scsi") * @dev: Device number (0 for first device on that interface, 1 for * second, etc. * @return pointer to the block device, or NULL if not available, or an * error occurred. */ |
db1d9e78e dm: blk: Rename g... |
89 |
struct blk_desc *blk_get_dev(const char *ifname, int dev); |
fb1b7be95 dm: blk: Add comm... |
90 |
|
4101f6879 dm: Drop the bloc... |
91 |
struct blk_desc *mg_disk_get_dev(int dev); |
25cb0daa9 MLK-18141-1 env: ... |
92 |
struct blk_desc *sata_get_dev(int dev); |
4101f6879 dm: Drop the bloc... |
93 |
int host_get_dev_err(int dev, struct blk_desc **blk_devp); |
735dd97b1 [PATCH 1_4] Merge... |
94 |
|
012771d88 Initial revision |
95 |
/* disk/part.c */ |
3e8bd4695 dm: part: Rename ... |
96 |
int part_get_info(struct blk_desc *dev_desc, int part, disk_partition_t *info); |
4bbcc965f fs: add fs_readdir() |
97 98 99 100 101 |
/** * part_get_info_whole_disk() - get partition info for the special case of * a partition occupying the entire disk. */ int part_get_info_whole_disk(struct blk_desc *dev_desc, disk_partition_t *info); |
3e8bd4695 dm: part: Rename ... |
102 103 |
void part_print(struct blk_desc *dev_desc); void part_init(struct blk_desc *dev_desc); |
4101f6879 dm: Drop the bloc... |
104 |
void dev_print(struct blk_desc *dev_desc); |
ebac37cfb dm: blk: Rename g... |
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 |
/** * blk_get_device_by_str() - Get a block device given its interface/hw partition * * Each interface allocates its own devices and typically struct blk_desc is * contained with the interface's data structure. There is no global * numbering for block devices, so the interface name must be provided. * * The hardware parition is not related to the normal software partitioning * of a device - each hardware partition is effectively a separately * accessible block device. When a hardware parition is selected on MMC the * other hardware partitions become inaccessible. The same block device is * used to access all hardware partitions, but its capacity may change when a * different hardware partition is selected. * * When a hardware partition number is given, the block device switches to * that hardware partition. * * @ifname: Interface name (e.g. "ide", "scsi") * @dev_str: Device and optional hw partition. This can either be a string * containing the device number (e.g. "2") or the device number * and hardware partition number (e.g. "2.4") for devices that * support it (currently only MMC). * @dev_desc: Returns a pointer to the block device on success * @return block device number (local to the interface), or -1 on error */ int blk_get_device_by_str(const char *ifname, const char *dev_str, struct blk_desc **dev_desc); |
e35929e4a dm: blk: Rename g... |
133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 |
/** * blk_get_device_part_str() - Get a block device and partition * * This calls blk_get_device_by_str() to look up a device. It also looks up * a partition and returns information about it. * * @dev_part_str is in the format: * <dev>.<hw_part>:<part> where <dev> is the device number, * <hw_part> is the optional hardware partition number and * <part> is the partition number * * If ifname is "hostfs" then this function returns the sandbox host block * device. * * If ifname is ubi, then this function returns 0, with @info set to a * special UBI device. * * If @dev_part_str is NULL or empty or "-", then this function looks up * the "bootdevice" environment variable and uses that string instead. * * If the partition string is empty then the first partition is used. If the * partition string is "auto" then the first bootable partition is used. * * @ifname: Interface name (e.g. "ide", "scsi") * @dev_part_str: Device and partition string * @dev_desc: Returns a pointer to the block device on success * @info: Returns partition information * @allow_whole_dev: true to allow the user to select partition 0 * (which means the whole device), false to require a valid * partition number >= 1 * @return partition number, or -1 on error * */ int blk_get_device_part_str(const char *ifname, const char *dev_part_str, struct blk_desc **dev_desc, disk_partition_t *info, int allow_whole_dev); |
87b8530fe disk: part: imple... |
170 171 |
/** |
307890955 disk: Provide API... |
172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 |
* part_get_info_by_name_type() - Search for a partition by name * for only specified partition type * * @param dev_desc - block device descriptor * @param gpt_name - the specified table entry name * @param info - returns the disk partition info * @param part_type - only search in partitions of this type * * @return - the partition number on match (starting on 1), -1 on no match, * otherwise error */ int part_get_info_by_name_type(struct blk_desc *dev_desc, const char *name, disk_partition_t *info, int part_type); /** |
87b8530fe disk: part: imple... |
187 188 189 190 191 192 193 |
* part_get_info_by_name() - Search for a partition by name * among all available registered partitions * * @param dev_desc - block device descriptor * @param gpt_name - the specified table entry name * @param info - returns the disk partition info * |
88b6329cc disk: Return the ... |
194 195 |
* @return - the partition number on match (starting on 1), -1 on no match, * otherwise error |
87b8530fe disk: part: imple... |
196 197 198 |
*/ int part_get_info_by_name(struct blk_desc *dev_desc, const char *name, disk_partition_t *info); |
da2ee24d9 disk: part: refac... |
199 |
/** |
6eccd1f74 disk: part: Exten... |
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 |
* Get partition info from dev number + part name, or dev number + part number. * * Parse a device number and partition description (either name or number) * in the form of device number plus partition name separated by a "#" * (like "device_num#partition_name") or a device number plus a partition number * separated by a ":". For example both "0#misc" and "0:1" can be valid * partition descriptions for a given interface. If the partition is found, sets * dev_desc and part_info accordingly with the information of the partition. * * @param[in] dev_iface Device interface * @param[in] dev_part_str Input partition description, like "0#misc" or "0:1" * @param[out] dev_desc Place to store the device description pointer * @param[out] part_info Place to store the partition information * @return 0 on success, or a negative on error */ int part_get_info_by_dev_and_name_or_num(const char *dev_iface, const char *dev_part_str, struct blk_desc **dev_desc, disk_partition_t *part_info); /** |
da2ee24d9 disk: part: refac... |
221 222 223 224 225 226 227 228 229 230 231 232 |
* part_set_generic_name() - create generic partition like hda1 or sdb2 * * Helper function for partition tables, which don't hold partition names * (DOS, ISO). Generates partition name out of the device type and partition * number. * * @dev_desc: pointer to the block device * @part_num: partition number for which the name is generated * @name: buffer where the name is written */ void part_set_generic_name(const struct blk_desc *dev_desc, int part_num, char *name); |
d96a98045 disk/part.c: Expo... |
233 |
extern const struct block_drvr block_drvr[]; |
df3fc5260 disk/part.c: Make... |
234 |
#else |
db1d9e78e dm: blk: Rename g... |
235 |
static inline struct blk_desc *blk_get_dev(const char *ifname, int dev) |
99d2c205d disk/part: introd... |
236 |
{ return NULL; } |
4101f6879 dm: Drop the bloc... |
237 |
static inline struct blk_desc *mg_disk_get_dev(int dev) { return NULL; } |
25cb0daa9 MLK-18141-1 env: ... |
238 |
static inline struct blk_desc *sata_get_dev(int dev) { return NULL; } |
012771d88 Initial revision |
239 |
|
3e8bd4695 dm: part: Rename ... |
240 241 |
static inline int part_get_info(struct blk_desc *dev_desc, int part, disk_partition_t *info) { return -1; } |
4bbcc965f fs: add fs_readdir() |
242 243 244 |
static inline int part_get_info_whole_disk(struct blk_desc *dev_desc, disk_partition_t *info) { return -1; } |
3e8bd4695 dm: part: Rename ... |
245 246 |
static inline void part_print(struct blk_desc *dev_desc) {} static inline void part_init(struct blk_desc *dev_desc) {} |
4101f6879 dm: Drop the bloc... |
247 |
static inline void dev_print(struct blk_desc *dev_desc) {} |
ebac37cfb dm: blk: Rename g... |
248 249 |
static inline int blk_get_device_by_str(const char *ifname, const char *dev_str, struct blk_desc **dev_desc) |
2023e6086 disk: introduce g... |
250 |
{ return -1; } |
e35929e4a dm: blk: Rename g... |
251 |
static inline int blk_get_device_part_str(const char *ifname, |
10a37fd7a disk: get_device_... |
252 |
const char *dev_part_str, |
4101f6879 dm: Drop the bloc... |
253 |
struct blk_desc **dev_desc, |
10a37fd7a disk: get_device_... |
254 255 |
disk_partition_t *info, int allow_whole_dev) |
99d2c205d disk/part: introd... |
256 |
{ *dev_desc = NULL; return -1; } |
df3fc5260 disk/part.c: Make... |
257 |
#endif |
012771d88 Initial revision |
258 |
|
96e5b03c8 dm: part: Convert... |
259 260 261 262 263 264 |
/* * We don't support printing partition information in SPL and only support * getting partition information in a few cases. */ #ifdef CONFIG_SPL_BUILD # define part_print_ptr(x) NULL |
f4b409247 spl: Kconfig: Rep... |
265 |
# if defined(CONFIG_SPL_FS_EXT4) || defined(CONFIG_SPL_FS_FAT) || \ |
c26899c3a MA-14916-4 suppor... |
266 267 |
defined(CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION) || \ defined(CONFIG_DUAL_BOOTLOADER) |
96e5b03c8 dm: part: Convert... |
268 269 270 271 272 273 274 |
# define part_get_info_ptr(x) x # else # define part_get_info_ptr(x) NULL # endif #else #define part_print_ptr(x) x #define part_get_info_ptr(x) x |
012771d88 Initial revision |
275 |
#endif |
012771d88 Initial revision |
276 |
|
96e5b03c8 dm: part: Convert... |
277 278 279 |
struct part_driver { const char *name; int part_type; |
87b8530fe disk: part: imple... |
280 |
const int max_entries; /* maximum number of entries to search */ |
012771d88 Initial revision |
281 |
|
96e5b03c8 dm: part: Convert... |
282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 |
/** * get_info() - Get information about a partition * * @dev_desc: Block device descriptor * @part: Partition number (1 = first) * @info: Returns partition information */ int (*get_info)(struct blk_desc *dev_desc, int part, disk_partition_t *info); /** * print() - Print partition information * * @dev_desc: Block device descriptor */ void (*print)(struct blk_desc *dev_desc); /** * test() - Test if a device contains this partition type * * @dev_desc: Block device descriptor * @return 0 if the block device appears to contain this partition * type, -ve if not */ int (*test)(struct blk_desc *dev_desc); }; /* Declare a new U-Boot partition 'driver' */ #define U_BOOT_PART_TYPE(__name) \ ll_entry_declare(struct part_driver, __name, part_driver) |
c7de829c7 * Patch by Thomas... |
312 |
|
40684ddb8 gpt: Support for ... |
313 |
#include <part_efi.h> |
0d6ab32e3 part: move efi_gu... |
314 315 |
#if CONFIG_IS_ENABLED(EFI_PARTITION) |
07f3d789b Add support for C... |
316 |
/* disk/part_efi.c */ |
60bf94169 disk: part_efi: a... |
317 |
/** |
40684ddb8 gpt: Support for ... |
318 319 320 321 322 323 324 325 |
* write_gpt_table() - Write the GUID Partition Table to disk * * @param dev_desc - block device descriptor * @param gpt_h - pointer to GPT header representation * @param gpt_e - pointer to GPT partition table entries * * @return - zero on success, otherwise error */ |
4101f6879 dm: Drop the bloc... |
326 |
int write_gpt_table(struct blk_desc *dev_desc, |
40684ddb8 gpt: Support for ... |
327 328 329 330 331 |
gpt_header *gpt_h, gpt_entry *gpt_e); /** * gpt_fill_pte(): Fill the GPT partition table entry * |
47d7ee47b part: efi: make g... |
332 |
* @param dev_desc - block device descriptor |
40684ddb8 gpt: Support for ... |
333 334 335 336 337 338 339 |
* @param gpt_h - GPT header representation * @param gpt_e - GPT partition table entries * @param partitions - list of partitions * @param parts - number of partitions * * @return zero on success */ |
47d7ee47b part: efi: make g... |
340 341 342 |
int gpt_fill_pte(struct blk_desc *dev_desc, gpt_header *gpt_h, gpt_entry *gpt_e, disk_partition_t *partitions, int parts); |
40684ddb8 gpt: Support for ... |
343 344 345 346 347 348 349 350 351 352 353 |
/** * gpt_fill_header(): Fill the GPT header * * @param dev_desc - block device descriptor * @param gpt_h - GPT header representation * @param str_guid - disk guid string representation * @param parts_count - number of partitions * * @return - error on str_guid conversion error */ |
4101f6879 dm: Drop the bloc... |
354 |
int gpt_fill_header(struct blk_desc *dev_desc, gpt_header *gpt_h, |
40684ddb8 gpt: Support for ... |
355 356 357 358 359 360 361 362 363 364 365 366 |
char *str_guid, int parts_count); /** * gpt_restore(): Restore GPT partition table * * @param dev_desc - block device descriptor * @param str_disk_guid - disk GUID * @param partitions - list of partitions * @param parts - number of partitions * * @return zero on success */ |
4101f6879 dm: Drop the bloc... |
367 |
int gpt_restore(struct blk_desc *dev_desc, char *str_disk_guid, |
40684ddb8 gpt: Support for ... |
368 |
disk_partition_t *partitions, const int parts_count); |
0ff7e585d fastboot: handle ... |
369 370 371 372 373 374 375 376 377 |
/** * is_valid_gpt_buf() - Ensure that the Primary GPT information is valid * * @param dev_desc - block device descriptor * @param buf - buffer which contains the MBR and Primary GPT info * * @return - '0' on success, otherwise error */ |
4101f6879 dm: Drop the bloc... |
378 |
int is_valid_gpt_buf(struct blk_desc *dev_desc, void *buf); |
0ff7e585d fastboot: handle ... |
379 380 381 382 383 384 385 386 387 |
/** * write_mbr_and_gpt_partitions() - write MBR, Primary GPT and Backup GPT * * @param dev_desc - block device descriptor * @param buf - buffer which contains the MBR and Primary GPT info * * @return - '0' on success, otherwise error */ |
4101f6879 dm: Drop the bloc... |
388 |
int write_mbr_and_gpt_partitions(struct blk_desc *dev_desc, void *buf); |
cef68bf90 gpt: part: Defini... |
389 390 |
/** |
9f99e9de1 MLK-18591-3 andro... |
391 392 393 394 395 396 397 398 399 |
* write_backup_gpt_partitions - write MBR, backup gpt table. * @param dev_desc - block device descriptor * @param buf - buffer which contains the MBR and Primary GPT info * * @return - '0' on success, otherwise error */ int write_backup_gpt_partitions(struct blk_desc *dev_desc, void *buf); /** |
cef68bf90 gpt: part: Defini... |
400 401 402 403 404 405 406 407 408 409 410 |
* gpt_verify_headers() - Function to read and CRC32 check of the GPT's header * and partition table entries (PTE) * * As a side effect if sets gpt_head and gpt_pte so they point to GPT data. * * @param dev_desc - block device descriptor * @param gpt_head - pointer to GPT header data read from medium * @param gpt_pte - pointer to GPT partition table enties read from medium * * @return - '0' on success, otherwise error */ |
4101f6879 dm: Drop the bloc... |
411 |
int gpt_verify_headers(struct blk_desc *dev_desc, gpt_header *gpt_head, |
cef68bf90 gpt: part: Defini... |
412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 |
gpt_entry **gpt_pte); /** * gpt_verify_partitions() - Function to check if partitions' name, start and * size correspond to '$partitions' env variable * * This function checks if on medium stored GPT data is in sync with information * provided in '$partitions' environment variable. Specificially, name, start * and size of the partition is checked. * * @param dev_desc - block device descriptor * @param partitions - partition data read from '$partitions' env variable * @param parts - number of partitions read from '$partitions' env variable * @param gpt_head - pointer to GPT header data read from medium * @param gpt_pte - pointer to GPT partition table enties read from medium * * @return - '0' on success, otherwise error */ |
4101f6879 dm: Drop the bloc... |
430 |
int gpt_verify_partitions(struct blk_desc *dev_desc, |
cef68bf90 gpt: part: Defini... |
431 432 |
disk_partition_t *partitions, int parts, gpt_header *gpt_head, gpt_entry **gpt_pte); |
73d6d18b7 GPT: add accessor... |
433 434 435 436 437 438 439 440 441 442 443 444 445 446 |
/** * get_disk_guid() - Function to read the GUID string from a device's GPT * * This function reads the GUID string from a block device whose descriptor * is provided. * * @param dev_desc - block device descriptor * @param guid - pre-allocated string in which to return the GUID * * @return - '0' on success, otherwise error */ int get_disk_guid(struct blk_desc *dev_desc, char *guid); |
d9972736d MA-18422 Locate t... |
447 448 449 450 |
#if defined(CONFIG_DUAL_BOOTLOADER) && defined(CONFIG_SPL_BUILD) int part_get_info_efi_by_name(struct blk_desc *dev_desc, const char *name, disk_partition_t *info); #endif |
07f3d789b Add support for C... |
451 |
#endif |
b0cf73393 disk: convert CON... |
452 |
#if CONFIG_IS_ENABLED(DOS_PARTITION) |
b6dd69a4d fastboot: add sup... |
453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 |
/** * is_valid_dos_buf() - Ensure that a DOS MBR image is valid * * @param buf - buffer which contains the MBR * * @return - '0' on success, otherwise error */ int is_valid_dos_buf(void *buf); /** * write_mbr_partition() - write DOS MBR * * @param dev_desc - block device descriptor * @param buf - buffer which contains the MBR * * @return - '0' on success, otherwise error */ int write_mbr_partition(struct blk_desc *dev_desc, void *buf); #endif |
012771d88 Initial revision |
473 |
#endif /* _PART_H */ |