mkinitfs.1.in 2.38 KB
Newer Older
Ain's avatar
Ain committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
.TH MKINITFS "1" "July 2018" "mkinitfs @VERSION@" "Early startup"
.SH NAME
mkinitfs - Generate an initramfs
.SH SYNOPSIS
.PP
mkinitfs [\fIOPTIONS\fR] [\fIKERNELVERSION\fR]
.SH DESCRIPTION
\fBmkinitfs\fR collects files from the root file system and creates a
compressed initramfs from it.
.TP
\fB\-b\fR \fIBASEDIR\fR
Dont use files from the root file system, use specified path instead.
.TP
\fB\-c\fR \fICONFIGFILE\fR
Use configfile instead of \fI@sysconfdir@/mkinitfs.conf\fR.
.TP
omni's avatar
omni committed
17
\fB\-C\fR \fIALGORITHM\fR
18
Compress initramfs using gzip (default), xz, zstd or lz4.
omni's avatar
omni committed
19
.TP
Ain's avatar
Ain committed
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
\fB\-f\fR \fIFSTAB\fR
Use fstab instead of \fI@datadir@/fstab\fR.
.TP
\fB\-F\fR \fIFEATURES\fR
Use specified features.
.TP
\fB\-h\fR
Print this help.
.TP
\fB\-i \fIINITFILE\fR
Use initfile as init instead of \fI@datadir@/initramfs-init\fR.
.TP
\fB\-k\fR
Do not clean up temporary files.
.TP
\fB\-K\fR
omni's avatar
omni committed
36
Also copy host apk keys to initramfs.
Ain's avatar
Ain committed
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
.TP
\fB\-l\fR
Do a dry run and only list files that would have been used.
.TP
\fB\-L\fR
List all available features.
.TP
\fB\-n\fR
Don't include kernel modules or firmware into the initramfs.
.TP
\fB\-o \fIOUTFILE\fR
Set another outfile.
.TP
\fB\-P \fIFEATURESDIR\fR
Prepend features.d search path. Use this if you want to define your own features
outside of the system-wide directories.
.TP
\fB\-q\fR
Quiet mode.
.TP
omni's avatar
omni committed
57
58
59
\fB\-s\fR
Include modloop signature.
.TP
Ain's avatar
Ain committed
60
61
62
63
64
65
66
67
68
69
70
71
72
73
\fB\-t \fITMPDIR\fR
Use tempdir when creating initramfs image.
.SH FILES
.TP
\fI@sysconfdir@/mkinitfs.conf\fR
Default configuration file. It contains the list of default features in the
format of \fBfeatures="..."\fR.
.TP
\fI@sysconfdir@/features.d/FEATURE.modules\fR
Contains a list of kernel modules. Using the feature will cause the given
kernel modules to be included in the initramfs. The modules are given by their
filesystem paths, relative to \fI/lib/modules/KERNELVERSION/\fR.
.TP
\fI@sysconfdir@/features.d/FEATURE.files\fR
omni's avatar
omni committed
74
Contains a list of absolute file names which will be included into the
Ain's avatar
Ain committed
75
76
77
78
79
80
81
82
83
generated initramfs if the feature is enabled.
.TP
\fI@datadir@/initramfs-init\fR
Shell script which will be placed as \fI/init\fR in the initramfs. This
functions as the first executed program in early userspace.
.SH AUTHOR
.PP
Written by Natanael Copa <ncopa@alpinelinux.org>, Timo Teräs <timo.teras@iki.fi> and others.
.SH "REPORTING BUGS"
84
Alpine Linux GitLab: <https://gitlab.alpinelinux.org/alpine/mkinitfs/-/issues>
Ain's avatar
Ain committed
85
86
.SH "SEE ALSO"
mkinitfs-bootparam(7)