]> git.sven.stormbind.net Git - sven/exfat-utils.git/blob - mkfs/mkexfatfs.8
Fine tune the description.
[sven/exfat-utils.git] / mkfs / mkexfatfs.8
1 .\" Copyright (C) 2011  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 device.
35
36 .SH OPTIONS
37 Command line options available:
38 .TP
39 .BI \-i " volume-id"
40 A 32-bit hexadecimal number. By default a value based on current time is set.
41 .TP
42 .BI \-n " volume-name"
43 Volume name (label), up to 15 characters. By default no label is set.
44 .TP
45 .BI \-p " partition-first-sector"
46 First sector of the partition starting from the beginning of the whole disk.
47 exFAT super block has a field for this value but in fact it's optional and
48 does not affect anything. Default is 0.
49 .TP
50 .BI \-s " sectors-per-cluster"
51 Number of physical sectors per cluster (cluster is an allocation unit in
52 exFAT). Must be a power of 2, i.e. 1, 2, 4, 8, etc. Cluster size can not
53 exceed 32 MB. Default cluster sizes are:
54 4 KB if volume size is less than 256 MB,
55 32 KB if volume size is from 256 MB to 32 GB,
56 128 KB if volume size is 32 GB or larger.
57 .TP
58 .BI \-v
59 Print version and copyright.
60
61 .SH EXIT CODES
62 Zero is returned on successful creation. Any other code means an error.
63
64 .SH AUTHOR
65 Andrew Nayenko
66
67 .SH SEE ALSO
68 .BR mkfs (8)