Debian Codegraph @

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

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