1NEWFS_HFS(8)              BSD System Manager's Manual             NEWFS_HFS(8)
2

NAME

4     mkfs.hfsplus — construct a new HFS Plus file system
5

SYNOPSIS

7     mkfs.hfsplus [-N] [-U uid] [-G gid] [-M mask] [-h | -w] [-s]
8                  [-b block-size] [-c clump-size-list] [-i first-cnid]
9                  [-J [journal-size]] [-n node-size-list] [-v volume-name]
10                  special
11

DESCRIPTION

13     mkfs.hfsplus builds an HFS Plus file system on the specified special
14     device.  Before running mkfs.hfsplus the disk should be partitioned using
15     the Disk Utility application or pdisk(8).
16
17     The file system default parameters are calculated based on the size of
18     the disk partition. Typically the defaults are reasonable, however
19     mkfs.hfsplus has several options to allow the defaults to be selectively
20     overridden.  The options are as follows:
21
22     -N          Causes the file system parameters to be printed out without
23                 really creating the file system.
24
25     -U uid      Set the owner of the file system's root directory to uid.
26
27     -G gid      Set the group of the file system's root directory to gid.
28
29     -M mask     Specify the access permissions mask for the file system's
30                 root directory.
31
32     -h          Creates a legacy HFS format filesystem. This option is not
33                 recomended for file systems that will be primarily used with
34                 Mac OS X or Darwin.
35
36     -s          Creates a case-sensitive HFS Plus filesystem. By default a
37                 case-insensitive filesystem is created.  Case-sensitive HFS
38                 Plus file systems require a Mac OS X version of 10.3 (Darwin
39                 7.0) or later.
40
41     -w          Adds an HFS wrapper around the HFS Plus file system.  This
42                 wrapper is required if the file system will be used to boot
43                 natively into Mac OS 9.
44
45     -b block-size
46                 The allocation block size of the file system.  The default
47                 value is 4096.
48
49     -c clump-size-list
50                 This specifies the clump and/or initial sizes, in allocation
51                 blocks, for the various metadata files.  Clump sizes are
52                 specified with the -c option followed by a comma separated
53                 list of the form arg=blocks.
54
55                 Example:  -c c=5000,e=500
56
57                 a=blocks    Set the attribute file clump size.
58
59                 b=blocks    Set the allocation bitmap file clump size.
60
61                 c=blocks    Set the catalog file clump size.
62
63                 e=blocks    Set the extent overflow file clump size.
64
65     -i first-cnid
66                 This specifies the initial catalog node ID for user files and
67                 directories. The default value is 16.
68
69     -J [journal-size]
70                 Creates a journaled HFS+ volume.  The default journal size is
71                 8MB.  Appending an 'M' to the journal size implies megabytes
72                 (i.e. 64M is 64 megabytes).  The maximum journal size is 512
73                 megabytes.
74
75     -n node-size-list
76                 This specifies the b-tree node sizes, in bytes, for the vari‐
77                 ous b-tree files.  Node sizes are specified with the -n
78                 option followed by a comma separated list of the form
79                 arg=bytes. The node size must be a power of two and no larger
80                 than 32768 bytes.
81
82                 Example:  -n c=8192,e=4096
83
84                 a=bytes     Set the attribute b-tree node size.
85
86                 c=bytes     Set the catalog b-tree node size.
87
88                 e=bytes     Set the extent overflow b-tree node size.
89
90     -v volume-name
91                 Volume name (file system name) in ascii or UTF-8 format.
92

SEE ALSO

94     mount(8), pdisk(8)
95

HISTORY

97     The mkfs.hfsplus command appeared in Mac OS X Server 1.0 .
98
99Mac OS X                         April 1, 2003                        Mac OS X
Impressum