]> code.delx.au - refind/blobdiff - refind.conf-sample
New configuration token, deep_uefi_legacy_scan, controls whether to
[refind] / refind.conf-sample
index 15beb1fb4907e2e5f1b6a679ef882fe299b5a41d..e06c5c3eb39d74641db239950d6e64e5f1fcfc6c 100644 (file)
@@ -51,6 +51,25 @@ timeout 20
 #banner hostname.bmp
 #banner mybanner.png
 
+# Specify how to handle banners that aren't exactly the same as the screen
+# size:
+#  noscale     - Crop if too big, show with border if too small
+#  fillscreen  - Fill the screen
+# Default is noscale
+#
+#banner_scale fillscreen
+
+# Icon sizes. All icons are square, so just one value is specified. The
+# big icons are used for OS selectors in the first row and the small
+# icons are used for tools on the second row. Drive-type badges are 1/4
+# the size of the big icons. Legal values are 32 and above. If the icon
+# files do not hold icons of the proper size, the icons are scaled to
+# the specified size. The default values are 48 and 128 for small and
+# big icons, respectively.
+#
+#small_icon_size 96
+#big_icon_size 256
+
 # Custom images for the selection background. There is a big one (144 x 144)
 # for the OS icons, and a small one (64 x 64) for the function icons in the
 # second row. If only a small image is given, that one is also used for
@@ -138,6 +157,7 @@ timeout 20
 #                     EFI/memtest, EFI/tools/memtest86, or EFI/tools/memtest
 #  gptsync          - the (dangerous) gptsync.efi utility (requires external
 #                     program; see rEFInd documentation for details)
+#  gdisk            - the gdisk partitioning program
 #  apple_recovery   - boots the Apple Recovery HD partition, if present
 #  windows_recovery - boots an OEM Windows recovery tool, if present
 #                     (see also the windows_recovery_files option)
@@ -150,12 +170,13 @@ timeout 20
 #  reboot           - a tag to reboot the computer
 #  firmware         - a tag to reboot the computer into the firmware's
 #                     user interface (ignored on older computers)
-# Default is shell,memtest,apple_recovery,mok_tool,about,shutdown,reboot,firmware
+# Default is shell,memtest,gdisk,apple_recovery,windows_recovery,mok_tool,about,shutdown,reboot,firmware
 #
-#showtools shell, memtest, mok_tool, about, reboot, exit, firmware
+#showtools shell, gdisk, memtest, mok_tool, about, reboot, exit, firmware
 
 # Boot loaders that can launch a Windows restore or emergency system.
 # These tend to be OEM-specific.
+# Default is LRS_ESP:/EFI/Microsoft/Boot/LrsBootmgr.efi
 #
 #windows_recovery_files LRS_ESP:/EFI/Microsoft/Boot/LrsBootmgr.efi
 
@@ -186,6 +207,15 @@ timeout 20
 #
 #scanfor internal,external,optical,manual
 
+# By default, rEFInd relies on the UEFI firmware to detect BIOS-mode boot
+# devices. This sometimes doesn't detect all the available devices, though.
+# For these cases, deep_uefi_legacy_scan results in a forced scan and
+# modification of NVRAM variables on each boot. Adding "0", "off", or
+# "false" resets to the default value. This token has no effect on Macs or
+# when no BIOS-mode options are set via scanfor.
+# Default is unset (or "deep_uefi_legacy_scan true")
+#deep_uefi_legacy_scan
+
 # Delay for the specified number of seconds before scanning disks.
 # This can help some users who find that some of their disks
 # (usually external or optical discs) aren't detected initially,
@@ -209,10 +239,13 @@ timeout 20
 #
 #also_scan_dirs boot,ESP2:EFI/linux/kernels
 
-# Partitions to omit from scans. You must specify a volume by its
-# label, which you can obtain in an EFI shell by typing "vol", from
-# Linux by typing "blkid /dev/{devicename}", or by examining the
-# disk's label in various OSes' file browsers.
+# Partitions (or whole disks, for legacy-mode boots) to omit from scans.
+# For EFI-mode scans, you must specify a volume by its label, which you
+# can obtain in an EFI shell by typing "vol", from Linux by typing
+# "blkid /dev/{devicename}", or by examining the disk's label in various
+# OSes' file browsers.
+# For legacy-mode scans, you can specify any subset of the boot loader
+# description shown when you highlight the option in rEFInd.
 # The default is "Recovery HD,LRS_ESP".
 #
 #dont_scan_volumes "Recovery HD"
@@ -242,12 +275,15 @@ timeout 20
 # the main binary or if you want to "blacklist" certain loaders by
 # name rather than location, use this option. Note that this will
 # NOT prevent certain binaries from showing up in the second-row
-# set of tools. Most notably, MokManager.efi is in this blacklist,
-# but will show up as a tool if present in certain directories. You
-# can control the tools row with the showtools token.
-# The default is shim.efi,PreLoader.efi,TextMode.efi,ebounce.efi,
-# GraphicsConsole.efi,MokManager.efi,HashTool.efi,HashTool-signed.efi,
-# bootmgr.efi
+# set of tools. Most notably, various Secure Boot and recovery
+# tools are present in this list, but may appear as second-row
+# items.
+# The file may be specified as a bare name (e.g., "notme.efi"), as
+# a complete filename (e.g., "/EFI/somedir/notme.efi"), or as a
+# complete filename with volume (e.g., "SOMEDISK:/EFI/somedir/notme.efi").
+# The default is shim.efi,shim-fedora.efi,shimx64.efi,PreLoader.efi,
+# TextMode.efi,ebounce.efi,GraphicsConsole.efi,MokManager.efi,HashTool.efi,
+# HashTool-signed.efi,bootmgr.efi
 #
 #dont_scan_files shim.efi,MokManager.efi