.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "mkosi\-addon" "1" "" ""
.SH NAME
mkosi\-addon \(em Build addons for unified kernel images for the current
system using mkosi
.SH SYNOPSIS
\f[B]mkosi\-addon [options\&...]\f[R]
.SH DESCRIPTION
\f[B]mkosi\-addon\f[R] is a wrapper on top of \f[B]mkosi\f[R] to
simplify the generation of PE addons containing customizations for
unified kernel images specific to the running or local system.
Will include entries in \f[B]/etc/crypttab\f[R] marked with
\f[B]x\-initrd.attach\f[R], and \f[B]/etc/kernel/cmdline\f[R].
Kernel modules and firmwares for the running hardware can be included if
a local configuration with the option
\f[B]KernelModulesIncludeHost=\f[R] is provided.
.SH OPTIONS
.TP
\f[B]\-\-kernel\-version=\f[R]
Kernel version where to look for the kernel modules to include.
Defaults to the kernel version of the running system (\f[B]uname
\-r\f[R]).
.TP
\f[B]\-\-output=\f[R], \f[B]\-o\f[R]
Name to use for the generated output addon.
Defaults to \f[B]mkosi\-local.addon.efi\f[R].
.TP
\f[B]\-\-output\-dir=\f[R], \f[B]\-O\f[R]
Path to a directory where to place all generated artifacts.
Defaults to the current working directory.
.TP
\f[B]\-\-debug\f[R]
Enable additional debugging output.
.TP
\f[B]\-\-debug\-shell\f[R]
Spawn debug shell in sandbox if a sandboxed command fails.
.TP
\f[B]\-\-debug\-sandbox\f[R]
Run \f[B]mkosi\-sandbox\f[R] with \f[B]strace\f[R].
.TP
\f[B]\-\-show\-documentation\f[R], \f[B]\-D\f[R]
Show the man page for mkosi\-addon.
.TP
\f[B]\-\-version\f[R]
Show package version.
.TP
\f[B]\-\-help\f[R], \f[B]\-h\f[R]
Show brief usage information.
.SH SEE ALSO
\f[B]mkosi\f[R](1)