.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "mkosi\-addon" "1" "" "" ""
.SH NAME
mkosi\-addon \[em] Build addons for unified kernel images for the
current system using mkosi
.SH SYNOPSIS
\f[CR]mkosi\-addon [options\&...]\f[R]
.SH DESCRIPTION
\f[CR]mkosi\-addon\f[R] is a wrapper on top of \f[CR]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[CR]/etc/crypttab\f[R] marked with
\f[CR]x\-initrd.attach\f[R], and \f[CR]/etc/kernel/cmdline\f[R].
Kernel modules and firmwares for the running hardware can be included if
a local configuration with the option
\f[CR]KernelModulesIncludeHost=\f[R] is provided.
.SH OPTIONS
.TP
\f[CR]\-\-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[CR]uname \-r\f[R]).
.TP
\f[CR]\-\-output=\f[R], \f[CR]\-o\f[R]
Name to use for the generated output addon.
Defaults to \f[CR]mkosi\-local.addon.efi\f[R].
.TP
\f[CR]\-\-output\-dir=\f[R], \f[CR]\-O\f[R]
Path to a directory where to place all generated artifacts.
Defaults to the current working directory.
.TP
\f[CR]\-\-debug=\f[R]
Enable additional debugging output.
.TP
\f[CR]\-\-debug\-shell=\f[R]
Spawn debug shell in sandbox if a sandboxed command fails.
.TP
\f[CR]\-\-version\f[R]
Show package version.
.TP
\f[CR]\-\-help\f[R], \f[CR]\-h\f[R]
Show brief usage information.
.SH SEE ALSO
\f[CR]mkosi(1)\f[R]