1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (C) 2019 Namjae Jeon <linkinjeon@kernel.org>
11 #include <sys/types.h>
13 #include <sys/ioctl.h>
22 #include "exfat_ondisk.h"
26 struct exfat_mkfs_info finfo;
28 /* random serial generator based on current time */
29 static unsigned int get_new_serial(void)
33 if (clock_gettime(CLOCK_REALTIME, &ts)) {
34 /* set 0000-0000 on error */
39 return (unsigned int)(ts.tv_nsec << 12 | ts.tv_sec);
42 static void exfat_setup_boot_sector(struct pbr *ppbr,
43 struct exfat_blk_dev *bd, struct exfat_user_input *ui)
45 struct bpb64 *pbpb = &ppbr->bpb;
46 struct bsx64 *pbsx = &ppbr->bsx;
49 /* Fill exfat BIOS parameter block */
50 pbpb->jmp_boot[0] = 0xeb;
51 pbpb->jmp_boot[1] = 0x76;
52 pbpb->jmp_boot[2] = 0x90;
53 memcpy(pbpb->oem_name, "EXFAT ", 8);
54 memset(pbpb->res_zero, 0, 53);
56 /* Fill exfat extend BIOS parameter block */
57 pbsx->vol_offset = cpu_to_le64(bd->offset / bd->sector_size);
58 pbsx->vol_length = cpu_to_le64(bd->size / bd->sector_size);
59 pbsx->fat_offset = cpu_to_le32(finfo.fat_byte_off / bd->sector_size);
60 pbsx->fat_length = cpu_to_le32(finfo.fat_byte_len / bd->sector_size);
61 pbsx->clu_offset = cpu_to_le32(finfo.clu_byte_off / bd->sector_size);
62 pbsx->clu_count = cpu_to_le32(finfo.total_clu_cnt);
63 pbsx->root_cluster = cpu_to_le32(finfo.root_start_clu);
64 pbsx->vol_serial = cpu_to_le32(finfo.volume_serial);
66 pbsx->sect_size_bits = bd->sector_size_bits;
67 pbsx->sect_per_clus_bits = 0;
68 /* Compute base 2 logarithm of ui->cluster_size / bd->sector_size */
69 for (i = ui->cluster_size / bd->sector_size; i > 1; i /= 2)
70 pbsx->sect_per_clus_bits++;
72 /* fs_version[0] : minor and fs_version[1] : major */
73 pbsx->fs_version[0] = 0;
74 pbsx->fs_version[1] = 1;
75 pbsx->phy_drv_no = 0x80;
76 memset(pbsx->reserved2, 0, 7);
78 memset(ppbr->boot_code, 0, 390);
79 ppbr->signature = cpu_to_le16(PBR_SIGNATURE);
81 exfat_debug("Volume Offset(sectors) : %" PRIu64 "\n",
82 le64_to_cpu(pbsx->vol_offset));
83 exfat_debug("Volume Length(sectors) : %" PRIu64 "\n",
84 le64_to_cpu(pbsx->vol_length));
85 exfat_debug("FAT Offset(sector offset) : %u\n",
86 le32_to_cpu(pbsx->fat_offset));
87 exfat_debug("FAT Length(sectors) : %u\n",
88 le32_to_cpu(pbsx->fat_length));
89 exfat_debug("Cluster Heap Offset (sector offset) : %u\n",
90 le32_to_cpu(pbsx->clu_offset));
91 exfat_debug("Cluster Count : %u\n",
92 le32_to_cpu(pbsx->clu_count));
93 exfat_debug("Root Cluster (cluster offset) : %u\n",
94 le32_to_cpu(pbsx->root_cluster));
95 exfat_debug("Volume Serial : 0x%x\n", le32_to_cpu(pbsx->vol_serial));
96 exfat_debug("Sector Size Bits : %u\n",
97 pbsx->sect_size_bits);
98 exfat_debug("Sector per Cluster bits : %u\n",
99 pbsx->sect_per_clus_bits);
102 static int exfat_write_boot_sector(struct exfat_blk_dev *bd,
103 struct exfat_user_input *ui, unsigned int *checksum,
107 unsigned int sec_idx = BOOT_SEC_IDX;
111 sec_idx += BACKUP_BOOT_SEC_IDX;
113 ppbr = malloc(bd->sector_size);
115 exfat_err("Cannot allocate pbr: out of memory\n");
118 memset(ppbr, 0, bd->sector_size);
120 exfat_setup_boot_sector(ppbr, bd, ui);
122 /* write main boot sector */
123 ret = exfat_write_sector(bd, ppbr, sec_idx);
125 exfat_err("main boot sector write failed\n");
130 boot_calc_checksum((unsigned char *)ppbr, bd->sector_size,
138 static int exfat_write_extended_boot_sectors(struct exfat_blk_dev *bd,
139 unsigned int *checksum, bool is_backup)
142 __le16 *peb_signature;
145 unsigned int sec_idx = EXBOOT_SEC_IDX;
147 peb = malloc(bd->sector_size);
152 sec_idx += BACKUP_BOOT_SEC_IDX;
154 memset(peb, 0, bd->sector_size);
155 peb_signature = (__le16*) (peb + bd->sector_size - 2);
156 *peb_signature = cpu_to_le16(PBR_SIGNATURE);
157 for (i = 0; i < EXBOOT_SEC_NUM; i++) {
158 if (exfat_write_sector(bd, peb, sec_idx++)) {
159 exfat_err("extended boot sector write failed\n");
164 boot_calc_checksum((unsigned char *) peb, bd->sector_size,
173 static int exfat_write_oem_sector(struct exfat_blk_dev *bd,
174 unsigned int *checksum, bool is_backup)
178 unsigned int sec_idx = OEM_SEC_IDX;
180 oem = calloc(1, bd->sector_size);
185 sec_idx += BACKUP_BOOT_SEC_IDX;
187 ret = exfat_write_sector(bd, oem, sec_idx);
189 exfat_err("oem sector write failed\n");
194 boot_calc_checksum((unsigned char *)oem, bd->sector_size, false,
197 /* Reuse zeroed out oem sector for reserved sector */
198 ret = exfat_write_sector(bd, oem, sec_idx + 1);
200 exfat_err("reserved sector write failed\n");
205 boot_calc_checksum((unsigned char *)oem, bd->sector_size, false,
213 static int exfat_create_volume_boot_record(struct exfat_blk_dev *bd,
214 struct exfat_user_input *ui, bool is_backup)
216 unsigned int checksum = 0;
219 ret = exfat_write_boot_sector(bd, ui, &checksum, is_backup);
222 ret = exfat_write_extended_boot_sectors(bd, &checksum, is_backup);
225 ret = exfat_write_oem_sector(bd, &checksum, is_backup);
229 return exfat_write_checksum_sector(bd, checksum, is_backup);
232 static int write_fat_entry(int fd, __le32 clu,
233 unsigned long long offset)
236 off_t fat_entry_offset = finfo.fat_byte_off + (offset * sizeof(__le32));
238 nbyte = pwrite(fd, (__u8 *) &clu, sizeof(__le32), fat_entry_offset);
239 if (nbyte != sizeof(int)) {
240 exfat_err("write failed, offset : %llu, clu : %x\n",
248 static int write_fat_entries(struct exfat_user_input *ui, int fd,
249 unsigned int clu, unsigned int length)
254 count = clu + round_up(length, ui->cluster_size) / ui->cluster_size;
256 for (; clu < count - 1; clu++) {
257 ret = write_fat_entry(fd, cpu_to_le32(clu + 1), clu);
262 ret = write_fat_entry(fd, cpu_to_le32(EXFAT_EOF_CLUSTER), clu);
269 static int exfat_create_fat_table(struct exfat_blk_dev *bd,
270 struct exfat_user_input *ui)
274 /* fat entry 0 should be media type field(0xF8) */
275 ret = write_fat_entry(bd->dev_fd, cpu_to_le32(0xfffffff8), 0);
277 exfat_err("fat 0 entry write failed\n");
281 /* fat entry 1 is historical precedence(0xFFFFFFFF) */
282 ret = write_fat_entry(bd->dev_fd, cpu_to_le32(0xffffffff), 1);
284 exfat_err("fat 1 entry write failed\n");
288 /* write bitmap entries */
289 clu = write_fat_entries(ui, bd->dev_fd, EXFAT_FIRST_CLUSTER,
290 finfo.bitmap_byte_len);
294 /* write upcase table entries */
295 clu = write_fat_entries(ui, bd->dev_fd, clu + 1, finfo.ut_byte_len);
299 /* write root directory entries */
300 clu = write_fat_entries(ui, bd->dev_fd, clu + 1, finfo.root_byte_len);
304 finfo.used_clu_cnt = clu + 1 - EXFAT_FIRST_CLUSTER;
305 exfat_debug("Total used cluster count : %d\n", finfo.used_clu_cnt);
310 static int exfat_create_bitmap(struct exfat_blk_dev *bd)
313 unsigned int full_bytes, rem_bits, zero_offset;
316 bitmap = malloc(finfo.bitmap_byte_len);
320 full_bytes = finfo.used_clu_cnt / 8;
321 rem_bits = finfo.used_clu_cnt % 8;
322 zero_offset = full_bytes;
324 memset(bitmap, 0xff, full_bytes);
327 bitmap[full_bytes] = (1 << rem_bits) - 1;
331 if (zero_offset < finfo.bitmap_byte_len)
332 memset(bitmap + zero_offset, 0, finfo.bitmap_byte_len - zero_offset);
335 nbytes = pwrite(bd->dev_fd, bitmap, finfo.bitmap_byte_len, finfo.bitmap_byte_off);
336 if (nbytes != finfo.bitmap_byte_len) {
337 exfat_err("write failed, nbytes : %d, bitmap_len : %d\n",
338 nbytes, finfo.bitmap_byte_len);
347 static int exfat_create_root_dir(struct exfat_blk_dev *bd,
348 struct exfat_user_input *ui)
350 struct exfat_dentry ed[4] = {0};
351 int dentries_len = sizeof(ed);
354 /* Set volume label entry */
355 ed[0].type = EXFAT_VOLUME;
356 memset(ed[0].vol_label, 0, 22);
357 memcpy(ed[0].vol_label, ui->volume_label, ui->volume_label_len);
358 ed[0].vol_char_cnt = ui->volume_label_len/2;
360 /* Set volume GUID entry */
362 if (__exfat_set_volume_guid(&ed[1], ui->guid))
366 * Since a single empty entry cannot be allocated for a
367 * file, this can reserve the entry for volume GUID.
369 ed[1].type = EXFAT_GUID & ~EXFAT_INVAL;
372 /* Set bitmap entry */
373 ed[2].type = EXFAT_BITMAP;
374 ed[2].bitmap_flags = 0;
375 ed[2].bitmap_start_clu = cpu_to_le32(EXFAT_FIRST_CLUSTER);
376 ed[2].bitmap_size = cpu_to_le64(finfo.bitmap_byte_len);
378 /* Set upcase table entry */
379 ed[3].type = EXFAT_UPCASE;
380 ed[3].upcase_checksum = cpu_to_le32(0xe619d30d);
381 ed[3].upcase_start_clu = cpu_to_le32(finfo.ut_start_clu);
382 ed[3].upcase_size = cpu_to_le64(EXFAT_UPCASE_TABLE_SIZE);
384 nbytes = pwrite(bd->dev_fd, ed, dentries_len, finfo.root_byte_off);
385 if (nbytes != dentries_len) {
386 exfat_err("write failed, nbytes : %d, dentries_len : %d\n",
387 nbytes, dentries_len);
394 static void usage(void)
396 fputs("Usage: mkfs.exfat\n"
397 "\t-L | --volume-label=label Set volume label\n"
398 "\t-U | --volume-guid=guid Set volume GUID\n"
399 "\t-s | --sector-size=size(or suffixed by 'K') Specify sector size\n"
400 "\t-c | --cluster-size=size(or suffixed by 'K' or 'M') Specify cluster size\n"
401 "\t-b | --boundary-align=size(or suffixed by 'K' or 'M') Specify boundary alignment\n"
402 "\t --pack-bitmap Move bitmap into FAT segment\n"
403 "\t-f | --full-format Full format\n"
404 "\t-V | --version Show version\n"
405 "\t-q | --quiet Print only errors\n"
406 "\t-v | --verbose Print debug\n"
407 "\t-h | --help Show help\n",
413 #define PACK_BITMAP (CHAR_MAX + 1)
415 static const struct option opts[] = {
416 {"volume-label", required_argument, NULL, 'L' },
417 {"volume-guid", required_argument, NULL, 'U' },
418 {"sector-size", required_argument, NULL, 's' },
419 {"cluster-size", required_argument, NULL, 'c' },
420 {"boundary-align", required_argument, NULL, 'b' },
421 {"pack-bitmap", no_argument, NULL, PACK_BITMAP },
422 {"full-format", no_argument, NULL, 'f' },
423 {"version", no_argument, NULL, 'V' },
424 {"quiet", no_argument, NULL, 'q' },
425 {"verbose", no_argument, NULL, 'v' },
426 {"help", no_argument, NULL, 'h' },
427 {"?", no_argument, NULL, '?' },
432 * Moves the bitmap to just before the alignment boundary if there is space
433 * between the boundary and the end of the FAT. This may allow the FAT and the
434 * bitmap to share the same allocation unit on flash media, thereby improving
435 * performance and endurance.
437 static int exfat_pack_bitmap(const struct exfat_user_input *ui)
439 unsigned int fat_byte_end = finfo.fat_byte_off + finfo.fat_byte_len,
440 bitmap_byte_len = finfo.bitmap_byte_len,
441 bitmap_clu_len = round_up(bitmap_byte_len, ui->cluster_size),
442 bitmap_clu_cnt, total_clu_cnt, new_bitmap_clu_len;
445 bitmap_clu_cnt = bitmap_clu_len / ui->cluster_size;
446 if (finfo.clu_byte_off - bitmap_clu_len < fat_byte_end ||
447 finfo.total_clu_cnt > EXFAT_MAX_NUM_CLUSTER -
450 total_clu_cnt = finfo.total_clu_cnt + bitmap_clu_cnt;
451 bitmap_byte_len = round_up(total_clu_cnt, 8) / 8;
452 new_bitmap_clu_len = round_up(bitmap_byte_len, ui->cluster_size);
453 if (new_bitmap_clu_len == bitmap_clu_len) {
454 finfo.clu_byte_off -= bitmap_clu_len;
455 finfo.total_clu_cnt = total_clu_cnt;
456 finfo.bitmap_byte_off -= bitmap_clu_len;
457 finfo.bitmap_byte_len = bitmap_byte_len;
460 bitmap_clu_len = new_bitmap_clu_len;
464 static int exfat_build_mkfs_info(struct exfat_blk_dev *bd,
465 struct exfat_user_input *ui)
467 unsigned long long total_clu_cnt;
468 unsigned long long max_clusters;
472 if (ui->cluster_size < bd->sector_size) {
473 exfat_err("cluster size (%u bytes) is smaller than sector size (%u bytes)\n",
474 ui->cluster_size, bd->sector_size);
477 if (ui->boundary_align < bd->sector_size) {
478 exfat_err("boundary alignment is too small (min %d)\n",
482 finfo.fat_byte_off = round_up(bd->offset + 24 * bd->sector_size,
483 ui->boundary_align) - bd->offset;
485 max_clusters = (bd->size - finfo.fat_byte_off - 8 * num_fats - 1) /
486 (ui->cluster_size + 4 * num_fats) + 1;
487 /* Prevent integer overflow when computing the FAT length */
488 if (max_clusters > UINT_MAX / 4 - 2) {
489 exfat_err("cluster size (%u bytes) is too small\n", ui->cluster_size);
492 finfo.fat_byte_len = round_up((max_clusters + 2) * 4, bd->sector_size);
493 finfo.clu_byte_off = round_up(bd->offset + finfo.fat_byte_off +
494 finfo.fat_byte_len * num_fats, ui->boundary_align) - bd->offset;
495 if (bd->size <= finfo.clu_byte_off) {
496 exfat_err("boundary alignment is too big\n");
499 total_clu_cnt = (bd->size - finfo.clu_byte_off) / ui->cluster_size;
500 if (total_clu_cnt > EXFAT_MAX_NUM_CLUSTER) {
501 exfat_err("cluster size is too small\n");
504 finfo.total_clu_cnt = (unsigned int) total_clu_cnt;
506 finfo.bitmap_byte_off = finfo.clu_byte_off;
507 finfo.bitmap_byte_len = round_up(finfo.total_clu_cnt, 8) / 8;
509 exfat_pack_bitmap(ui);
510 clu_len = round_up(finfo.bitmap_byte_len, ui->cluster_size);
512 finfo.ut_start_clu = EXFAT_FIRST_CLUSTER + clu_len / ui->cluster_size;
513 finfo.ut_byte_off = finfo.bitmap_byte_off + clu_len;
514 finfo.ut_byte_len = EXFAT_UPCASE_TABLE_SIZE;
515 clu_len = round_up(finfo.ut_byte_len, ui->cluster_size);
517 finfo.root_start_clu = finfo.ut_start_clu + clu_len / ui->cluster_size;
518 finfo.root_byte_off = finfo.ut_byte_off + clu_len;
519 finfo.root_byte_len = sizeof(struct exfat_dentry) * 3;
520 finfo.volume_serial = get_new_serial();
525 static int exfat_zero_out_disk(struct exfat_blk_dev *bd,
526 struct exfat_user_input *ui)
529 unsigned long long size;
532 size = finfo.root_byte_off + ui->cluster_size;
536 ret = exfat_write_zero(bd->dev_fd, size, 0);
538 exfat_err("write failed(errno : %d)\n", errno);
542 exfat_debug("zero out written size : %llu, disk size : %llu\n",
547 static int make_exfat(struct exfat_blk_dev *bd, struct exfat_user_input *ui)
551 exfat_info("Creating exFAT filesystem(%s, cluster size=%u)\n\n",
552 ui->dev_name, ui->cluster_size);
554 exfat_info("Writing volume boot record: ");
555 ret = exfat_create_volume_boot_record(bd, ui, 0);
556 exfat_info("%s\n", ret ? "failed" : "done");
560 exfat_info("Writing backup volume boot record: ");
562 ret = exfat_create_volume_boot_record(bd, ui, 1);
563 exfat_info("%s\n", ret ? "failed" : "done");
567 exfat_info("Fat table creation: ");
568 ret = exfat_create_fat_table(bd, ui);
569 exfat_info("%s\n", ret ? "failed" : "done");
573 exfat_info("Allocation bitmap creation: ");
574 ret = exfat_create_bitmap(bd);
575 exfat_info("%s\n", ret ? "failed" : "done");
579 exfat_info("Upcase table creation: ");
580 ret = exfat_create_upcase_table(bd);
581 exfat_info("%s\n", ret ? "failed" : "done");
585 exfat_info("Writing root directory entry: ");
586 ret = exfat_create_root_dir(bd, ui);
587 exfat_info("%s\n", ret ? "failed" : "done");
594 static long long parse_size(const char *size)
597 unsigned long long byte_size = strtoull(size, &data_unit, 0);
599 switch (*data_unit) {
611 exfat_err("Wrong unit input('%c') for size\n",
619 int main(int argc, char *argv[])
622 int ret = EXIT_FAILURE;
623 struct exfat_blk_dev bd;
624 struct exfat_user_input ui;
625 bool version_only = false;
628 init_user_input(&ui);
630 if (!setlocale(LC_CTYPE, ""))
631 exfat_err("failed to init locale/codeset\n");
634 while ((c = getopt_long(argc, argv, "n:L:U:s:c:b:fVqvh", opts, NULL)) != EOF)
637 * Make 'n' option fallthrough to 'L' option for for backward
638 * compatibility with old utils.
643 ret = exfat_utf16_enc(optarg,
644 ui.volume_label, sizeof(ui.volume_label));
648 ui.volume_label_len = ret;
652 if (*optarg != '\0' && *optarg != '\r')
656 ret = parse_size(optarg);
659 else if (ret & (ret - 1)) {
660 exfat_err("sector size(%d) is not a power of 2\n",
663 } else if ((ret & 0x1e00) == 0) {
664 exfat_err("sector size(%d) must be 512, 1024, "
665 "2048 or 4096 bytes\n",
669 ui.sector_size = ret;
672 ret = parse_size(optarg);
675 else if (ret & (ret - 1)) {
676 exfat_err("cluster size(%d) is not a power of 2)\n",
679 } else if (ret > EXFAT_MAX_CLUSTER_SIZE) {
680 exfat_err("cluster size(%d) exceeds max cluster size(%d)\n",
681 ui.cluster_size, EXFAT_MAX_CLUSTER_SIZE);
684 ui.cluster_size = ret;
687 ret = parse_size(optarg);
690 else if (ret & (ret - 1)) {
691 exfat_err("boundary align(%d) is not a power of 2)\n",
695 ui.boundary_align = ret;
698 ui.pack_bitmap = true;
707 print_level = EXFAT_ERROR;
711 print_level = EXFAT_DEBUG;
726 if (argc - optind != 1) {
730 if (ui.sector_size && ui.cluster_size && ui.sector_size > ui.cluster_size) {
731 exfat_err("cluster size (%u bytes) is smaller than sector size (%u bytes)\n",
732 ui.cluster_size, ui.sector_size);
737 ui.dev_name = argv[optind];
739 ret = exfat_get_blk_dev_info(&ui, &bd);
743 ret = exfat_build_mkfs_info(&bd, &ui);
747 ret = exfat_zero_out_disk(&bd, &ui);
751 ret = make_exfat(&bd, &ui);
755 exfat_info("Synchronizing...\n");
756 ret = fsync(bd.dev_fd);
761 exfat_info("\nexFAT format complete!\n");
763 exfat_err("\nexFAT format fail!\n");