Debian Codegraph @

upstream/debian-unstable/man1/grub-mkrescue.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH GRUB-MKRESCUE "1" "February 2026" "GRUB 2.14-2" "User Commands"
3 .SH NAME
4 grub-mkrescue \- make a GRUB rescue image
5 .SH SYNOPSIS
6 .B grub-mkrescue
7 [\fI\,OPTION\/\fR...] [\fI\,OPTION\/\fR] \fI\,SOURCE\/\fR...
8 .SH DESCRIPTION
9 Make GRUB CD\-ROM, disk, pendrive and floppy bootable image.
10 .TP
11 \fB\-\-appended\-signature\-size\fR=\fI\,SIZE\/\fR
12 Add a note segment reserving SIZE bytes for an
13 appended signature
14 .TP
15 \fB\-\-compress\fR=\fI\,no\/\fR|xz|gz|lzo
16 compress GRUB files [optional]
17 .TP
18 \fB\-\-disable\-cli\fR
19 disabled command line interface access
20 .TP
21 \fB\-\-disable\-shim\-lock\fR
22 disable shim_lock verifier
23 .TP
24 \fB\-\-dtb\fR=\fI\,FILE\/\fR
25 embed a specific DTB
26 .TP
27 \fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
28 use images and modules under DIR
29 [default=/usr/lib/grub/<platform>]
30 .TP
31 \fB\-\-fonts\fR=\fI\,FONTS\/\fR
32 install FONTS [default=unicode]
33 .TP
34 \fB\-\-install\-modules\fR=\fI\,MODULES\/\fR
35 install only MODULES and their dependencies
36 [default=all]
37 .TP
38 \fB\-k\fR, \fB\-\-pubkey\fR=\fI\,FILE\/\fR
39 embed FILE as public key for signature checking
40 .TP
41 \fB\-\-locale\-directory\fR=\fI\,DIR\/\fR use translations under DIR
42 [default=/usr/share/locale]
43 .TP
44 \fB\-\-locales\fR=\fI\,LOCALES\/\fR
45 install only LOCALES [default=all]
46 .TP
47 \fB\-\-modules\fR=\fI\,MODULES\/\fR
48 pre\-load specified modules MODULES
49 .TP
50 \fB\-\-sbat\fR=\fI\,FILE\/\fR
51 SBAT metadata
52 .TP
53 \fB\-\-themes\fR=\fI\,THEMES\/\fR
54 install THEMES [default=starfield]
55 .TP
56 \fB\-v\fR, \fB\-\-verbose\fR
57 print verbose messages.
58 .TP
59 \fB\-x\fR, \fB\-\-x509key\fR=\fI\,FILE\/\fR
60 embed FILE as an x509 certificate for appended
61 signature checking
62 .TP
63 \fB\-\-arcs\-boot\fR
64 enable ARCS (big\-endian mips machines, mostly
65 SGI) boot. Disables HFS+, APM, sparc64 and boot
66 as disk image for i386\-pc
67 .TP
68 \fB\-\-core\-compress\fR=\fI\,xz\/\fR|none|auto
69 choose the compression to use for core image
70 .TP
71 \fB\-\-label\-bgcolor\fR=\fI\,COLOR\/\fR
72 use COLOR for label background
73 .TP
74 \fB\-\-label\-color\fR=\fI\,COLOR\/\fR
75 use COLOR for label
76 .TP
77 \fB\-\-label\-font\fR=\fI\,FILE\/\fR
78 use FILE as font for label
79 .TP
80 \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
81 save output in FILE [required]
82 .TP
83 \fB\-\-product\-name\fR=\fI\,STRING\/\fR
84 use STRING as product name
85 .TP
86 \fB\-\-product\-version\fR=\fI\,STRING\/\fR
87 use STRING as product version
88 .TP
89 \fB\-\-rom\-directory\fR=\fI\,DIR\/\fR
90 save ROM images in DIR [optional]
91 .TP
92 \fB\-\-sparc\-boot\fR
93 enable sparc boot. Disables HFS+, APM, ARCS and
94 boot as disk image for i386\-pc
95 .TP
96 \fB\-\-xorriso\fR=\fI\,FILE\/\fR
97 use FILE as xorriso [optional]
98 .TP
99 \-?, \fB\-\-help\fR
100 give this help list
101 .TP
102 \fB\-\-usage\fR
103 give a short usage message
104 .TP
105 \fB\-V\fR, \fB\-\-version\fR
106 print program version
107 .PP
108 Mandatory or optional arguments to long options are also mandatory or optional
109 for any corresponding short options.
110 .PP
111 Generates a bootable CD/USB/floppy image. Arguments other than options to
112 this program are passed to xorriso, and indicate source files, source
113 directories, or any of the mkisofs options listed by the output of `xorriso
114 \fB\-as\fR mkisofs \fB\-help\fR'.
115 .PP
116 Option \fB\-\-\fR switches to native xorriso command mode.
117 .PP
118 Mail xorriso support requests to <bug\[email protected]>.
119 .SH "REPORTING BUGS"
120 Report bugs to <bug\[email protected]>.
121 .SH "SEE ALSO"
122 .BR grub-mkimage (1)
123 .PP
124 The full documentation for
125 .B grub-mkrescue
126 is maintained as a Texinfo manual. If the
127 .B info
128 and
129 .B grub-mkrescue
130 programs are properly installed at your site, the command
131 .IP
132 .B info grub-mkrescue
133 .PP
134 should give you access to the complete manual.