From: srs5694 Date: Sun, 24 Apr 2016 21:58:09 +0000 (-0400) Subject: Documentation updates for 0.10.3 release. X-Git-Url: https://code.delx.au/refind/commitdiff_plain/c234a62eb700ca3167345fc1be035fdcf19999b4 Documentation updates for 0.10.3 release. --- diff --git a/debian/postinst b/debian/postinst index 7503103..51a3b94 100755 --- a/debian/postinst +++ b/debian/postinst @@ -47,11 +47,7 @@ install_to_esp() { ./refind-install --shim $ShimFile --yes > /dev/null fi else - if [[ -n $SBSign && -n $OpenSSL ]] ; then - ./refind-install --localkeys --yes > /dev/null - else - ./refind-install --yes > /dev/null - fi + ./refind-install --yes > /dev/null fi } # install_to_esp() diff --git a/docs/refind/bootcoup.html b/docs/refind/bootcoup.html index 405b09d..5edaf54 100644 --- a/docs/refind/bootcoup.html +++ b/docs/refind/bootcoup.html @@ -16,7 +16,7 @@

by Roderick W. Smith, rodsmith@rodsbooks.com

-

Originally written: 1/28/2016, referencing rEFInd 0.10.2

+

Originally written: 4/24/2016, referencing rEFInd 0.10.3

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

@@ -229,7 +229,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

$ sudo refind-mkdefault
 rEFInd is not the first boot entry; adjusting....
-Setting a boot order of 0000,0002,0085,0003,0081
+Setting a boot order of 0000,0002,0085,0003

The exact output of the script depends on the current state of the system; it might also respond that rEFInd is already the default boot entry or that it could not identify a rEFInd entry, for instance. The boot order shown in this example is meaningless by itself; it's the boot order as identified by efibootmgr; for details, see the next section.

@@ -251,11 +251,10 @@ Setting a boot order of 0000,0002,0085,0003,0081 $ sudo efibootmgr BootCurrent: 0000 Timeout: 0 seconds -BootOrder: 0002,0000,0085,0003,0081 +BootOrder: 0002,0000,0085,0003 Boot0000* rEFInd Boot Manager Boot0002* Windows Boot Manager Boot0003* Windows Boot Manager -Boot0081* Mac OS X Boot0085* ubuntu @@ -265,25 +264,23 @@ Boot0085* ubuntu $ sudo efibootmgr -v BootCurrent: 0000 Timeout: 0 seconds -BootOrder: 0002,0000,0085,0003,0081 +BootOrder: 0002,0000,0085,0003 Boot0000* rEFInd Boot Manager HD(1,800,113000,2491a00e-2a89-4dc4-af21-34c436c8f88a)File(\EFI\refind\shimx64.efi) Boot0002* Windows Boot Manager HD(2,113800,113000,8b0b6d94-06af-4894-b9de-13ca354714a5)File(\EFI\Microsoft\Boot\bootmgfw.efi)WINDOWS.........x...B.C.D.O.B.J.E.C.T.=.{.9.d.e.a.8.6.2.c.-.5.c.d.d.-.4.e.7.0.-.a.c.c.1.-.f.3.2.b.3.4.4.d.4.7.9.5.}.................... Boot0003* Windows Boot Manager HD(1,800,113000,2491a00e-2a89-4dc4-af21-34c436c8f88a)File(\EFI\Microsoft\Boot\bootmgfw.efi)WINDOWS.........x...B.C.D.O.B.J.E.C.T.=.{.9.d.e.a.8.6.2.c.-.5.c.d.d.-.4.e.7.0.-.a.c.c.1.-.f.3.2.b.3.4.4.d.4.7.9.5.}.................... -Boot0081* Mac OS X Vendor(99e275e7-75a0-4b37-a2e6-c5385e6c00cb,)-.o. .-.e.e. .-.f. .e.f.i.-.a.p.p.l.e.-.p.a.y.l.o.a.d.0.-.d.a.t.a... Boot0085* ubuntu HD(1,800,113000,2491a00e-2a89-4dc4-af21-34c436c8f88a)File(EFI\Ubuntu\grubx64.efi)

Much of this output looks like gibberish, and is useful only for very advanced diagnostics. Note, however, the part of most lines that specifies a filename, in parentheses after File—this information can help disambiguate a misleading or redundant name.

To adjust the boot order, you must identify the rEFInd entry and then use the -o option to efibootmgr to adjust the order:

-
$ sudo efibootmgr -o 0000,0085,0002,0003,0081
+
$ sudo efibootmgr -o 0000,0085,0002,0003
 BootCurrent: 0000
 Timeout: 0 seconds
-BootOrder: 0000,0085,0002,0003,0081
+BootOrder: 0000,0085,0002,0003
 Boot0000* rEFInd Boot Manager
 Boot0002* Windows Boot Manager
 Boot0003* Windows Boot Manager
-Boot0081* Mac OS X
 Boot0085* ubuntu

 
 
In this example, I moved rEFInd to the top of the list, followed by ubuntu (GRUB), Windows, and OS X. You can adjust the order in any way you want. You can also omit items you don't want to include—but be aware that if you omit Windows entirely from the boot list, it's likely to add itself back (at the top of the list) the next time you boot it.

@@ -305,7 +302,7 @@ Boot0085* ubuntu
# dpkg -P grub-efi-amd64 grub-efi-amd64-signed grub-common grub-efi-amd64-bin \
   grub-common grub2-common shim-signed
-

The details of what packages you must remove vary from one distribution to another, though. (The preceding examples are from Fedora and Ubuntu installations.) If you're unsure what packages to remove, you may need to use a your package management tools to track down all GRUB-related packages. GUI tools, such as Yumex for Fedora and Synaptic for Debian-based systems, can be very helpful in this task. Unfortunately, you must sometimes remove packages that you might not want to remove—for instance, the preceding example removes shim-signed from Ubuntu because shim-signed contains a dependency on GRUB, but rEFInd can use Shim for its Secure Boot support. Fortunately, if rEFInd is already booting via Shim, removing the shim-signed package will not remove the shimx64.efi binary from rEFInd's directory, so the system will continue to boot—but you also won't receive any Shim updates that might roll along.

+

The details of what packages you must remove vary from one distribution to another, though. (The preceding examples are from Fedora and Ubuntu installations.) If you're unsure what packages to remove, you may need to use your package management tools to track down all GRUB-related packages. GUI tools, such as Yumex for Fedora and Synaptic for Debian-based systems, can be very helpful in this task. Unfortunately, you must sometimes remove packages that you might not want to remove—for instance, the preceding example removes shim-signed from Ubuntu because shim-signed contains a dependency on GRUB, but rEFInd can use Shim for its Secure Boot support. Fortunately, if rEFInd is already booting via Shim, removing the shim-signed package will not remove the shimx64.efi binary from rEFInd's directory, so the system will continue to boot—but you also won't receive any Shim updates that might roll along.

Note also that removing the GRUB packages will not remove the files installed to the EFI System Partition (ESP), so rEFInd will continue to show a GRUB option, normally with an icon for your distribution, in its main menu. If you want to remove that menu entry, you can delete the relevant files, normally from /boot/efi/EFI/distribution_name.

@@ -330,7 +327,7 @@ Boot0085* ubuntu

Using Startup Disk to Adjust Your Boot Priority

-

The Startup Disk utility appears in the System Preferences tool. Unfortunately, it will likely be useless if you installed rEFInd using refind-install and its default options, since this tool is designed to switch between OS X installations; it's not smart enough to detect a rEFInd installation and re-activate it.

+

The Startup Disk utility appears in the System Preferences tool. Unfortunately, it will likely be useless if you installed rEFInd using refind-install and its default options, since Startup Disk is designed to switch between OS X installations; it's not smart enough to detect a rEFInd installation and re-activate it.

If, however, you installed rEFInd by using the --ownhfs option to refind-install, your rEFInd installation volume should show up as an option in the Startup Disk utility. You should be able to click on it and then click Restart. Note that the name of the rEFInd volume may not be rEFInd, as it is in this screen shot; the name will match whatever volume holds rEFInd on your computer.

@@ -475,7 +472,7 @@ Boot0085* ubuntu

Version 2 of the EFI shell provides a command, bcfg, which can adjust the EFI boot order. Unfortunately, this tool is not present in version 1 of the EFI shell, and version 2 is reliable only with EFI version 2.3 and later. To date (early 2016), all Intel-based Macs use EFI 1.1, and many PCs sold prior to Windows 8's release use UEFI (EFI 2.x) versions prior to 2.3. Thus, this approach may not work for you.

-

Even if your computer works with a version 2 shell, it may not have one built in. In fact, most EFIs I've seen lack a built-in shell. If a shell is available, it should appear on the EFI's built-in boot manager, as described earlier, in Evading the Guards: Performing a One-Time Boot to Your Desired OS.

If a shell is not built into your firmware, you can add one; here are a few links that may be helpful:

+

Even if your computer works with a version 2 shell, it may not have one built in. In fact, most EFIs I've seen lack a built-in shell. If a shell is available, it should appear on the EFI's built-in boot manager, as described earlier, in Evading the Guards: Performing a One-Time Boot to Your Desired OS. If a shell is not built into your firmware, you can add one; here are a few links that may be helpful:

+

Driver availability could increase in the future. If you know of additional EFI drivers, please tell me about them, so I can share the information here. Likewise if you diff --git a/docs/refind/easyuefi.png b/docs/refind/easyuefi.png index e5dfe4c..bb97add 100644 Binary files a/docs/refind/easyuefi.png and b/docs/refind/easyuefi.png differ diff --git a/docs/refind/features.html b/docs/refind/features.html index 634bef9..6d5bcf9 100644 --- a/docs/refind/features.html +++ b/docs/refind/features.html @@ -17,7 +17,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

Originally written: 3/14/2012; last Web page update: -1/26/2016, referencing rEFInd 0.10.2

+4/24/2016, referencing rEFInd 0.10.3

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

diff --git a/docs/refind/getting.html b/docs/refind/getting.html index 97dd794..cc40df6 100644 --- a/docs/refind/getting.html +++ b/docs/refind/getting.html @@ -17,7 +17,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

Originally written: 3/14/2012; last Web page update: -1/26/2016, referencing rEFInd 0.10.2

+4/24/2016, referencing rEFInd 0.10.3

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

@@ -132,7 +132,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com