APFS_HFS_CONVERT(8)

NAME
apfs_hfs_convert - convert an existing HFS file system to APFS file system

SYNOPSIS
apfs_hfs_convert [-e] [-v] [-S path] [-n] [-f] [-F index] [-M mount_path] [-o nx-apfs-format] [--no-warning] <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 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.

--no-warning
    Avoid printing the warning that APFS is pre-release technology, and do not ask for user confirmation. If standard input or standard error are not a TTY, then the warning and user confirmation are also skipped.

DIAGNOSTICS

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.