.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH GRUB-MKRESCUE "1" "March 2024" "GRUB 2.06" "User Commands"
.SH NAME
grub-mkrescue \- make a GRUB rescue image
.SH SYNOPSIS
.B grub-mkrescue
[\fI\,OPTION\/\fR...] [\fI\,OPTION\/\fR] \fI\,SOURCE\/\fR...
.SH DESCRIPTION
Make GRUB CD\-ROM, disk, pendrive and floppy bootable image.
.TP
\fB\-\-appended\-signature\-size\fR=\fI\,SIZE\/\fR
Add a note segment reserving SIZE bytes for an
appended signature
.TP
\fB\-\-compress\fR=\fI\,no\/\fR|xz|gz|lzo
compress GRUB files [optional]
.TP
\fB\-\-disable\-shim\-lock\fR
disable shim_lock verifier
.TP
\fB\-\-dtb\fR=\fI\,FILE\/\fR
embed a specific DTB
.TP
\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
use images and modules under DIR
[default=/usr/lib/grub/<platform>]
.TP
\fB\-\-fonts\fR=\fI\,FONTS\/\fR
install FONTS [default=unicode]
.TP
\fB\-\-install\-modules\fR=\fI\,MODULES\/\fR
install only MODULES and their dependencies
[default=all]
.TP
\fB\-k\fR, \fB\-\-pubkey\fR=\fI\,FILE\/\fR
embed FILE as public key for signature checking
.TP
\fB\-\-locale\-directory\fR=\fI\,DIR\/\fR use translations under DIR
[default=/usr/share/locale]
.TP
\fB\-\-locales\fR=\fI\,LOCALES\/\fR
install only LOCALES [default=all]
.TP
\fB\-\-modules\fR=\fI\,MODULES\/\fR
pre\-load specified modules MODULES
.TP
\fB\-\-sbat\fR=\fI\,FILE\/\fR
SBAT metadata
.TP
\fB\-\-themes\fR=\fI\,THEMES\/\fR
install THEMES [default=starfield]
.TP
\fB\-v\fR, \fB\-\-verbose\fR
print verbose messages.
.TP
\fB\-x\fR, \fB\-\-x509key\fR=\fI\,FILE\/\fR
embed FILE as an x509 certificate for signature
checking
.TP
\fB\-\-arcs\-boot\fR
enable ARCS (big\-endian mips machines, mostly
SGI) boot. Disables HFS+, APM, sparc64 and boot
as disk image for i386\-pc
.TP
\fB\-\-core\-compress\fR=\fI\,xz\/\fR|none|auto
choose the compression to use for core image
.TP
\fB\-\-label\-bgcolor\fR=\fI\,COLOR\/\fR
use COLOR for label background
.TP
\fB\-\-label\-color\fR=\fI\,COLOR\/\fR
use COLOR for label
.TP
\fB\-\-label\-font\fR=\fI\,FILE\/\fR
use FILE as font for label
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
save output in FILE [required]
.TP
\fB\-\-product\-name\fR=\fI\,STRING\/\fR
use STRING as product name
.TP
\fB\-\-product\-version\fR=\fI\,STRING\/\fR
use STRING as product version
.TP
\fB\-\-rom\-directory\fR=\fI\,DIR\/\fR
save ROM images in DIR [optional]
.TP
\fB\-\-sparc\-boot\fR
enable sparc boot. Disables HFS+, APM, ARCS and
boot as disk image for i386\-pc
.TP
\fB\-\-xorriso\fR=\fI\,FILE\/\fR
use FILE as xorriso [optional]
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-V\fR, \fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
Generates a bootable CD/USB/floppy image.  Arguments other than options to
this program are passed to xorriso, and indicate source files, source
directories, or any of the mkisofs options listed by the output of `xorriso
\fB\-as\fR mkisofs \fB\-help\fR'.
.PP
Option \fB\-\-\fR switches to native xorriso command mode.
.PP
Mail xorriso support requests to <bug\-xorriso@gnu.org>.
.SH "REPORTING BUGS"
Report bugs to <bug\-grub@gnu.org>.
.SH "SEE ALSO"
.BR grub-mkimage (1)
.PP
The full documentation for
.B grub-mkrescue
is maintained as a Texinfo manual.  If the
.B info
and
.B grub-mkrescue
programs are properly installed at your site, the command
.IP
.B info grub-mkrescue
.PP
should give you access to the complete manual.