183 lines
6.0 KiB
HTML
183 lines
6.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of GRUB-INSTALL</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>GRUB-INSTALL</H1>
|
|
Section: System Administration Utilities (8)<BR>Updated: February 2021<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
grub-install - install GRUB to a device
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>grub-install</B>
|
|
|
|
[<I>,OPTION/</I>...] [<I>,OPTION/</I>] [<I>,INSTALL_DEVICE/</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Install GRUB on your drive.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--compress</B>=<I>,no/</I>|xz|gz|lzo<DD>
|
|
compress GRUB files [optional]
|
|
<DT id="2"><B>--dtb</B>=<I>,FILE/</I><DD>
|
|
embed a specific DTB
|
|
<DT id="3"><B>-d</B>, <B>--directory</B>=<I>,DIR/</I><DD>
|
|
use images and modules under DIR
|
|
[default=/usr/lib/grub/<platform>]
|
|
<DT id="4"><B>--fonts</B>=<I>,FONTS/</I><DD>
|
|
install FONTS [default=unicode]
|
|
<DT id="5"><B>--install-modules</B>=<I>,MODULES/</I><DD>
|
|
install only MODULES and their dependencies
|
|
[default=all]
|
|
<DT id="6"><B>-k</B>, <B>--pubkey</B>=<I>,FILE/</I><DD>
|
|
embed FILE as public key for signature checking
|
|
<DT id="7"><B>--locale-directory</B>=<I>,DIR/</I> use translations under DIR<DD>
|
|
[default=/usr/share/locale]
|
|
<DT id="8"><B>--locales</B>=<I>,LOCALES/</I><DD>
|
|
install only LOCALES [default=all]
|
|
<DT id="9"><B>--modules</B>=<I>,MODULES/</I><DD>
|
|
pre-load specified modules MODULES
|
|
<DT id="10"><B>--themes</B>=<I>,THEMES/</I><DD>
|
|
install THEMES [default=starfield]
|
|
<DT id="11"><B>-v</B>, <B>--verbose</B><DD>
|
|
print verbose messages.
|
|
<DT id="12"><B>--allow-floppy</B><DD>
|
|
make the drive also bootable as floppy (default
|
|
for fdX devices). May break on some BIOSes.
|
|
<DT id="13"><B>--boot-directory</B>=<I>,DIR/</I><DD>
|
|
install GRUB images under the directory DIR/grub
|
|
instead of the boot/grub directory
|
|
<DT id="14"><B>--bootloader-id</B>=<I>,ID/</I><DD>
|
|
the ID of bootloader. This option is only
|
|
available on EFI and Macs.
|
|
<DT id="15"><B>--core-compress</B>=<I>,xz/</I>|none|auto<DD>
|
|
choose the compression to use for core image
|
|
<DT id="16"><B>--disk-module</B>=<I>,MODULE/</I><DD>
|
|
disk module to use (biosdisk or native). This
|
|
option is only available on BIOS target.
|
|
<DT id="17"><B>--efi-directory</B>=<I>,DIR/</I><DD>
|
|
use DIR as the EFI System Partition root.
|
|
<DT id="18"><B>--force</B><DD>
|
|
install even if problems are detected
|
|
<DT id="19"><B>--force-file-id</B><DD>
|
|
use identifier file even if UUID is available
|
|
<DT id="20"><B>--label-bgcolor</B>=<I>,COLOR/</I><DD>
|
|
use COLOR for label background
|
|
<DT id="21"><B>--label-color</B>=<I>,COLOR/</I><DD>
|
|
use COLOR for label
|
|
<DT id="22"><B>--label-font</B>=<I>,FILE/</I><DD>
|
|
use FILE as font for label
|
|
<DT id="23">
|
|
<B>--macppc-directory</B>=<I>,DIR/</I> use DIR for PPC MAC install.
|
|
<DT id="24"><B>--no-bootsector</B><DD>
|
|
<DD>do not install bootsector
|
|
<DT id="25"><B>--no-extra-removable</B><DD>
|
|
Do not install bootloader code to the removable
|
|
media path. This option is only available on EFI.
|
|
<DT id="26"><B>--no-nvram</B><DD>
|
|
don't update the `boot-device'/`Boot*' NVRAM
|
|
variables. This option is only available on EFI
|
|
and IEEE1275 targets.
|
|
<DT id="27"><B>--no-rs-codes</B><DD>
|
|
Do not apply any reed-solomon codes when
|
|
embedding core.img. This option is only available
|
|
on x86 BIOS targets.
|
|
<DT id="28"><B>--no-uefi-secure-boot</B><DD>
|
|
do not install an image usable with UEFI Secure
|
|
Boot, even if the system was currently started
|
|
using it. This option is only available on EFI.
|
|
<DT id="29"><B>--product-version</B>=<I>,STRING/</I><DD>
|
|
use STRING as product version
|
|
<DT id="30"><B>--recheck</B><DD>
|
|
delete device map if it already exists
|
|
<DT id="31"><B>--removable</B><DD>
|
|
the installation device is removable. This option
|
|
is only available on EFI.
|
|
<DT id="32"><B>-s</B>, <B>--skip-fs-probe</B><DD>
|
|
do not probe for filesystems in DEVICE
|
|
<DT id="33"><B>--target</B>=<I>,TARGET/</I><DD>
|
|
install GRUB for TARGET platform
|
|
[default=i386-pc]; available targets:
|
|
arm-coreboot, arm-efi, arm-uboot, arm64-efi,
|
|
i386-coreboot, i386-efi, i386-ieee1275,
|
|
i386-multiboot, i386-pc, i386-qemu, i386-xen,
|
|
i386-xen_pvh, ia64-efi, mips-arc, mips-qemu_mips,
|
|
mipsel-arc, mipsel-loongson, mipsel-qemu_mips,
|
|
powerpc-ieee1275, riscv32-efi, riscv64-efi,
|
|
sparc64-ieee1275, x86_64-efi, x86_64-xen
|
|
<DT id="34"><B>--uefi-secure-boot</B><DD>
|
|
install an image usable with UEFI Secure Boot.
|
|
This option is only available on EFI and if the
|
|
grub-efi-amd64-signed package is installed.
|
|
<DT id="35">-?, <B>--help</B><DD>
|
|
give this help list
|
|
<DT id="36"><B>--usage</B><DD>
|
|
give a short usage message
|
|
<DT id="37"><B>-V</B>, <B>--version</B><DD>
|
|
print program version
|
|
</DL>
|
|
<P>
|
|
|
|
Mandatory or optional arguments to long options are also mandatory or optional
|
|
for any corresponding short options.
|
|
<P>
|
|
|
|
INSTALL_DEVICE must be system device filename.
|
|
grub-install copies GRUB images into boot/grub. On some platforms, it may
|
|
also install GRUB into the boot sector.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
Report bugs to <<A HREF="mailto:bug-grub@gnu.org">bug-grub@gnu.org</A>>.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+grub-mkconfig">grub-mkconfig</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+grub-mkimage">grub-mkimage</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+grub-mkrescue">grub-mkrescue</A></B>(1)
|
|
|
|
<P>
|
|
|
|
The full documentation for
|
|
<B>grub-install</B>
|
|
|
|
is maintained as a Texinfo manual. If the
|
|
<B>info</B>
|
|
|
|
and
|
|
<B>grub-install</B>
|
|
|
|
programs are properly installed at your site, the command
|
|
<DL COMPACT>
|
|
<DT id="38"><DD>
|
|
<B>info grub-install</B>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
should give you access to the complete manual.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="39"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="40"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="41"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="42"><A HREF="#lbAE">REPORTING BUGS</A><DD>
|
|
<DT id="43"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:12 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|