| 1 |
.\" Automatically generated by Pandoc 3.9.0.2 |
| 2 |
.\" |
| 3 |
.TH "mkosi\-initrd" "1" "" "" |
| 4 |
.SH NAME |
| 5 |
mkosi\-initrd \(em Build initrds or unified kernel images for the |
| 6 |
current system using mkosi |
| 7 |
.SH SYNOPSIS |
| 8 |
\f[B]mkosi\-initrd [options\&...]\f[R] |
| 9 |
.SH DESCRIPTION |
| 10 |
\f[B]mkosi\-initrd\f[R] is wrapper on top of \f[B]mkosi\f[R] to simplify |
| 11 |
the generation of initrds and Unified Kernel Images for the current |
| 12 |
running system. |
| 13 |
.SH OPTIONS |
| 14 |
.TP |
| 15 |
\f[B]\-\-kernel\-version=\f[R], \f[B]\-k\f[R] |
| 16 |
Kernel version where to look for the kernel modules to include. |
| 17 |
Defaults to the kernel version of the running system (\f[B]uname |
| 18 |
\-r\f[R]). |
| 19 |
.TP |
| 20 |
\f[B]\-\-format=\f[R], \f[B]\-t\f[R] |
| 21 |
Output format. |
| 22 |
One of \f[B]cpio\f[R] (CPIO archive), \f[B]uki\f[R] (a unified kernel |
| 23 |
image with the image in the \f[B].initrd\f[R] PE section) or |
| 24 |
\f[B]directory\f[R] (for generating an image directly in a local |
| 25 |
directory). |
| 26 |
Defaults to \f[B]cpio\f[R]. |
| 27 |
.TP |
| 28 |
\f[B]\-\-output=\f[R], \f[B]\-o\f[R] |
| 29 |
Name to use for the generated output image file or directory. |
| 30 |
Defaults to \f[B]initrd\f[R]. |
| 31 |
.TP |
| 32 |
\f[B]\-\-output\-dir=\f[R], \f[B]\-O\f[R] |
| 33 |
Path to a directory where to place all generated artifacts. |
| 34 |
Defaults to the current working directory. |
| 35 |
.TP |
| 36 |
\f[B]\-\-generic\f[R], \f[B]\-g\f[R] |
| 37 |
Build a generic initrd without host\-specific kernel modules, which |
| 38 |
should allow the local system to boot on different hardware, although |
| 39 |
it\(cqs tied to the kernel version of the running system or set with |
| 40 |
\f[B]\-\-kernel\-version=\f[R]. |
| 41 |
.TP |
| 42 |
\f[B]\-\-profile=\f[R] |
| 43 |
Set the profiles to enable for the initrd. |
| 44 |
By default, all profiles are disabled. |
| 45 |
.RS |
| 46 |
The \f[B]lvm\f[R] profile enables support for LVM. |
| 47 |
The \f[B]network\f[R] profile enables support for network via |
| 48 |
\f[B]systemd\-networkd\f[R]. |
| 49 |
The \f[B]nfs\f[R] profile enables support for NFS. |
| 50 |
It requires networking in the initrd, using the \f[B]network\f[R] |
| 51 |
profile, or some other custom method. |
| 52 |
The \f[B]pkcs11\f[R] profile enables support for PKCS#11. |
| 53 |
The \f[B]plymouth\f[R] profile provides a graphical interface at boot |
| 54 |
(animation and password prompt). |
| 55 |
The \f[B]raid\f[R] profile enables support for RAID arrays. |
| 56 |
.RE |
| 57 |
.TP |
| 58 |
\f[B]\-\-debug\f[R] |
| 59 |
Enable additional debugging output. |
| 60 |
.TP |
| 61 |
\f[B]\-\-debug\-shell\f[R] |
| 62 |
Spawn debug shell in sandbox if a sandboxed command fails. |
| 63 |
.TP |
| 64 |
\f[B]\-\-debug\-sandbox\f[R] |
| 65 |
Run \f[B]mkosi\-sandbox\f[R] with \f[B]strace\f[R]. |
| 66 |
.TP |
| 67 |
\f[B]\-\-version\f[R] |
| 68 |
Show package version. |
| 69 |
.TP |
| 70 |
\f[B]\-\-help\f[R], \f[B]\-h\f[R] |
| 71 |
Show brief usage information. |
| 72 |
.SH SEE ALSO |
| 73 |
\f[B]mkosi(1)\f[R] |