| 1 |
.\" Automatically generated by Pandoc 3.1.11.1 |
| 2 |
.\" |
| 3 |
.TH "mkosi\-addon" "1" "" "" "" |
| 4 |
.SH NAME |
| 5 |
mkosi\-addon \[em] Build addons for unified kernel images for the |
| 6 |
current system using mkosi |
| 7 |
.SH SYNOPSIS |
| 8 |
\f[CR]mkosi\-addon [options\&...]\f[R] |
| 9 |
.SH DESCRIPTION |
| 10 |
\f[CR]mkosi\-addon\f[R] is a wrapper on top of \f[CR]mkosi\f[R] to |
| 11 |
simplify the generation of PE addons containing customizations for |
| 12 |
unified kernel images specific to the running or local system. |
| 13 |
Will include entries in \f[CR]/etc/crypttab\f[R] marked with |
| 14 |
\f[CR]x\-initrd.attach\f[R], and \f[CR]/etc/kernel/cmdline\f[R]. |
| 15 |
Kernel modules and firmwares for the running hardware can be included if |
| 16 |
a local configuration with the option |
| 17 |
\f[CR]KernelModulesIncludeHost=\f[R] is provided. |
| 18 |
.SH OPTIONS |
| 19 |
.TP |
| 20 |
\f[CR]\-\-kernel\-version=\f[R] |
| 21 |
Kernel version where to look for the kernel modules to include. |
| 22 |
Defaults to the kernel version of the running system |
| 23 |
(\f[CR]uname \-r\f[R]). |
| 24 |
.TP |
| 25 |
\f[CR]\-\-output=\f[R], \f[CR]\-o\f[R] |
| 26 |
Name to use for the generated output addon. |
| 27 |
Defaults to \f[CR]mkosi\-local.addon.efi\f[R]. |
| 28 |
.TP |
| 29 |
\f[CR]\-\-output\-dir=\f[R], \f[CR]\-O\f[R] |
| 30 |
Path to a directory where to place all generated artifacts. |
| 31 |
Defaults to the current working directory. |
| 32 |
.TP |
| 33 |
\f[CR]\-\-debug=\f[R] |
| 34 |
Enable additional debugging output. |
| 35 |
.TP |
| 36 |
\f[CR]\-\-debug\-shell=\f[R] |
| 37 |
Spawn debug shell in sandbox if a sandboxed command fails. |
| 38 |
.TP |
| 39 |
\f[CR]\-\-version\f[R] |
| 40 |
Show package version. |
| 41 |
.TP |
| 42 |
\f[CR]\-\-help\f[R], \f[CR]\-h\f[R] |
| 43 |
Show brief usage information. |
| 44 |
.SH SEE ALSO |
| 45 |
\f[CR]mkosi(1)\f[R] |