apfs_hfs_convert(8) [mojave man page]

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

HFORMAT(1)						      General Commands Manual							HFORMAT(1)

NAME

       hformat - create a new HFS filesystem and make it current

SYNOPSIS

       hformat [-f] [-l label] destination-path [partition-no]

DESCRIPTION

       hformat	is  used to write a new HFS filesystem to a volume. A UNIX pathname to the volume's destination must be specified. The destination
       may be either a block device or a regular file, but it must already exist and be writable.

       An optional label can be specified to name the volume. The name must be between 1-27 characters and cannot contain a colon (:). By default,
       the volume will be named Untitled.

       If  the	destination medium is partitioned, one partition must be selected to receive the filesystem. If there is only one HFS partition on
       the medium, it will be selected by default. Otherwise, the desired partition number must be specified (as the ordinal nth HFS partition) on
       the command-line. The size of the partition determines the size of the resulting volume.

       Partition number 0 can be specified to format the entire medium as a single filesystem without a partition map, erasing any existing parti-
       tion information. Since this will destroy all the partitions, the -f option must be specified to force this operation if  the  medium  cur-
       rently contains a partition map.

       If  the medium is not partitioned (or if partition 0 is specified), the size or capacity of the medium determines the size of the resulting
       volume.

       The new volume will be empty and will become "current" so subsequent commands will refer to it. The current working directory for the  vol-
       ume is set to the root of the volume.

EXAMPLES

       % hformat /dev/fd0
	      If  a  floppy  disk  is available as /dev/fd0, this formats the disk as an HFS volume named Untitled.  (N.B. The floppy must already
	      have received a low-level format by other means.)

       % dd if=/dev/zero of=disk.hfs bs=1k count=800
       % hformat -l "Test Disk" disk.hfs
	      This sequence creates an 800K HFS volume image in the file disk.hfs in the current directory, and names it Test Disk.

       % hformat -l "Loma Prieta" /dev/sd2 1
	      If a SCSI disk is available as /dev/sd2, this initializes the first HFS partition on the disk (which must already exist) with a  new
	      filesystem, naming the resulting volume Loma Prieta.

       % hformat -f /dev/sd2 0
	      This  causes the medium accessible as /dev/sd2 to be reformatted as a single HFS volume, ignoring and erasing any existing partition
	      information on the medium. The -f option must be specified if the medium is currently partitioned; otherwise the command will fail.

NOTES

       This command does not create or alter partition maps, although it can erase them (as described above). Any partition  number  specified	on
       the command line must already exist.

       The smallest volume size which can be formatted with hformat is 800K.

SEE ALSO

       hfsutils(1), hmount(1)

FILES

       $HOME/.hcwd

AUTHOR

       Robert Leslie <rob@mars.org>

HFSUTILS
							    08-Nov-1997 							HFORMAT(1)