1 /* 2 * Copyright (C) 2008 RuggedCom, Inc. 3 * Richard Retanubun <RichardRetanubun@RuggedCom.com> 4 * 5 * SPDX-License-Identifier: GPL-2.0+ 6 */ 7 8 /* 9 * NOTE: 10 * when CONFIG_SYS_64BIT_LBA is not defined, lbaint_t is 32 bits; this 11 * limits the maximum size of addressable storage to < 2 Terra Bytes 12 */ 13 #include <asm/unaligned.h> 14 #include <common.h> 15 #include <command.h> 16 #include <fdtdec.h> 17 #include <ide.h> 18 #include <inttypes.h> 19 #include <malloc.h> 20 #include <memalign.h> 21 #include <part_efi.h> 22 #include <linux/compiler.h> 23 #include <linux/ctype.h> 24 25 DECLARE_GLOBAL_DATA_PTR; 26 27 #ifdef HAVE_BLOCK_DEVICE 28 /** 29 * efi_crc32() - EFI version of crc32 function 30 * @buf: buffer to calculate crc32 of 31 * @len - length of buf 32 * 33 * Description: Returns EFI-style CRC32 value for @buf 34 */ 35 static inline u32 efi_crc32(const void *buf, u32 len) 36 { 37 return crc32(0, buf, len); 38 } 39 40 /* 41 * Private function prototypes 42 */ 43 44 static int pmbr_part_valid(struct partition *part); 45 static int is_pmbr_valid(legacy_mbr * mbr); 46 static int is_gpt_valid(struct blk_desc *dev_desc, u64 lba, 47 gpt_header *pgpt_head, gpt_entry **pgpt_pte); 48 static gpt_entry *alloc_read_gpt_entries(struct blk_desc *dev_desc, 49 gpt_header *pgpt_head); 50 static int is_pte_valid(gpt_entry * pte); 51 52 static char *print_efiname(gpt_entry *pte) 53 { 54 static char name[PARTNAME_SZ + 1]; 55 int i; 56 for (i = 0; i < PARTNAME_SZ; i++) { 57 u8 c; 58 c = pte->partition_name[i] & 0xff; 59 c = (c && !isprint(c)) ? '.' : c; 60 name[i] = c; 61 } 62 name[PARTNAME_SZ] = 0; 63 return name; 64 } 65 66 static efi_guid_t system_guid = PARTITION_SYSTEM_GUID; 67 68 static inline int is_bootable(gpt_entry *p) 69 { 70 return p->attributes.fields.legacy_bios_bootable || 71 !memcmp(&(p->partition_type_guid), &system_guid, 72 sizeof(efi_guid_t)); 73 } 74 75 static int validate_gpt_header(gpt_header *gpt_h, lbaint_t lba, 76 lbaint_t lastlba) 77 { 78 uint32_t crc32_backup = 0; 79 uint32_t calc_crc32; 80 81 /* Check the GPT header signature */ 82 if (le64_to_cpu(gpt_h->signature) != GPT_HEADER_SIGNATURE) { 83 printf("%s signature is wrong: 0x%llX != 0x%llX\n", 84 "GUID Partition Table Header", 85 le64_to_cpu(gpt_h->signature), 86 GPT_HEADER_SIGNATURE); 87 return -1; 88 } 89 90 /* Check the GUID Partition Table CRC */ 91 memcpy(&crc32_backup, &gpt_h->header_crc32, sizeof(crc32_backup)); 92 memset(&gpt_h->header_crc32, 0, sizeof(gpt_h->header_crc32)); 93 94 calc_crc32 = efi_crc32((const unsigned char *)gpt_h, 95 le32_to_cpu(gpt_h->header_size)); 96 97 memcpy(&gpt_h->header_crc32, &crc32_backup, sizeof(crc32_backup)); 98 99 if (calc_crc32 != le32_to_cpu(crc32_backup)) { 100 printf("%s CRC is wrong: 0x%x != 0x%x\n", 101 "GUID Partition Table Header", 102 le32_to_cpu(crc32_backup), calc_crc32); 103 return -1; 104 } 105 106 /* 107 * Check that the my_lba entry points to the LBA that contains the GPT 108 */ 109 if (le64_to_cpu(gpt_h->my_lba) != lba) { 110 printf("GPT: my_lba incorrect: %llX != " LBAF "\n", 111 le64_to_cpu(gpt_h->my_lba), 112 lba); 113 return -1; 114 } 115 116 /* 117 * Check that the first_usable_lba and that the last_usable_lba are 118 * within the disk. 119 */ 120 if (le64_to_cpu(gpt_h->first_usable_lba) > lastlba) { 121 printf("GPT: first_usable_lba incorrect: %llX > " LBAF "\n", 122 le64_to_cpu(gpt_h->first_usable_lba), lastlba); 123 return -1; 124 } 125 if (le64_to_cpu(gpt_h->last_usable_lba) > lastlba) { 126 printf("GPT: last_usable_lba incorrect: %llX > " LBAF "\n", 127 le64_to_cpu(gpt_h->last_usable_lba), lastlba); 128 return -1; 129 } 130 131 debug("GPT: first_usable_lba: %llX last_usable_lba: %llX last lba: " 132 LBAF "\n", le64_to_cpu(gpt_h->first_usable_lba), 133 le64_to_cpu(gpt_h->last_usable_lba), lastlba); 134 135 return 0; 136 } 137 138 static int validate_gpt_entries(gpt_header *gpt_h, gpt_entry *gpt_e) 139 { 140 uint32_t calc_crc32; 141 142 /* Check the GUID Partition Table Entry Array CRC */ 143 calc_crc32 = efi_crc32((const unsigned char *)gpt_e, 144 le32_to_cpu(gpt_h->num_partition_entries) * 145 le32_to_cpu(gpt_h->sizeof_partition_entry)); 146 147 if (calc_crc32 != le32_to_cpu(gpt_h->partition_entry_array_crc32)) { 148 printf("%s: 0x%x != 0x%x\n", 149 "GUID Partition Table Entry Array CRC is wrong", 150 le32_to_cpu(gpt_h->partition_entry_array_crc32), 151 calc_crc32); 152 return -1; 153 } 154 155 return 0; 156 } 157 158 static void prepare_backup_gpt_header(gpt_header *gpt_h) 159 { 160 uint32_t calc_crc32; 161 uint64_t val; 162 163 /* recalculate the values for the Backup GPT Header */ 164 val = le64_to_cpu(gpt_h->my_lba); 165 gpt_h->my_lba = gpt_h->alternate_lba; 166 gpt_h->alternate_lba = cpu_to_le64(val); 167 gpt_h->partition_entry_lba = 168 cpu_to_le64(le64_to_cpu(gpt_h->last_usable_lba) + 1); 169 gpt_h->header_crc32 = 0; 170 171 calc_crc32 = efi_crc32((const unsigned char *)gpt_h, 172 le32_to_cpu(gpt_h->header_size)); 173 gpt_h->header_crc32 = cpu_to_le32(calc_crc32); 174 } 175 176 #if CONFIG_IS_ENABLED(EFI_PARTITION) 177 /* 178 * Public Functions (include/part.h) 179 */ 180 181 /* 182 * UUID is displayed as 32 hexadecimal digits, in 5 groups, 183 * separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters 184 */ 185 int get_disk_guid(struct blk_desc * dev_desc, char *guid) 186 { 187 ALLOC_CACHE_ALIGN_BUFFER_PAD(gpt_header, gpt_head, 1, dev_desc->blksz); 188 gpt_entry *gpt_pte = NULL; 189 unsigned char *guid_bin; 190 191 /* This function validates AND fills in the GPT header and PTE */ 192 if (is_gpt_valid(dev_desc, GPT_PRIMARY_PARTITION_TABLE_LBA, 193 gpt_head, &gpt_pte) != 1) { 194 printf("%s: *** ERROR: Invalid GPT ***\n", __func__); 195 if (is_gpt_valid(dev_desc, dev_desc->lba - 1, 196 gpt_head, &gpt_pte) != 1) { 197 printf("%s: *** ERROR: Invalid Backup GPT ***\n", 198 __func__); 199 return -EINVAL; 200 } else { 201 printf("%s: *** Using Backup GPT ***\n", 202 __func__); 203 } 204 } 205 206 guid_bin = gpt_head->disk_guid.b; 207 uuid_bin_to_str(guid_bin, guid, UUID_STR_FORMAT_GUID); 208 209 return 0; 210 } 211 212 void part_print_efi(struct blk_desc *dev_desc) 213 { 214 ALLOC_CACHE_ALIGN_BUFFER_PAD(gpt_header, gpt_head, 1, dev_desc->blksz); 215 gpt_entry *gpt_pte = NULL; 216 int i = 0; 217 char uuid[UUID_STR_LEN + 1]; 218 unsigned char *uuid_bin; 219 220 /* This function validates AND fills in the GPT header and PTE */ 221 if (is_gpt_valid(dev_desc, GPT_PRIMARY_PARTITION_TABLE_LBA, 222 gpt_head, &gpt_pte) != 1) { 223 printf("%s: *** ERROR: Invalid GPT ***\n", __func__); 224 if (is_gpt_valid(dev_desc, (dev_desc->lba - 1), 225 gpt_head, &gpt_pte) != 1) { 226 printf("%s: *** ERROR: Invalid Backup GPT ***\n", 227 __func__); 228 return; 229 } else { 230 printf("%s: *** Using Backup GPT ***\n", 231 __func__); 232 } 233 } 234 235 debug("%s: gpt-entry at %p\n", __func__, gpt_pte); 236 237 printf("Part\tStart LBA\tEnd LBA\t\tName\n"); 238 printf("\tAttributes\n"); 239 printf("\tType GUID\n"); 240 printf("\tPartition GUID\n"); 241 242 for (i = 0; i < le32_to_cpu(gpt_head->num_partition_entries); i++) { 243 /* Stop at the first non valid PTE */ 244 if (!is_pte_valid(&gpt_pte[i])) 245 break; 246 247 printf("%3d\t0x%08llx\t0x%08llx\t\"%s\"\n", (i + 1), 248 le64_to_cpu(gpt_pte[i].starting_lba), 249 le64_to_cpu(gpt_pte[i].ending_lba), 250 print_efiname(&gpt_pte[i])); 251 printf("\tattrs:\t0x%016llx\n", gpt_pte[i].attributes.raw); 252 uuid_bin = (unsigned char *)gpt_pte[i].partition_type_guid.b; 253 uuid_bin_to_str(uuid_bin, uuid, UUID_STR_FORMAT_GUID); 254 printf("\ttype:\t%s\n", uuid); 255 #ifdef CONFIG_PARTITION_TYPE_GUID 256 if (!uuid_guid_get_str(uuid_bin, uuid)) 257 printf("\ttype:\t%s\n", uuid); 258 #endif 259 uuid_bin = (unsigned char *)gpt_pte[i].unique_partition_guid.b; 260 uuid_bin_to_str(uuid_bin, uuid, UUID_STR_FORMAT_GUID); 261 printf("\tguid:\t%s\n", uuid); 262 } 263 264 /* Remember to free pte */ 265 free(gpt_pte); 266 return; 267 } 268 269 int part_get_info_efi(struct blk_desc *dev_desc, int part, 270 disk_partition_t *info) 271 { 272 static gpt_entry *gpt_pte = NULL; 273 static gpt_header *gpt_head = NULL; 274 275 if (!gpt_head) 276 gpt_head = memalign(ARCH_DMA_MINALIGN, dev_desc->blksz); 277 278 /* 279 * We suppose different dev have different size, eg. emmc vs sd 280 * free the pte first if exist and then will malloc and init a new one. 281 */ 282 if (gpt_head && (gpt_head->last_usable_lba + 0x22) != dev_desc->lba) { 283 if (gpt_pte) 284 free(gpt_pte); 285 gpt_pte = NULL; 286 } 287 288 /* "part" argument must be at least 1 */ 289 if (part < 1) { 290 printf("%s: Invalid Argument(s)\n", __func__); 291 return -1; 292 } 293 294 /* This function validates AND fills in the GPT header and PTE */ 295 if (is_gpt_valid(dev_desc, GPT_PRIMARY_PARTITION_TABLE_LBA, 296 gpt_head, &gpt_pte) != 1) { 297 printf("%s: *** ERROR: Invalid GPT ***\n", __func__); 298 if (is_gpt_valid(dev_desc, (dev_desc->lba - 1), 299 gpt_head, &gpt_pte) != 1) { 300 printf("%s: *** ERROR: Invalid Backup GPT ***\n", 301 __func__); 302 return -1; 303 } else { 304 printf("%s: *** Using Backup GPT ***\n", 305 __func__); 306 } 307 } 308 309 if (part > le32_to_cpu(gpt_head->num_partition_entries) || 310 !is_pte_valid(&gpt_pte[part - 1])) { 311 debug("%s: *** ERROR: Invalid partition number %d ***\n", 312 __func__, part); 313 return -1; 314 } 315 316 /* The 'lbaint_t' casting may limit the maximum disk size to 2 TB */ 317 info->start = (lbaint_t)le64_to_cpu(gpt_pte[part - 1].starting_lba); 318 /* The ending LBA is inclusive, to calculate size, add 1 to it */ 319 info->size = (lbaint_t)le64_to_cpu(gpt_pte[part - 1].ending_lba) + 1 320 - info->start; 321 info->blksz = dev_desc->blksz; 322 323 sprintf((char *)info->name, "%s", 324 print_efiname(&gpt_pte[part - 1])); 325 strcpy((char *)info->type, "U-Boot"); 326 info->bootable = is_bootable(&gpt_pte[part - 1]); 327 #if CONFIG_IS_ENABLED(PARTITION_UUIDS) 328 uuid_bin_to_str(gpt_pte[part - 1].unique_partition_guid.b, info->uuid, 329 UUID_STR_FORMAT_GUID); 330 #endif 331 #ifdef CONFIG_PARTITION_TYPE_GUID 332 uuid_bin_to_str(gpt_pte[part - 1].partition_type_guid.b, 333 info->type_guid, UUID_STR_FORMAT_GUID); 334 #endif 335 336 debug("%s: start 0x" LBAF ", size 0x" LBAF ", name %s\n", __func__, 337 info->start, info->size, info->name); 338 339 return 0; 340 } 341 342 #ifdef CONFIG_RKIMG_BOOTLOADER 343 static void gpt_entry_modify(struct blk_desc *dev_desc, 344 gpt_entry *gpt_pte, 345 gpt_header *gpt_head) 346 { 347 int i; 348 uint32_t calc_crc32; 349 350 for (i = 0; i < gpt_head->num_partition_entries; i++) { 351 if (!is_pte_valid(&gpt_pte[i])) 352 break; 353 } 354 355 if (gpt_pte[i - 1].ending_lba <= (dev_desc->lba - 0x22)) 356 return; 357 358 gpt_pte[i - 1].ending_lba = dev_desc->lba - 0x22; 359 calc_crc32 = efi_crc32((const unsigned char *)gpt_pte, 360 le32_to_cpu(gpt_head->num_partition_entries) * 361 le32_to_cpu(gpt_head->sizeof_partition_entry)); 362 gpt_head->partition_entry_array_crc32 = calc_crc32; 363 } 364 365 static int part_efi_repair(struct blk_desc *dev_desc, gpt_entry *gpt_pte, 366 gpt_header *gpt_head, int head_gpt_valid, 367 int backup_gpt_valid) 368 { 369 uint32_t calc_crc32; 370 size_t count = 0, blk_cnt; 371 lbaint_t blk; 372 373 if (head_gpt_valid == 1 && backup_gpt_valid == 1) { 374 return 0; 375 } else if (head_gpt_valid == 0 && backup_gpt_valid == 0) { 376 return -1; 377 } else if (head_gpt_valid == 1 && backup_gpt_valid == 0) { 378 gpt_head->header_crc32 = 0; 379 gpt_head->my_lba = dev_desc->lba - 1; 380 gpt_head->alternate_lba = 1; 381 gpt_head->partition_entry_lba = dev_desc->lba - 0x21; 382 gpt_entry_modify(dev_desc, gpt_pte, gpt_head); 383 calc_crc32 = efi_crc32((const unsigned char *)gpt_head, 384 le32_to_cpu(gpt_head->header_size)); 385 gpt_head->header_crc32 = calc_crc32; 386 if (blk_dwrite(dev_desc, dev_desc->lba - 1, 1, gpt_head) != 1) { 387 printf("*** ERROR: Can't write GPT header ***\n"); 388 return -1; 389 } 390 count = le32_to_cpu(gpt_head->num_partition_entries) * 391 le32_to_cpu(gpt_head->sizeof_partition_entry); 392 blk = le64_to_cpu(gpt_head->partition_entry_lba); 393 blk_cnt = BLOCK_CNT(count, dev_desc); 394 if (blk_dwrite(dev_desc, blk, (lbaint_t)blk_cnt, gpt_pte) != 395 blk_cnt) { 396 printf("*** ERROR: Can't write entry partitions ***\n"); 397 return -1; 398 } 399 printf("Repair the backup gpt table OK!\n"); 400 } else if (head_gpt_valid == 0 && backup_gpt_valid == 1) { 401 gpt_head->header_crc32 = 0; 402 gpt_head->my_lba = 1; 403 gpt_head->alternate_lba = dev_desc->lba - 1; 404 gpt_head->partition_entry_lba = 0x22; 405 gpt_entry_modify(dev_desc, gpt_pte, gpt_head); 406 calc_crc32 = efi_crc32((const unsigned char *)gpt_head, 407 le32_to_cpu(gpt_head->header_size)); 408 gpt_head->header_crc32 = calc_crc32; 409 if (blk_dwrite(dev_desc, 1, 1, gpt_head) != 1) { 410 printf("*** ERROR: Can't write GPT header ***\n"); 411 return -1; 412 } 413 count = le32_to_cpu(gpt_head->num_partition_entries) * 414 le32_to_cpu(gpt_head->sizeof_partition_entry); 415 blk = le64_to_cpu(gpt_head->partition_entry_lba); 416 blk_cnt = BLOCK_CNT(count, dev_desc); 417 if (blk_dwrite(dev_desc, blk, (lbaint_t)blk_cnt, gpt_pte) != 418 blk_cnt) { 419 printf("*** ERROR: Can't write entry partitions ***\n"); 420 return -1; 421 } 422 printf("Repair the Primary gpt table OK!\n"); 423 } 424 425 return 0; 426 } 427 #endif 428 429 static int part_test_efi(struct blk_desc *dev_desc) 430 { 431 ALLOC_CACHE_ALIGN_BUFFER_PAD(legacy_mbr, legacymbr, 1, dev_desc->blksz); 432 433 /* Read legacy MBR from block 0 and validate it */ 434 if ((blk_dread(dev_desc, 0, 1, (ulong *)legacymbr) != 1) 435 || (is_pmbr_valid(legacymbr) != 1)) { 436 return -1; 437 } 438 #ifdef CONFIG_RKIMG_BOOTLOADER 439 gpt_entry *h_gpt_pte = NULL; 440 gpt_header *h_gpt_head = NULL; 441 gpt_entry *b_gpt_pte = NULL; 442 gpt_header *b_gpt_head = NULL; 443 int head_gpt_valid = 0; 444 int backup_gpt_valid = 0; 445 446 if (!h_gpt_head) 447 h_gpt_head = memalign(ARCH_DMA_MINALIGN, dev_desc->blksz); 448 if (!b_gpt_head) 449 b_gpt_head = memalign(ARCH_DMA_MINALIGN, dev_desc->blksz); 450 451 head_gpt_valid = is_gpt_valid(dev_desc, GPT_PRIMARY_PARTITION_TABLE_LBA, 452 h_gpt_head, &h_gpt_pte); 453 backup_gpt_valid = is_gpt_valid(dev_desc, (dev_desc->lba - 1), 454 b_gpt_head, &b_gpt_pte); 455 if (head_gpt_valid == 1 && backup_gpt_valid == 0) { 456 if (part_efi_repair(dev_desc, h_gpt_pte, h_gpt_head, 457 head_gpt_valid, backup_gpt_valid)) 458 printf("Backup GPT repair fail!\n"); 459 } else if (head_gpt_valid == 0 && backup_gpt_valid == 1) { 460 if (part_efi_repair(dev_desc, b_gpt_pte, b_gpt_head, 461 head_gpt_valid, backup_gpt_valid)) 462 printf("Primary GPT repair fail!\n"); 463 } 464 free(h_gpt_pte); 465 h_gpt_pte = NULL; 466 free(h_gpt_head); 467 h_gpt_head = NULL; 468 free(b_gpt_pte); 469 b_gpt_pte = NULL; 470 free(b_gpt_head); 471 b_gpt_head = NULL; 472 #endif 473 return 0; 474 } 475 476 /** 477 * set_protective_mbr(): Set the EFI protective MBR 478 * @param dev_desc - block device descriptor 479 * 480 * @return - zero on success, otherwise error 481 */ 482 static int set_protective_mbr(struct blk_desc *dev_desc) 483 { 484 /* Setup the Protective MBR */ 485 ALLOC_CACHE_ALIGN_BUFFER(legacy_mbr, p_mbr, 1); 486 memset(p_mbr, 0, sizeof(*p_mbr)); 487 488 if (p_mbr == NULL) { 489 printf("%s: calloc failed!\n", __func__); 490 return -1; 491 } 492 493 /* Read MBR to backup boot code if it exists */ 494 if (blk_dread(dev_desc, 0, 1, p_mbr) != 1) { 495 pr_err("** Can't read from device %d **\n", dev_desc->devnum); 496 return -1; 497 } 498 499 /* Append signature */ 500 p_mbr->signature = MSDOS_MBR_SIGNATURE; 501 p_mbr->partition_record[0].sys_ind = EFI_PMBR_OSTYPE_EFI_GPT; 502 p_mbr->partition_record[0].start_sect = 1; 503 p_mbr->partition_record[0].nr_sects = (u32) dev_desc->lba - 1; 504 505 /* Write MBR sector to the MMC device */ 506 if (blk_dwrite(dev_desc, 0, 1, p_mbr) != 1) { 507 printf("** Can't write to device %d **\n", 508 dev_desc->devnum); 509 return -1; 510 } 511 512 return 0; 513 } 514 515 int write_gpt_table(struct blk_desc *dev_desc, 516 gpt_header *gpt_h, gpt_entry *gpt_e) 517 { 518 const int pte_blk_cnt = BLOCK_CNT((gpt_h->num_partition_entries 519 * sizeof(gpt_entry)), dev_desc); 520 u32 calc_crc32; 521 522 debug("max lba: %x\n", (u32) dev_desc->lba); 523 /* Setup the Protective MBR */ 524 if (set_protective_mbr(dev_desc) < 0) 525 goto err; 526 527 /* Generate CRC for the Primary GPT Header */ 528 calc_crc32 = efi_crc32((const unsigned char *)gpt_e, 529 le32_to_cpu(gpt_h->num_partition_entries) * 530 le32_to_cpu(gpt_h->sizeof_partition_entry)); 531 gpt_h->partition_entry_array_crc32 = cpu_to_le32(calc_crc32); 532 533 calc_crc32 = efi_crc32((const unsigned char *)gpt_h, 534 le32_to_cpu(gpt_h->header_size)); 535 gpt_h->header_crc32 = cpu_to_le32(calc_crc32); 536 537 /* Write the First GPT to the block right after the Legacy MBR */ 538 if (blk_dwrite(dev_desc, 1, 1, gpt_h) != 1) 539 goto err; 540 541 if (blk_dwrite(dev_desc, le64_to_cpu(gpt_h->partition_entry_lba), 542 pte_blk_cnt, gpt_e) != pte_blk_cnt) 543 goto err; 544 545 prepare_backup_gpt_header(gpt_h); 546 547 if (blk_dwrite(dev_desc, (lbaint_t)le64_to_cpu(gpt_h->last_usable_lba) 548 + 1, pte_blk_cnt, gpt_e) != pte_blk_cnt) 549 goto err; 550 551 if (blk_dwrite(dev_desc, (lbaint_t)le64_to_cpu(gpt_h->my_lba), 1, 552 gpt_h) != 1) 553 goto err; 554 555 debug("GPT successfully written to block device!\n"); 556 return 0; 557 558 err: 559 printf("** Can't write to device %d **\n", dev_desc->devnum); 560 return -1; 561 } 562 563 int gpt_fill_pte(struct blk_desc *dev_desc, 564 gpt_header *gpt_h, gpt_entry *gpt_e, 565 disk_partition_t *partitions, int parts) 566 { 567 lbaint_t offset = (lbaint_t)le64_to_cpu(gpt_h->first_usable_lba); 568 lbaint_t last_usable_lba = (lbaint_t) 569 le64_to_cpu(gpt_h->last_usable_lba); 570 int i, k; 571 size_t efiname_len, dosname_len; 572 #if CONFIG_IS_ENABLED(PARTITION_UUIDS) 573 char *str_uuid; 574 unsigned char *bin_uuid; 575 #endif 576 #ifdef CONFIG_PARTITION_TYPE_GUID 577 char *str_type_guid; 578 unsigned char *bin_type_guid; 579 #endif 580 size_t hdr_start = gpt_h->my_lba; 581 size_t hdr_end = hdr_start + 1; 582 583 size_t pte_start = gpt_h->partition_entry_lba; 584 size_t pte_end = pte_start + 585 gpt_h->num_partition_entries * gpt_h->sizeof_partition_entry / 586 dev_desc->blksz; 587 588 for (i = 0; i < parts; i++) { 589 /* partition starting lba */ 590 lbaint_t start = partitions[i].start; 591 lbaint_t size = partitions[i].size; 592 593 if (start) { 594 offset = start + size; 595 } else { 596 start = offset; 597 offset += size; 598 } 599 600 /* 601 * If our partition overlaps with either the GPT 602 * header, or the partition entry, reject it. 603 */ 604 if (((start < hdr_end && hdr_start < (start + size)) || 605 (start < pte_end && pte_start < (start + size)))) { 606 printf("Partition overlap\n"); 607 return -1; 608 } 609 610 gpt_e[i].starting_lba = cpu_to_le64(start); 611 612 if (offset > (last_usable_lba + 1)) { 613 printf("Partitions layout exceds disk size\n"); 614 return -1; 615 } 616 /* partition ending lba */ 617 if ((i == parts - 1) && (size == 0)) 618 /* extend the last partition to maximuim */ 619 gpt_e[i].ending_lba = gpt_h->last_usable_lba; 620 else 621 gpt_e[i].ending_lba = cpu_to_le64(offset - 1); 622 623 #ifdef CONFIG_PARTITION_TYPE_GUID 624 str_type_guid = partitions[i].type_guid; 625 bin_type_guid = gpt_e[i].partition_type_guid.b; 626 if (strlen(str_type_guid)) { 627 if (uuid_str_to_bin(str_type_guid, bin_type_guid, 628 UUID_STR_FORMAT_GUID)) { 629 printf("Partition no. %d: invalid type guid: %s\n", 630 i, str_type_guid); 631 return -1; 632 } 633 } else { 634 /* default partition type GUID */ 635 memcpy(bin_type_guid, 636 &PARTITION_BASIC_DATA_GUID, 16); 637 } 638 #else 639 /* partition type GUID */ 640 memcpy(gpt_e[i].partition_type_guid.b, 641 &PARTITION_BASIC_DATA_GUID, 16); 642 #endif 643 644 #if CONFIG_IS_ENABLED(PARTITION_UUIDS) 645 str_uuid = partitions[i].uuid; 646 bin_uuid = gpt_e[i].unique_partition_guid.b; 647 648 if (uuid_str_to_bin(str_uuid, bin_uuid, UUID_STR_FORMAT_GUID)) { 649 printf("Partition no. %d: invalid guid: %s\n", 650 i, str_uuid); 651 return -1; 652 } 653 #endif 654 655 /* partition attributes */ 656 memset(&gpt_e[i].attributes, 0, 657 sizeof(gpt_entry_attributes)); 658 659 if (partitions[i].bootable) 660 gpt_e[i].attributes.fields.legacy_bios_bootable = 1; 661 662 /* partition name */ 663 efiname_len = sizeof(gpt_e[i].partition_name) 664 / sizeof(efi_char16_t); 665 dosname_len = sizeof(partitions[i].name); 666 667 memset(gpt_e[i].partition_name, 0, 668 sizeof(gpt_e[i].partition_name)); 669 670 for (k = 0; k < min(dosname_len, efiname_len); k++) 671 gpt_e[i].partition_name[k] = 672 (efi_char16_t)(partitions[i].name[k]); 673 674 debug("%s: name: %s offset[%d]: 0x" LBAF 675 " size[%d]: 0x" LBAF "\n", 676 __func__, partitions[i].name, i, 677 offset, i, size); 678 } 679 680 return 0; 681 } 682 683 static uint32_t partition_entries_offset(struct blk_desc *dev_desc) 684 { 685 uint32_t offset_blks = 2; 686 uint32_t __maybe_unused offset_bytes; 687 int __maybe_unused config_offset; 688 689 #if defined(CONFIG_EFI_PARTITION_ENTRIES_OFF) 690 /* 691 * Some architectures require their SPL loader at a fixed 692 * address within the first 16KB of the disk. To avoid an 693 * overlap with the partition entries of the EFI partition 694 * table, the first safe offset (in bytes, from the start of 695 * the disk) for the entries can be set in 696 * CONFIG_EFI_PARTITION_ENTRIES_OFF. 697 */ 698 offset_bytes = 699 PAD_TO_BLOCKSIZE(CONFIG_EFI_PARTITION_ENTRIES_OFF, dev_desc); 700 offset_blks = offset_bytes / dev_desc->blksz; 701 #endif 702 703 #if defined(CONFIG_OF_CONTROL) 704 /* 705 * Allow the offset of the first partition entires (in bytes 706 * from the start of the device) to be specified as a property 707 * of the device tree '/config' node. 708 */ 709 config_offset = fdtdec_get_config_int(gd->fdt_blob, 710 "u-boot,efi-partition-entries-offset", 711 -EINVAL); 712 if (config_offset != -EINVAL) { 713 offset_bytes = PAD_TO_BLOCKSIZE(config_offset, dev_desc); 714 offset_blks = offset_bytes / dev_desc->blksz; 715 } 716 #endif 717 718 debug("efi: partition entries offset (in blocks): %d\n", offset_blks); 719 720 /* 721 * The earliest LBA this can be at is LBA#2 (i.e. right behind 722 * the (protective) MBR and the GPT header. 723 */ 724 if (offset_blks < 2) 725 offset_blks = 2; 726 727 return offset_blks; 728 } 729 730 int gpt_fill_header(struct blk_desc *dev_desc, gpt_header *gpt_h, 731 char *str_guid, int parts_count) 732 { 733 gpt_h->signature = cpu_to_le64(GPT_HEADER_SIGNATURE); 734 gpt_h->revision = cpu_to_le32(GPT_HEADER_REVISION_V1); 735 gpt_h->header_size = cpu_to_le32(sizeof(gpt_header)); 736 gpt_h->my_lba = cpu_to_le64(1); 737 gpt_h->alternate_lba = cpu_to_le64(dev_desc->lba - 1); 738 gpt_h->last_usable_lba = cpu_to_le64(dev_desc->lba - 34); 739 gpt_h->partition_entry_lba = 740 cpu_to_le64(partition_entries_offset(dev_desc)); 741 gpt_h->first_usable_lba = 742 cpu_to_le64(le64_to_cpu(gpt_h->partition_entry_lba) + 32); 743 gpt_h->num_partition_entries = cpu_to_le32(GPT_ENTRY_NUMBERS); 744 gpt_h->sizeof_partition_entry = cpu_to_le32(sizeof(gpt_entry)); 745 gpt_h->header_crc32 = 0; 746 gpt_h->partition_entry_array_crc32 = 0; 747 748 if (uuid_str_to_bin(str_guid, gpt_h->disk_guid.b, UUID_STR_FORMAT_GUID)) 749 return -1; 750 751 return 0; 752 } 753 754 int gpt_restore(struct blk_desc *dev_desc, char *str_disk_guid, 755 disk_partition_t *partitions, int parts_count) 756 { 757 gpt_header *gpt_h; 758 gpt_entry *gpt_e; 759 int ret, size; 760 761 size = PAD_TO_BLOCKSIZE(sizeof(gpt_header), dev_desc); 762 gpt_h = malloc_cache_aligned(size); 763 if (gpt_h == NULL) { 764 printf("%s: calloc failed!\n", __func__); 765 return -1; 766 } 767 memset(gpt_h, 0, size); 768 769 size = PAD_TO_BLOCKSIZE(GPT_ENTRY_NUMBERS * sizeof(gpt_entry), 770 dev_desc); 771 gpt_e = malloc_cache_aligned(size); 772 if (gpt_e == NULL) { 773 printf("%s: calloc failed!\n", __func__); 774 free(gpt_h); 775 return -1; 776 } 777 memset(gpt_e, 0, size); 778 779 /* Generate Primary GPT header (LBA1) */ 780 ret = gpt_fill_header(dev_desc, gpt_h, str_disk_guid, parts_count); 781 if (ret) 782 goto err; 783 784 /* Generate partition entries */ 785 ret = gpt_fill_pte(dev_desc, gpt_h, gpt_e, partitions, parts_count); 786 if (ret) 787 goto err; 788 789 /* Write GPT partition table */ 790 ret = write_gpt_table(dev_desc, gpt_h, gpt_e); 791 792 err: 793 free(gpt_e); 794 free(gpt_h); 795 return ret; 796 } 797 798 static void gpt_convert_efi_name_to_char(char *s, efi_char16_t *es, int n) 799 { 800 char *ess = (char *)es; 801 int i, j; 802 803 memset(s, '\0', n); 804 805 for (i = 0, j = 0; j < n; i += 2, j++) { 806 s[j] = ess[i]; 807 if (!ess[i]) 808 return; 809 } 810 } 811 812 int gpt_verify_headers(struct blk_desc *dev_desc, gpt_header *gpt_head, 813 gpt_entry **gpt_pte) 814 { 815 /* 816 * This function validates AND 817 * fills in the GPT header and PTE 818 */ 819 if (is_gpt_valid(dev_desc, 820 GPT_PRIMARY_PARTITION_TABLE_LBA, 821 gpt_head, gpt_pte) != 1) { 822 printf("%s: *** ERROR: Invalid GPT ***\n", 823 __func__); 824 return -1; 825 } 826 if (is_gpt_valid(dev_desc, (dev_desc->lba - 1), 827 gpt_head, gpt_pte) != 1) { 828 printf("%s: *** ERROR: Invalid Backup GPT ***\n", 829 __func__); 830 return -1; 831 } 832 833 return 0; 834 } 835 836 int gpt_verify_partitions(struct blk_desc *dev_desc, 837 disk_partition_t *partitions, int parts, 838 gpt_header *gpt_head, gpt_entry **gpt_pte) 839 { 840 char efi_str[PARTNAME_SZ + 1]; 841 u64 gpt_part_size; 842 gpt_entry *gpt_e; 843 int ret, i; 844 845 ret = gpt_verify_headers(dev_desc, gpt_head, gpt_pte); 846 if (ret) 847 return ret; 848 849 gpt_e = *gpt_pte; 850 851 for (i = 0; i < parts; i++) { 852 if (i == gpt_head->num_partition_entries) { 853 pr_err("More partitions than allowed!\n"); 854 return -1; 855 } 856 857 /* Check if GPT and ENV partition names match */ 858 gpt_convert_efi_name_to_char(efi_str, gpt_e[i].partition_name, 859 PARTNAME_SZ + 1); 860 861 debug("%s: part: %2d name - GPT: %16s, ENV: %16s ", 862 __func__, i, efi_str, partitions[i].name); 863 864 if (strncmp(efi_str, (char *)partitions[i].name, 865 sizeof(partitions->name))) { 866 pr_err("Partition name: %s does not match %s!\n", 867 efi_str, (char *)partitions[i].name); 868 return -1; 869 } 870 871 /* Check if GPT and ENV sizes match */ 872 gpt_part_size = le64_to_cpu(gpt_e[i].ending_lba) - 873 le64_to_cpu(gpt_e[i].starting_lba) + 1; 874 debug("size(LBA) - GPT: %8llu, ENV: %8llu ", 875 (unsigned long long)gpt_part_size, 876 (unsigned long long)partitions[i].size); 877 878 if (le64_to_cpu(gpt_part_size) != partitions[i].size) { 879 /* We do not check the extend partition size */ 880 if ((i == parts - 1) && (partitions[i].size == 0)) 881 continue; 882 883 pr_err("Partition %s size: %llu does not match %llu!\n", 884 efi_str, (unsigned long long)gpt_part_size, 885 (unsigned long long)partitions[i].size); 886 return -1; 887 } 888 889 /* 890 * Start address is optional - check only if provided 891 * in '$partition' variable 892 */ 893 if (!partitions[i].start) { 894 debug("\n"); 895 continue; 896 } 897 898 /* Check if GPT and ENV start LBAs match */ 899 debug("start LBA - GPT: %8llu, ENV: %8llu\n", 900 le64_to_cpu(gpt_e[i].starting_lba), 901 (unsigned long long)partitions[i].start); 902 903 if (le64_to_cpu(gpt_e[i].starting_lba) != partitions[i].start) { 904 pr_err("Partition %s start: %llu does not match %llu!\n", 905 efi_str, le64_to_cpu(gpt_e[i].starting_lba), 906 (unsigned long long)partitions[i].start); 907 return -1; 908 } 909 } 910 911 return 0; 912 } 913 914 int is_valid_gpt_buf(struct blk_desc *dev_desc, void *buf) 915 { 916 gpt_header *gpt_h; 917 gpt_entry *gpt_e; 918 919 /* determine start of GPT Header in the buffer */ 920 gpt_h = buf + (GPT_PRIMARY_PARTITION_TABLE_LBA * 921 dev_desc->blksz); 922 923 if ((le64_to_cpu(gpt_h->alternate_lba) + 1) 924 != cpu_to_le64(dev_desc->lba)) { 925 printf("%s: failed checking '%s'\n", __func__, 926 "invalid GPT Disk Size"); 927 return -1; 928 } 929 930 if (validate_gpt_header(gpt_h, GPT_PRIMARY_PARTITION_TABLE_LBA, 931 dev_desc->lba)) 932 return -1; 933 934 /* determine start of GPT Entries in the buffer */ 935 gpt_e = buf + (le64_to_cpu(gpt_h->partition_entry_lba) * 936 dev_desc->blksz); 937 if (validate_gpt_entries(gpt_h, gpt_e)) 938 return -1; 939 940 return 0; 941 } 942 943 int write_mbr_and_gpt_partitions(struct blk_desc *dev_desc, void *buf) 944 { 945 gpt_header *gpt_h; 946 gpt_entry *gpt_e; 947 int gpt_e_blk_cnt; 948 lbaint_t lba; 949 int cnt; 950 951 if (is_valid_gpt_buf(dev_desc, buf)) 952 return -1; 953 954 /* determine start of GPT Header in the buffer */ 955 gpt_h = buf + (GPT_PRIMARY_PARTITION_TABLE_LBA * 956 dev_desc->blksz); 957 958 /* determine start of GPT Entries in the buffer */ 959 gpt_e = buf + (le64_to_cpu(gpt_h->partition_entry_lba) * 960 dev_desc->blksz); 961 gpt_e_blk_cnt = BLOCK_CNT((le32_to_cpu(gpt_h->num_partition_entries) * 962 le32_to_cpu(gpt_h->sizeof_partition_entry)), 963 dev_desc); 964 965 /* write MBR */ 966 lba = 0; /* MBR is always at 0 */ 967 cnt = 1; /* MBR (1 block) */ 968 if (blk_dwrite(dev_desc, lba, cnt, buf) != cnt) { 969 printf("%s: failed writing '%s' (%d blks at 0x" LBAF ")\n", 970 __func__, "MBR", cnt, lba); 971 return 1; 972 } 973 974 /* write Primary GPT */ 975 lba = GPT_PRIMARY_PARTITION_TABLE_LBA; 976 cnt = 1; /* GPT Header (1 block) */ 977 if (blk_dwrite(dev_desc, lba, cnt, gpt_h) != cnt) { 978 printf("%s: failed writing '%s' (%d blks at 0x" LBAF ")\n", 979 __func__, "Primary GPT Header", cnt, lba); 980 return 1; 981 } 982 983 lba = le64_to_cpu(gpt_h->partition_entry_lba); 984 cnt = gpt_e_blk_cnt; 985 if (blk_dwrite(dev_desc, lba, cnt, gpt_e) != cnt) { 986 printf("%s: failed writing '%s' (%d blks at 0x" LBAF ")\n", 987 __func__, "Primary GPT Entries", cnt, lba); 988 return 1; 989 } 990 991 prepare_backup_gpt_header(gpt_h); 992 993 /* write Backup GPT */ 994 lba = le64_to_cpu(gpt_h->partition_entry_lba); 995 cnt = gpt_e_blk_cnt; 996 if (blk_dwrite(dev_desc, lba, cnt, gpt_e) != cnt) { 997 printf("%s: failed writing '%s' (%d blks at 0x" LBAF ")\n", 998 __func__, "Backup GPT Entries", cnt, lba); 999 return 1; 1000 } 1001 1002 lba = le64_to_cpu(gpt_h->my_lba); 1003 cnt = 1; /* GPT Header (1 block) */ 1004 if (blk_dwrite(dev_desc, lba, cnt, gpt_h) != cnt) { 1005 printf("%s: failed writing '%s' (%d blks at 0x" LBAF ")\n", 1006 __func__, "Backup GPT Header", cnt, lba); 1007 return 1; 1008 } 1009 1010 return 0; 1011 } 1012 #endif 1013 1014 /* 1015 * Private functions 1016 */ 1017 /* 1018 * pmbr_part_valid(): Check for EFI partition signature 1019 * 1020 * Returns: 1 if EFI GPT partition type is found. 1021 */ 1022 static int pmbr_part_valid(struct partition *part) 1023 { 1024 if (part->sys_ind == EFI_PMBR_OSTYPE_EFI_GPT && 1025 get_unaligned_le32(&part->start_sect) == 1UL) { 1026 return 1; 1027 } 1028 1029 return 0; 1030 } 1031 1032 /* 1033 * is_pmbr_valid(): test Protective MBR for validity 1034 * 1035 * Returns: 1 if PMBR is valid, 0 otherwise. 1036 * Validity depends on two things: 1037 * 1) MSDOS signature is in the last two bytes of the MBR 1038 * 2) One partition of type 0xEE is found, checked by pmbr_part_valid() 1039 */ 1040 static int is_pmbr_valid(legacy_mbr * mbr) 1041 { 1042 int i = 0; 1043 1044 if (!mbr || le16_to_cpu(mbr->signature) != MSDOS_MBR_SIGNATURE) 1045 return 0; 1046 1047 for (i = 0; i < 4; i++) { 1048 if (pmbr_part_valid(&mbr->partition_record[i])) { 1049 return 1; 1050 } 1051 } 1052 return 0; 1053 } 1054 1055 /** 1056 * is_gpt_valid() - tests one GPT header and PTEs for validity 1057 * 1058 * lba is the logical block address of the GPT header to test 1059 * gpt is a GPT header ptr, filled on return. 1060 * ptes is a PTEs ptr, filled on return. 1061 * 1062 * Description: returns 1 if valid, 0 on error. 1063 * If valid, returns pointers to PTEs. 1064 */ 1065 static int is_gpt_valid(struct blk_desc *dev_desc, u64 lba, 1066 gpt_header *pgpt_head, gpt_entry **pgpt_pte) 1067 { 1068 /* Confirm valid arguments prior to allocation. */ 1069 if (!dev_desc || !pgpt_head) { 1070 printf("%s: Invalid Argument(s)\n", __func__); 1071 return 0; 1072 } 1073 1074 /* Re-use pte if it's not NULL */ 1075 if (*pgpt_pte) 1076 return 1; 1077 1078 ALLOC_CACHE_ALIGN_BUFFER(legacy_mbr, mbr, dev_desc->blksz); 1079 1080 /* Read MBR Header from device */ 1081 if (blk_dread(dev_desc, 0, 1, (ulong *)mbr) != 1) { 1082 printf("*** ERROR: Can't read MBR header ***\n"); 1083 return 0; 1084 } 1085 1086 /* Read GPT Header from device */ 1087 if (blk_dread(dev_desc, (lbaint_t)lba, 1, pgpt_head) != 1) { 1088 printf("*** ERROR: Can't read GPT header ***\n"); 1089 return 0; 1090 } 1091 1092 if (validate_gpt_header(pgpt_head, (lbaint_t)lba, dev_desc->lba)) 1093 return 0; 1094 1095 if (dev_desc->sig_type == SIG_TYPE_NONE) { 1096 efi_guid_t empty = {}; 1097 if (memcmp(&pgpt_head->disk_guid, &empty, sizeof(empty))) { 1098 dev_desc->sig_type = SIG_TYPE_GUID; 1099 memcpy(&dev_desc->guid_sig, &pgpt_head->disk_guid, 1100 sizeof(empty)); 1101 } else if (mbr->unique_mbr_signature != 0) { 1102 dev_desc->sig_type = SIG_TYPE_MBR; 1103 dev_desc->mbr_sig = mbr->unique_mbr_signature; 1104 } 1105 } 1106 1107 /* Read and allocate Partition Table Entries */ 1108 *pgpt_pte = alloc_read_gpt_entries(dev_desc, pgpt_head); 1109 if (*pgpt_pte == NULL) { 1110 printf("GPT: Failed to allocate memory for PTE\n"); 1111 return 0; 1112 } 1113 1114 if (validate_gpt_entries(pgpt_head, *pgpt_pte)) { 1115 free(*pgpt_pte); 1116 *pgpt_pte = NULL; 1117 return 0; 1118 } 1119 1120 /* We're done, all's well */ 1121 return 1; 1122 } 1123 1124 /** 1125 * alloc_read_gpt_entries(): reads partition entries from disk 1126 * @dev_desc 1127 * @gpt - GPT header 1128 * 1129 * Description: Returns ptes on success, NULL on error. 1130 * Allocates space for PTEs based on information found in @gpt. 1131 * Notes: remember to free pte when you're done! 1132 */ 1133 static gpt_entry *alloc_read_gpt_entries(struct blk_desc *dev_desc, 1134 gpt_header *pgpt_head) 1135 { 1136 size_t count = 0, blk_cnt; 1137 lbaint_t blk; 1138 gpt_entry *pte = NULL; 1139 1140 if (!dev_desc || !pgpt_head) { 1141 printf("%s: Invalid Argument(s)\n", __func__); 1142 return NULL; 1143 } 1144 1145 count = le32_to_cpu(pgpt_head->num_partition_entries) * 1146 le32_to_cpu(pgpt_head->sizeof_partition_entry); 1147 1148 debug("%s: count = %u * %u = %lu\n", __func__, 1149 (u32) le32_to_cpu(pgpt_head->num_partition_entries), 1150 (u32) le32_to_cpu(pgpt_head->sizeof_partition_entry), 1151 (ulong)count); 1152 1153 /* Allocate memory for PTE, remember to FREE */ 1154 if (count != 0) { 1155 pte = memalign(ARCH_DMA_MINALIGN, 1156 PAD_TO_BLOCKSIZE(count, dev_desc)); 1157 } 1158 1159 if (count == 0 || pte == NULL) { 1160 printf("%s: ERROR: Can't allocate %#lX bytes for GPT Entries\n", 1161 __func__, (ulong)count); 1162 return NULL; 1163 } 1164 1165 /* Read GPT Entries from device */ 1166 blk = le64_to_cpu(pgpt_head->partition_entry_lba); 1167 blk_cnt = BLOCK_CNT(count, dev_desc); 1168 if (blk_dread(dev_desc, blk, (lbaint_t)blk_cnt, pte) != blk_cnt) { 1169 printf("*** ERROR: Can't read GPT Entries ***\n"); 1170 free(pte); 1171 return NULL; 1172 } 1173 return pte; 1174 } 1175 1176 /** 1177 * is_pte_valid(): validates a single Partition Table Entry 1178 * @gpt_entry - Pointer to a single Partition Table Entry 1179 * 1180 * Description: returns 1 if valid, 0 on error. 1181 */ 1182 static int is_pte_valid(gpt_entry * pte) 1183 { 1184 efi_guid_t unused_guid; 1185 1186 if (!pte) { 1187 printf("%s: Invalid Argument(s)\n", __func__); 1188 return 0; 1189 } 1190 1191 /* Only one validation for now: 1192 * The GUID Partition Type != Unused Entry (ALL-ZERO) 1193 */ 1194 memset(unused_guid.b, 0, sizeof(unused_guid.b)); 1195 1196 if (memcmp(pte->partition_type_guid.b, unused_guid.b, 1197 sizeof(unused_guid.b)) == 0) { 1198 1199 debug("%s: Found an unused PTE GUID at 0x%08X\n", __func__, 1200 (unsigned int)(uintptr_t)pte); 1201 1202 return 0; 1203 } else { 1204 return 1; 1205 } 1206 } 1207 1208 /* 1209 * Add an 'a_' prefix so it comes before 'dos' in the linker list. We need to 1210 * check EFI first, since a DOS partition is often used as a 'protective MBR' 1211 * with EFI. 1212 */ 1213 U_BOOT_PART_TYPE(a_efi) = { 1214 .name = "EFI", 1215 .part_type = PART_TYPE_EFI, 1216 .max_entries = GPT_ENTRY_NUMBERS, 1217 .get_info = part_get_info_ptr(part_get_info_efi), 1218 .print = part_print_ptr(part_print_efi), 1219 .test = part_test_efi, 1220 }; 1221 #endif 1222