Debian Codegraph @

upstream/debian-unstable/man1/mkosi-initrd.1

raw
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]