1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
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
133
134
135
136
137
138
139
140
141
142
|
.TH mkfs.exfat 8
.SH NAME
mkfs.exfat \- create an exFAT filesystem
.SH SYNOPSIS
.B mkfs.exfat
[
.B \-b
.I boundary_alignment
] [
.B \-s
.I sector_size
] [
.B \-c
.I cluster_size
] [
.B \-f
] [
.B \-h
] [
.B \-L
.I volume_label
] [
.B \-U
.I volume_guid
] [
.B \-\-pack\-bitmap
] [
.B \-v
]
.I device
.br
.B mkfs.exfat \-V
.SH DESCRIPTION
.B mkfs.exfat
creates an exFAT filesystem by writing on a special
file using the values found in the arguments of the command line.
It is invoked automatically by
.BR mkfs (8)
when it is given the
.B \-t exfat
option.
.PP
As an example, to make a filesystem on the first partition on the first
SCSI disk, use:
.IP
.B mkfs.exfat /dev/sda1
.PP
.SH OPTIONS
.TP
.BR \-b ", " \-\-boundary\-align =\fIalignment\fR
Specifies the alignment for the FAT and the start of the cluster heap.
The \fIalignment\fR argument is specified in bytes or may be specified with
\fBm\fR/\fBM\fR suffix for mebibytes or \fBk\fR/\fBK\fR suffix for kibibytes
and should be a power of two.
Some media like SD cards need this for optimal performance and endurance,
in which case \fIalignment\fR should be set to half of the card's native
boundary unit size.
If the card's native boundary unit size is not known, refer to the following
table of boundary unit sizes recommended by the SD Card Association.
.\" source: SD Specifications Part 2: File System Specification Version 3.00
.TS
center;
cb1s6cbcb,nnnn.
Card Capacity Range Cluster Size Boundary Unit
_
\[<=]8 MiB 8 KiB 8 KiB
>8 MiB \[<=]64 MiB 16 KiB 16 KiB
>64 MiB \[<=]256 MiB 16 KiB 32 KiB
>256 MiB \[<=]1 GiB 16 KiB 64 KiB
>1 GiB \[<=]2 GiB 32 KiB 64 KiB
>2 GiB \[<=]32 GiB 32 KiB 4 MiB
>32 GiB \[<=]128 GiB 128 KiB 16 MiB
>128 GiB \[<=]512 GiB 256 KiB 32 MiB
>512 GiB \[<=]2 TiB 512 KiB 64 MiB
.TE
The default is always 1 MiB.
.TP
.BR \-s ", " \-\-sector\-size =\fIsize\fR
Specifies the sector size of the exFAT file system.
The \fIsize\fR argument is specified in bytes or may be specified with
\fBk\fR/\fBK\fR suffix for kibibytes and must either 512, 1024, 2048 or 4096
bytes.
The default value is the sector size reported by the device, or 512 bytes if the
device sector size cannot be determined.
.TP
.BR \-c ", " \-\-cluster\-size =\fIsize\fR
Specifies the cluster size of the exFAT file system.
The \fIsize\fR argument is specified in bytes or may be specified with
\fBm\fR/\fBM\fR suffix for mebibytes or \fBk\fR/\fBK\fR suffix for kibibytes
and must be a power of two.
The default value is described in the following table:
.TS
center;
cb1s6cb,nnn.
Card Capacity Range Cluster Size
_
\[<=]256 MiB 4 KiB
>256 MiB \[<=]32 GiB 32 KiB
>32 GiB 128 KiB
.TE
.TP
.BR \-f ", " \-\-full\-format
Performs a full format.
This zeros the entire disk device while creating the exFAT filesystem.
.TP
.BR \-h ", " \-\-help
Prints the help and exit.
.TP
.BR \-L ", " \-\-volume\-label =\fIlabel\fR
Specifies the volume label to be associated with the exFAT filesystem.
.TP
.BR \-U ", " \-\-volume\-guid =\fIguid\fR
Specifies the volume GUID to be associated with the exFAT filesystem.
.TP
.B \-\-pack\-bitmap
Attempts to relocate the exFAT allocation bitmap so that it ends at the
alignment boundary immediately following the FAT rather than beginning at that
boundary.
This strictly violates the SD card specification but may improve performance
and endurance on SD cards and other flash media not designed for use with exFAT
by allowing file-system metadata updates to touch fewer flash allocation units.
Furthermore, many SD cards and other flash devices specially optimize the
allocation unit where the FAT resides so as to support tiny writes with reduced
write amplification but expect only larger writes in subsequent allocation
units \[em] where the exFAT bitmap would be placed by default.
Specifying \fB\-\-pack\-bitmap\fR attempts to avoid the potential problems
associated with issuing many small writes to the bitmap by making it share an
allocation unit with the FAT.
If there is insufficient space for the bitmap there, then this option will have
no effect, and the bitmap will be aligned at the boundary as by default.
.TP
.BR \-q ", " \-\-quiet
Prints only error messages while creating the exFAT filesystem.
.TP
.BR \-v ", " \-\-verbose
Prints verbose debugging information while creating the exFAT filesystem.
.TP
.BR \-V ", " \-\-version
Prints the version number and exits.
.SH SEE ALSO
.BR mkfs (8),
.BR mount (8),
|
