| 1 |
.\" Automatically generated by Pandoc 3.9.0.2 |
| 2 |
.\" |
| 3 |
.TH "mkosi\-addon" "1" "" "" |
| 4 |
.SH NAME |
| 5 |
mkosi\-addon \(em Build addons for unified kernel images for the current |
| 6 |
system using mkosi |
| 7 |
.SH SYNOPSIS |
| 8 |
\f[B]mkosi\-addon [options\&...]\f[R] |
| 9 |
.SH DESCRIPTION |
| 10 |
\f[B]mkosi\-addon\f[R] is a wrapper on top of \f[B]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[B]/etc/crypttab\f[R] marked with |
| 14 |
\f[B]x\-initrd.attach\f[R], and \f[B]/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[B]KernelModulesIncludeHost=\f[R] is provided. |
| 18 |
.SH OPTIONS |
| 19 |
.TP |
| 20 |
\f[B]\-\-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 (\f[B]uname |
| 23 |
\-r\f[R]). |
| 24 |
.TP |
| 25 |
\f[B]\-\-output=\f[R], \f[B]\-o\f[R] |
| 26 |
Name to use for the generated output addon. |
| 27 |
Defaults to \f[B]mkosi\-local.addon.efi\f[R]. |
| 28 |
.TP |
| 29 |
\f[B]\-\-output\-dir=\f[R], \f[B]\-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[B]\-\-debug\f[R] |
| 34 |
Enable additional debugging output. |
| 35 |
.TP |
| 36 |
\f[B]\-\-debug\-shell\f[R] |
| 37 |
Spawn debug shell in sandbox if a sandboxed command fails. |
| 38 |
.TP |
| 39 |
\f[B]\-\-debug\-sandbox\f[R] |
| 40 |
Run \f[B]mkosi\-sandbox\f[R] with \f[B]strace\f[R]. |
| 41 |
.TP |
| 42 |
\f[B]\-\-version\f[R] |
| 43 |
Show package version. |
| 44 |
.TP |
| 45 |
\f[B]\-\-help\f[R], \f[B]\-h\f[R] |
| 46 |
Show brief usage information. |
| 47 |
.SH SEE ALSO |
| 48 |
\f[B]mkosi(1)\f[R] |