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