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] [-g] [-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.
It is recommended not to run the apfs_hfs_convert directly, but to run `diskutil apfs convert`.
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.
-g If conversion succeeds, modify the GPT UUID.
-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