1
.\" Copyright (c) 2002-2003 Apple Computer, Inc. All rights reserved.
3
.\" The contents of this file constitute Original Code as defined in and
4
.\" are subject to the Apple Public Source License Version 1.1 (the
5
.\" "License"). You may not use this file except in compliance with the
6
.\" License. Please obtain a copy of the License at
7
.\" http://www.apple.com/publicsource and read it before using this file.
9
.\" This Original Code and all software distributed under the License are
10
.\" distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
11
.\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
12
.\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
13
.\" FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
14
.\" License for the specific language governing rights and limitations
15
.\" under the License.
23
.Nd construct a new HFS Plus file system
26
.Op Fl N Ar [partition-size]
32
.Op Fl b Ar block-size
33
.Op Fl c Ar clump-size-list
34
.Op Fl i Ar first-cnid
35
.Op Fl J Ar [journal-size]
36
.Op Fl n Ar node-size-list
37
.Op Fl v Ar volume-name
41
builds an HFS Plus file system on the specified special device.
44
the disk should be partitioned using the
49
The file system default parameters are calculated based on
50
the size of the disk partition. Typically the defaults are
53
has several options to allow the defaults to be selectively overridden.
54
The options are as follows:
56
.It Fl N Ar [partition-size]
57
Causes the file system parameters to be printed out
58
without really creating the file system.
60
Set the owner of the file system's root directory to
63
Set the group of the file system's root directory to
66
Specify the access permissions mask for the file system's root directory.
68
Creates a legacy HFS format filesystem. This option
69
is not recomended for file systems that will be
70
primarily used with Mac OS X or Darwin.
72
Creates a case-sensitive HFS Plus filesystem. By
73
default a case-insensitive filesystem is created.
74
Case-sensitive HFS Plus file systems require a Mac OS X
75
version of 10.3 (Darwin 7.0) or later.
77
Adds an HFS wrapper around the HFS Plus file system.
78
This wrapper is required if the file system will be used
79
to boot natively into Mac OS 9.
80
.It Fl b Ar block-size
81
The allocation block size of the file system.
82
The default value is 4096.
83
.It Fl c Ar clump-size-list
89
blocks, for the various metadata files.
91
sizes are specified with the
93
option followed by a comma
94
separated list of the form arg=blocks.
96
Example: \-c c=5000,e=500
99
Set the attribute file clump size.
101
Set the allocation bitmap file clump size.
103
Set the catalog file clump size.
105
Set the extent overflow file clump size.
107
.It Fl i Ar first-cnid
108
This specifies the initial catalog node ID for user files
109
and directories. The default value is 16.
110
.It Fl J Ar [journal-size]
111
Creates a journaled HFS+ volume.
112
The default journal size is 8MB. Appending an 'M' to the
113
journal size implies megabytes (i.e. 64M is 64 megabytes).
114
The maximum journal size is 512 megabytes.
115
.It Fl n Ar node-size-list
116
This specifies the b-tree
119
for the various b-tree files.
121
sizes are specified with the
123
option followed by a comma separated list of
124
the form arg=bytes. The
126
size must be a power of two and no larger than
129
Example: \-n c=8192,e=4096
132
Set the attribute b-tree node size.
134
Set the catalog b-tree node size.
136
Set the extent overflow b-tree node size.
138
.It Fl v Ar volume-name
139
Volume name (file system name) in ascii or UTF-8 format.
147
command appeared in Mac OS X Server 1.0 .