newfs_hfs(8) BSD System Manager's Manual newfs_hfs(8)
NAME
newfs_hfs -- construct a new HFS Plus file system
SYNOPSIS
newfs_hfs [-N [partition-size]] [-U uid] [-G gid] [-M mask] [-h | -w]
[-s] [-b block-size] [-c clump-size-list] [-i first-cnid]
[-J [journal-size]] [-n node-size-list] [-v volume-name]
special
DESCRIPTION
Newfs_hfs builds an HFS Plus file system on the specified special device.
Before running newfs_hfs the disk should be partitioned using the Disk
Utility application or pdisk(8).
The file system default parameters are calculated based on the size of
the disk partition. Typically the defaults are reasonable, however
newfs_hfs has several options to allow the defaults to be selectively
overridden. The options are as follows:
-N [partition-size]
Causes the file system parameters to be printed out without
really creating the file system. The optional partition-size
argument can be specified in bytes (with a `b' suffix),
petabytes (`p' suffix), terabytes (`t' suffix), gigabytes
(`g' suffix), megabytes (`m' suffix), or kilobytes (`k' suf-
fix). All suffixes indicate binary, not decimal, multipliers
(e.g., `1k' is 1024 bytes). If no suffix is specified, the
value is assumed to be in bytes; if an illegal suffix is
specified, it results in a size of 0 bytes.
-U uid Set the owner of the file system's root directory to uid.
-G gid Set the group of the file system's root directory to gid.
-M mask Specify the octal access permissions mask for the file sys-
tem's root directory.
-h Creates a legacy HFS format filesystem. This option is not
recomended for file systems that will be primarily used with
Mac OS X or Darwin.
-s Creates a case-sensitive HFS Plus filesystem. By default a
case-insensitive filesystem is created. Case-sensitive HFS
Plus file systems require a Mac OS X version of 10.3 (Darwin
7.0) or later.
-w Adds an HFS wrapper around the HFS Plus file system. This
wrapper is required if the file system will be used to boot
natively into Mac OS 9.
-b block-size
The allocation block size of the file system. The default
value is 4096.
-c clump-size-list
This specifies the clump and/or initial sizes, in allocation
blocks, for the various metadata files. Clump sizes are
specified with the -c option followed by a comma separated
list of the form arg=blocks.
Example: -c c=5000,e=500
a=blocks Set the attribute file clump size.
b=blocks Set the allocation bitmap file clump size.
c=blocks Set the catalog file clump size.
d=blocks Set the data fork clump size.
e=blocks Set the extent overflow file clump size.
g=blocks Set the maximum growable size of the hfs wrapper.
r=blocks Set the resource fork clump size.
-i first-cnid
This specifies the initial catalog node ID for user files and
directories. The default value is 16.
-J [journal-size]
Creates a journaled HFS+ volume. The default journal size is
8MB. Appending an 'M' to the journal size implies megabytes
(i.e. 64M is 64 megabytes). The maximum journal size is 512
megabytes.
-n node-size-list
This specifies the b-tree node sizes, in bytes, for the vari-
ous b-tree files. Node sizes are specified with the -n
option followed by a comma separated list of the form
arg=bytes. The node size must be a power of two and no larger
than 32768 bytes.
Example: -n c=8192,e=4096
a=bytes Set the attribute b-tree node size.
c=bytes Set the catalog b-tree node size.
e=bytes Set the extent overflow b-tree node size.
-v volume-name
Volume name (file system name) in ascii or UTF-8 format.
SEE ALSO
mount(8), pdisk(8)
HISTORY
The newfs_hfs command appeared in Mac OS X Server 1.0 .
Mac OS X April 1, 2003 Mac OS X
Mac OS X 10.5.2 - Generated Sun Mar 23 09:27:46 CDT 2008