.\" mkapfs.8 - manpage for mkapfs
.\"
.\" Copyright (C) 2019 Ernesto A. Fernández <ernesto.mnd.fernandez@gmail.com>
.\"
.TH mkapfs 8 "June 2025" "apfsprogs 0.2.1"
.SH NAME
mkapfs \- create an APFS filesystem
.SH SYNOPSIS
.B mkapfs
[\-sv]
[\-L
.IR label ]
[\-U
.IR UUID ]
[\-u
.IR UUID ]
[\-F
.IR tier2 ]
[\-B
.IR tier2-blocks ]
.I device
.RI [ blocks ]
.SH DESCRIPTION
.B mkapfs
is an experimental tool to create an APFS filesystem with a single volume on
the given
.IR device .
The number of blocks for the device can be specified in
.IR blocks ,
otherwise the whole disk is used.
.SH OPTIONS
.TP
.B \-s
Enable case sensitivity for the volume.
.TP
.B \-z
Enable normalization sensitivity for the volume.
.TP
.BI \-L " label"
Set a label for the volume, with a maximum length of 255 bytes.
.TP
.BI \-U " UUID"
Specify a UUID for the container, in the standard format. By default the value
is chosen by /proc/sys/kernel/random/uuid.
.TP
.BI \-u " UUID"
Specify a UUID for the volume, in the standard format. By default the value
is chosen by /proc/sys/kernel/random/uuid.
.TP
.B \-v
Print the version number of
.B mkapfs
and exit.
.TP
.BI \-F " tier2"
Specify the tier 2 device for a fusion drive.
.TP
.BI \-B " tier2-blocks"
Specify the size (in blocks) for the tier 2 device given by the
.B \-F
option. By default the whole disk is used.
.SH REPORTING BUGS
Please report bugs via email or, if preferred, file a github issue at
\%https://github.com/eafer/apfsprogs/issues.
.SH AUTHOR
Written by Ernesto A. Fernández <ernesto.mnd.fernandez@gmail.com>.
.SH SEE ALSO
.BR apfsck (8)