grub2: Invoking grub2-install
1
1 23 Invoking grub2-install
1 *************************
1
1 The program 'grub2-install' generates a GRUB core image using
1 'grub2-mkimage' and installs it on your system. You must specify the
1 device name on which you want to install GRUB, like this:
1
1 grub2-install INSTALL_DEVICE
1
1 The device name INSTALL_DEVICE is an OS device name or a GRUB device
1 name.
1
1 In order to support UEFI Secure Boot, the resulting GRUB EFI binary
1 must be signed by a recognized private key. For this reason, for EFI
1 platforms, most distributions also ship prebuilt GRUB EFI binaries
1 signed by a distribution-specific private key. In this case, however,
1 'grub2-install' should not be used because it would overwrite the signed
1 EFI binary.
1
1 'grub2-install' accepts the following options:
1
1 '--help'
1 Print a summary of the command-line options and exit.
1
1 '--version'
1 Print the version number of GRUB and exit.
1
1 '--boot-directory=DIR'
1 Install GRUB images under the directory 'DIR/grub/' This option is
1 useful when you want to install GRUB into a separate partition or a
1 removable disk. If this option is not specified then it defaults
1 to '/boot', so
1
1 grub2-install /dev/sda
1
1 is equivalent to
1
1 grub2-install --boot-directory=/boot/ /dev/sda
1
1 Here is an example in which you have a separate "boot" partition
1 which is mounted on '/mnt/boot':
1
1 grub2-install --boot-directory=/mnt/boot /dev/sdb
1
1 '--recheck'
1 Recheck the device map, even if '/boot/grub2/device.map' already
1 exists. You should use this option whenever you add/remove a disk
1 into/from your computer.
1
1 '--no-rs-codes'
1 By default on x86 BIOS systems, 'grub2-install' will use some extra
1 space in the bootloader embedding area for Reed-Solomon
1 error-correcting codes. This enables GRUB to still boot
1 successfully if some blocks are corrupted. The exact amount of
1 protection offered is dependent on available space in the embedding
1 area. R sectors of redundancy can tolerate up to R/2 corrupted
1 sectors. This redundancy may be cumbersome if attempting to
1 cryptographically validate the contents of the bootloader embedding
1 area, or in more modern systems with GPT-style partition tables
1 (⇒BIOS installation) where GRUB does not reside in any
1 unpartitioned space outside of the MBR. Disable the Reed-Solomon
1 codes with this option.
1