colin/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

grub: clarify efiInstallAsRemovable docstring

Browse Source
This commit is contained in:
obadz 2016-09-16 18:09:50 +01:00
parent 1c9ac8aabc
commit eda4f5d409
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
nixos/modules/system/boot/loader/grub/grub.nix
View File

@ -365,22 +365,22 @@ in
Whether to invoke <literal>grub-install</literal> with Whether to invoke <literal>grub-install</literal> with
<literal>--removable</literal>. <literal>--removable</literal>.
Unless turn this on, GRUB will install itself somewhere (exactly Unless you turn this on, GRUB will install itself somewhere in
where depends on other config variables) in <literal>boot.loader.efi.efiSysMountPoint</literal> (exactly where
<literal>boot.loader.efi.efiSysMountPoint</literal>. If you've set depends on other config variables). If you've set
<literal>boot.loader.efi.canTouchEfiVariables</literal> *AND* you <literal>boot.loader.efi.canTouchEfiVariables</literal> *AND* you
are currently booted in UEFI mode, then GRUB will use are currently booted in UEFI mode, then GRUB will use
<literal>efibootmgr</literal> to modify the boot order in the NVRAM's <literal>efibootmgr</literal> to modify the boot order in the
EFI variables of your computer to include this location. If you are EFI variables of your firmware to include this location. If you are
*not* booted in UEFI mode at the time grub is being installed, the *not* booted in UEFI mode at the time GRUB is being installed, the
NVRAM will not be modified, and your system will not find GRUB at NVRAM will not be modified, and your system will not find GRUB at
boot time. GRUB will still succeed (althgouh you'll see a warning boot time. However, GRUB will still return success so you may miss
printed "<literal>efibootmgr: EFI variables are not supported on the warning that gets printed ("<literal>efibootmgr: EFI variables
this system.</literal>"). are not supported on this system.</literal>").
If you do turn this feature on, then GRUB will install itself If you turn this feature on, GRUB will install itself in a special
in a specific special location within <literal>efiSysMountPoint</literal> location within <literal>efiSysMountPoint</literal> (namely
(namely <literal>EFI/boot/boot$arch.efi</literal>) which is the firmwares <literal>EFI/boot/boot$arch.efi</literal>) which the firmwares
are hardcoded to try first, regardless of NVRAM EFI variables. are hardcoded to try first, regardless of NVRAM EFI variables.
To summarize, turn this on if: To summarize, turn this on if:
@ -389,7 +389,7 @@ in
but you are currently booted in legacy mode</listitem> but you are currently booted in legacy mode</listitem>
<listitem>You want to make a drive that will boot regardless of <listitem>You want to make a drive that will boot regardless of
the NVRAM state of the computer (like a USB "removable" drive)</listitem> the NVRAM state of the computer (like a USB "removable" drive)</listitem>
<listitem>You simply dislike the idea of depending on some NVRAM <listitem>You simply dislike the idea of depending on NVRAM
state to make your drive bootable</listitem> state to make your drive bootable</listitem>
</itemizedlist> </itemizedlist>
''; '';