]> git.sven.stormbind.net Git - sven/exfat-utils.git/blob - mkfs/mkexfatfs.8
74e0bfed308dec8864d02a3a06055f9ff7ea5ad3
[sven/exfat-utils.git] / mkfs / mkexfatfs.8
1 .\" Copyright (C) 2011-2016  Andrew Nayenko
2 .\"
3 .TH MKEXFATFS 8 "January 2011"
4 .SH NAME
5 .B mkexfatfs
6 \- create an exFAT file system
7 .SH SYNOPSIS
8 .B mkexfatfs
9 [
10 .B \-i
11 .I volume-id
12 ]
13 [
14 .B \-n
15 .I volume-name
16 ]
17 [
18 .B \-p
19 .I partition-first-sector
20 ]
21 [
22 .B \-s
23 .I sectors-per-cluster
24 ]
25 [
26 .B \-V
27 ]
28 .I device
29
30 .SH DESCRIPTION
31 .B mkexfatfs
32 creates an exFAT file system on a block device.
33 .I device
34 is a special file corresponding to the partition on the device. Note that if
35 this is an MBR partition then the file system type should be set to 0x07
36 (NTFS/exFAT) otherwise other operating systems may refuse to mount the
37 file system.
38
39 .SH OPTIONS
40 Command line options available:
41 .TP
42 .BI \-i " volume-id"
43 A 32-bit hexadecimal number. By default a value based on current time is set.
44 .TP
45 .BI \-n " volume-name"
46 Volume name (label), up to 15 characters. By default no label is set.
47 .TP
48 .BI \-p " partition-first-sector"
49 First sector of the partition starting from the beginning of the whole disk.
50 exFAT super block has a field for this value but in fact it's optional and
51 does not affect anything. Default is 0.
52 .TP
53 .BI \-s " sectors-per-cluster"
54 Number of physical sectors per cluster (cluster is an allocation unit in
55 exFAT). Must be a power of 2, i.e. 1, 2, 4, 8, etc. Cluster size can not
56 exceed 32 MB. Default cluster sizes are:
57 4 KB if volume size is less than 256 MB,
58 32 KB if volume size is from 256 MB to 32 GB,
59 128 KB if volume size is 32 GB or larger.
60 .TP
61 .BI \-V
62 Print version and copyright.
63
64 .SH EXIT CODES
65 Zero is returned on successful creation. Any other code means an error.
66
67 .SH AUTHOR
68 Andrew Nayenko
69
70 .SH SEE ALSO
71 .BR mkfs (8), fdisk (8)