Blame view
include/part.h
14.9 KB
012771d88 Initial revision |
1 |
/* |
42dfe7a18 Code cleanup; mak... |
2 |
* (C) Copyright 2000-2004 |
012771d88 Initial revision |
3 4 |
* Wolfgang Denk, DENX Software Engineering, wd@denx.de. * |
3765b3e7b Coding Style clea... |
5 |
* SPDX-License-Identifier: GPL-2.0+ |
012771d88 Initial revision |
6 7 8 |
*/ #ifndef _PART_H #define _PART_H |
735dd97b1 [PATCH 1_4] Merge... |
9 |
|
1a73661bc dm: Add a new hea... |
10 |
#include <blk.h> |
6e5923851 * Cleanup, minor ... |
11 |
#include <ide.h> |
db9b6200a EFI: replace numb... |
12 |
#include <uuid.h> |
09a49930e GPT: read partiti... |
13 |
#include <linux/list.h> |
012771d88 Initial revision |
14 |
|
d96a98045 disk/part.c: Expo... |
15 16 |
struct block_drvr { char *name; |
d96a98045 disk/part.c: Expo... |
17 18 |
int (*select_hwpart)(int dev_num, int hwpart); }; |
0472fbfd3 part/dev_desc: Ad... |
19 20 21 22 |
#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... |
23 |
|
012771d88 Initial revision |
24 |
/* Part types */ |
42dfe7a18 Code cleanup; mak... |
25 |
#define PART_TYPE_UNKNOWN 0x00 |
012771d88 Initial revision |
26 27 28 |
#define PART_TYPE_MAC 0x01 #define PART_TYPE_DOS 0x02 #define PART_TYPE_ISO 0x03 |
42dfe7a18 Code cleanup; mak... |
29 |
#define PART_TYPE_AMIGA 0x04 |
07f3d789b Add support for C... |
30 |
#define PART_TYPE_EFI 0x05 |
c7de829c7 * Patch by Thomas... |
31 |
|
87b8530fe disk: part: imple... |
32 33 34 35 36 |
/* 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 ... |
37 38 39 40 41 |
/* * 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 |
42 |
/* device types */ |
b0fce99bf Fix some missing ... |
43 44 |
#define DEV_TYPE_UNKNOWN 0xff /* not connected */ #define DEV_TYPE_HARDDISK 0x00 /* harddisk */ |
42dfe7a18 Code cleanup; mak... |
45 46 47 |
#define DEV_TYPE_TAPE 0x01 /* Tape */ #define DEV_TYPE_CDROM 0x05 /* CD-ROM */ #define DEV_TYPE_OPDISK 0x07 /* optical disk */ |
012771d88 Initial revision |
48 |
|
92856b489 disk_partition: i... |
49 50 |
#define PART_NAME_LEN 32 #define PART_TYPE_LEN 32 |
e6faf21f2 partitions: incre... |
51 |
#define MAX_SEARCH_PARTITIONS 64 |
92856b489 disk_partition: i... |
52 |
|
42dfe7a18 Code cleanup; mak... |
53 |
typedef struct disk_partition { |
04735e9c5 Fix ext2/ext4 fil... |
54 55 |
lbaint_t start; /* # of first block in partition */ lbaint_t size; /* number of blocks in partition */ |
012771d88 Initial revision |
56 |
ulong blksz; /* block size in bytes */ |
92856b489 disk_partition: i... |
57 58 |
uchar name[PART_NAME_LEN]; /* partition name */ uchar type[PART_TYPE_LEN]; /* string type description */ |
40e0e5686 disk/part: check ... |
59 |
int bootable; /* Active/Bootable flag is set */ |
b331cd620 cmd, disk: conver... |
60 |
#if CONFIG_IS_ENABLED(PARTITION_UUIDS) |
db9b6200a EFI: replace numb... |
61 |
char uuid[UUID_STR_LEN + 1]; /* filesystem UUID as string, if exists */ |
894bfbbfb disk: part_efi: p... |
62 |
#endif |
7561b258a gpt: add optional... |
63 |
#ifdef CONFIG_PARTITION_TYPE_GUID |
db9b6200a EFI: replace numb... |
64 |
char type_guid[UUID_STR_LEN + 1]; /* type GUID as string, if exists */ |
7561b258a gpt: add optional... |
65 |
#endif |
f0fb4fa7d SPL: add support ... |
66 67 68 |
#ifdef CONFIG_DOS_PARTITION uchar sys_ind; /* partition type */ #endif |
012771d88 Initial revision |
69 |
} disk_partition_t; |
09a49930e GPT: read partiti... |
70 71 72 73 74 |
struct disk_part { int partnum; disk_partition_t gpt_part_info; struct list_head list; }; |
735dd97b1 [PATCH 1_4] Merge... |
75 |
/* Misc _get_dev functions */ |
df3fc5260 disk/part.c: Make... |
76 |
#ifdef CONFIG_PARTITIONS |
fb1b7be95 dm: blk: Add comm... |
77 |
/** |
db1d9e78e dm: blk: Rename g... |
78 |
* blk_get_dev() - get a pointer to a block device given its type and number |
fb1b7be95 dm: blk: Add comm... |
79 80 81 82 83 84 85 86 87 88 89 |
* * 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... |
90 |
struct blk_desc *blk_get_dev(const char *ifname, int dev); |
fb1b7be95 dm: blk: Add comm... |
91 |
|
4101f6879 dm: Drop the bloc... |
92 |
struct blk_desc *mg_disk_get_dev(int dev); |
aaef173cb MLK-18141-1 env: ... |
93 |
struct blk_desc *sata_get_dev(int dev); |
4101f6879 dm: Drop the bloc... |
94 |
int host_get_dev_err(int dev, struct blk_desc **blk_devp); |
735dd97b1 [PATCH 1_4] Merge... |
95 |
|
012771d88 Initial revision |
96 |
/* disk/part.c */ |
3e8bd4695 dm: part: Rename ... |
97 |
int part_get_info(struct blk_desc *dev_desc, int part, disk_partition_t *info); |
4bbcc965f fs: add fs_readdir() |
98 99 100 101 102 |
/** * 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 ... |
103 104 |
void part_print(struct blk_desc *dev_desc); void part_init(struct blk_desc *dev_desc); |
4101f6879 dm: Drop the bloc... |
105 |
void dev_print(struct blk_desc *dev_desc); |
ebac37cfb dm: blk: Rename g... |
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 133 |
/** * 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... |
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 170 |
/** * 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... |
171 172 |
/** |
307890955 disk: Provide API... |
173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 |
* 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... |
188 189 190 191 192 193 194 |
* 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 ... |
195 196 |
* @return - the partition number on match (starting on 1), -1 on no match, * otherwise error |
87b8530fe disk: part: imple... |
197 198 199 |
*/ int part_get_info_by_name(struct blk_desc *dev_desc, const char *name, disk_partition_t *info); |
da2ee24d9 disk: part: refac... |
200 201 202 203 204 205 206 207 208 209 210 211 212 |
/** * 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... |
213 |
extern const struct block_drvr block_drvr[]; |
df3fc5260 disk/part.c: Make... |
214 |
#else |
db1d9e78e dm: blk: Rename g... |
215 |
static inline struct blk_desc *blk_get_dev(const char *ifname, int dev) |
99d2c205d disk/part: introd... |
216 |
{ return NULL; } |
4101f6879 dm: Drop the bloc... |
217 |
static inline struct blk_desc *mg_disk_get_dev(int dev) { return NULL; } |
aaef173cb MLK-18141-1 env: ... |
218 |
static inline struct blk_desc *sata_get_dev(int dev) { return NULL; } |
012771d88 Initial revision |
219 |
|
3e8bd4695 dm: part: Rename ... |
220 221 |
static inline int part_get_info(struct blk_desc *dev_desc, int part, disk_partition_t *info) { return -1; } |
4bbcc965f fs: add fs_readdir() |
222 223 224 |
static inline int part_get_info_whole_disk(struct blk_desc *dev_desc, disk_partition_t *info) { return -1; } |
3e8bd4695 dm: part: Rename ... |
225 226 |
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... |
227 |
static inline void dev_print(struct blk_desc *dev_desc) {} |
ebac37cfb dm: blk: Rename g... |
228 229 |
static inline int blk_get_device_by_str(const char *ifname, const char *dev_str, struct blk_desc **dev_desc) |
2023e6086 disk: introduce g... |
230 |
{ return -1; } |
e35929e4a dm: blk: Rename g... |
231 |
static inline int blk_get_device_part_str(const char *ifname, |
10a37fd7a disk: get_device_... |
232 |
const char *dev_part_str, |
4101f6879 dm: Drop the bloc... |
233 |
struct blk_desc **dev_desc, |
10a37fd7a disk: get_device_... |
234 235 |
disk_partition_t *info, int allow_whole_dev) |
99d2c205d disk/part: introd... |
236 |
{ *dev_desc = NULL; return -1; } |
df3fc5260 disk/part.c: Make... |
237 |
#endif |
012771d88 Initial revision |
238 |
|
96e5b03c8 dm: part: Convert... |
239 240 241 242 243 244 |
/* * 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 |
d9b2678e0 disk: part: Enabl... |
245 |
# if defined(CONFIG_SPL_EXT_SUPPORT) || defined(CONFIG_SPL_FAT_SUPPORT) || \ |
dbcf1e3cc [iot] Support dua... |
246 247 |
defined(CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION) || \ defined(CONFIG_DUAL_BOOTLOADER) |
96e5b03c8 dm: part: Convert... |
248 249 250 251 252 253 254 |
# 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 |
255 |
#endif |
012771d88 Initial revision |
256 |
|
96e5b03c8 dm: part: Convert... |
257 258 259 |
struct part_driver { const char *name; int part_type; |
87b8530fe disk: part: imple... |
260 |
const int max_entries; /* maximum number of entries to search */ |
012771d88 Initial revision |
261 |
|
96e5b03c8 dm: part: Convert... |
262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 |
/** * 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... |
292 |
|
40684ddb8 gpt: Support for ... |
293 |
#include <part_efi.h> |
0d6ab32e3 part: move efi_gu... |
294 295 |
#if CONFIG_IS_ENABLED(EFI_PARTITION) |
07f3d789b Add support for C... |
296 |
/* disk/part_efi.c */ |
60bf94169 disk: part_efi: a... |
297 |
/** |
40684ddb8 gpt: Support for ... |
298 299 300 301 302 303 304 305 |
* 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... |
306 |
int write_gpt_table(struct blk_desc *dev_desc, |
40684ddb8 gpt: Support for ... |
307 308 309 310 311 |
gpt_header *gpt_h, gpt_entry *gpt_e); /** * gpt_fill_pte(): Fill the GPT partition table entry * |
47d7ee47b part: efi: make g... |
312 |
* @param dev_desc - block device descriptor |
40684ddb8 gpt: Support for ... |
313 314 315 316 317 318 319 |
* @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... |
320 321 322 |
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 ... |
323 324 325 326 327 328 329 330 331 332 333 |
/** * 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... |
334 |
int gpt_fill_header(struct blk_desc *dev_desc, gpt_header *gpt_h, |
40684ddb8 gpt: Support for ... |
335 336 337 338 339 340 341 342 343 344 345 346 |
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... |
347 |
int gpt_restore(struct blk_desc *dev_desc, char *str_disk_guid, |
40684ddb8 gpt: Support for ... |
348 |
disk_partition_t *partitions, const int parts_count); |
0ff7e585d fastboot: handle ... |
349 350 351 352 353 354 355 356 357 |
/** * 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... |
358 |
int is_valid_gpt_buf(struct blk_desc *dev_desc, void *buf); |
0ff7e585d fastboot: handle ... |
359 360 361 362 363 364 365 366 367 |
/** * 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... |
368 |
int write_mbr_and_gpt_partitions(struct blk_desc *dev_desc, void *buf); |
cef68bf90 gpt: part: Defini... |
369 370 |
/** |
2c840c82b MLK-18591-3 andro... |
371 372 373 374 375 376 377 378 |
* 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... |
379 380 381 382 383 384 385 386 387 388 389 |
* 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... |
390 |
int gpt_verify_headers(struct blk_desc *dev_desc, gpt_header *gpt_head, |
cef68bf90 gpt: part: Defini... |
391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 |
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... |
409 |
int gpt_verify_partitions(struct blk_desc *dev_desc, |
cef68bf90 gpt: part: Defini... |
410 411 |
disk_partition_t *partitions, int parts, gpt_header *gpt_head, gpt_entry **gpt_pte); |
73d6d18b7 GPT: add accessor... |
412 413 414 415 416 417 418 419 420 421 422 423 424 425 |
/** * 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); |
07f3d789b Add support for C... |
426 |
#endif |
b0cf73393 disk: convert CON... |
427 |
#if CONFIG_IS_ENABLED(DOS_PARTITION) |
b6dd69a4d fastboot: add sup... |
428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 |
/** * 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 |
448 |
#endif /* _PART_H */ |