apfs_hfs_convert(8) BSD System Manager's Manual apfs_hfs_convert(8)
NAME
apfs_hfs_convert -- convert an existing HFS file system to APFS file
system
SYNOPSIS
apfs_hfs_convert [-D] [-e] [-v] [-i] [-S path] [-n] [-f] [-F index]
[-M mount_path] [-o nx-apfs-format] <device-path>
DESCRIPTION
The apfs_hfs_convert command converts an existing HFS file system to a
new APFS file system.
The device-path parameter should be the path to a disk device node, such
as /dev/disk1s2, with an existing HFS file system, which needs to be
converted. The device-path may be a path to a whole disk, such as
/dev/disk0, which contains Lightweight Volume Manager (LwVM) structures;
all HFS slices will be converted and LwVM replaced by a GPT partition map
with a single partition containing the APFS container.
The options are as follows:
-e | --estimate Estimate the APFS metadata size after conversion.
-v | --verbose Increase verbosity of the output.
-s | --force-case-sensitive
Force the converted volume to be case-sensitive. By
default, the converted volume will have the same
case-sensitivity as the original HFS volume.
-S path | --stats path
Print statistics about the conversion to the
supplied path. If the path is - then the
statistics are printed to standard output.
-n | --dry-run Do not finalize the conversion to APFS. Volume
remains HFS.
-f | --force Force conversion if volume is dirty (journal is
non-empty, volume had inconsistencies, or volume is
not journaled and not unmounted cleanly).
-F index | --fixed index
Volume number index (0-based) should be formatted
as fixed-size. Usually used when converting LwVM.
-M mount_path | --mount-path mount_path
When converting LwVM systems, which require a
special "conversion mount" of the underlying
device, use the given mount_path as the mount
point. If this option is not used, a temporary
directory will be created and used.
-o nx-apfs-format NX or APFS format options.
-D | --skip-single-dirlinks
Convert all former and current directory hardlinks
to files/aliases.
DIAGNOSTICS
The apfs_hfs_convert utility exits 0 on success, and >0 if an error
occurs.
EXAMPLES
The following converts the HFS file system on the /dev/disk1s2 device:
apfs_hfs_convert -v /dev/disk1s2
SEE ALSO
mount_apfs(8) , newfs_apfs(8)
HISTORY
The apfs_hfs_convert utility first appeared in OS X 10.12.
Mac OS X September 15, 2015 Mac OS X
Mac OS X 10.13.1 - Generated Thu Nov 9 18:32:23 CST 2017