From 137592b45d5512c896f4d0ccab240f6f1e245226 Mon Sep 17 00:00:00 2001 From: dakanji Date: Tue, 8 Oct 2024 05:16:46 +0300 Subject: [PATCH] Update for v0.14.2.AA Release --- CHANGELOG.txt | 2 +- README.md | 88 ++++++++++++++++++++++++------------- config.conf-sample | 106 +++++++++++++++++++-------------------------- include/version.h | 2 +- 4 files changed, 105 insertions(+), 93 deletions(-) diff --git a/CHANGELOG.txt b/CHANGELOG.txt index 7a881ee2..edb327bb 100644 --- a/CHANGELOG.txt +++ b/CHANGELOG.txt @@ -1,4 +1,4 @@ -0.14.2.AA (PRE-RELEASE): +0.14.2.AA (08 OCT 2024): ----------------------- - Synced with Upstream v0.14.2 - Fixes Handling `Windows Recovery Tools` Volumes diff --git a/README.md b/README.md index 75c22b09..dd18bb4f 100644 --- a/README.md +++ b/README.md @@ -24,12 +24,15 @@ RefindPlus is particularly useful for those with additional configuration needs Some features: - Maintains feature and configuration parity with the base upstream version. -- Provides protection against damage to Mac nvRAM when booting UEFI Windows. -- Provides option to avoid boot failures and associated freezes on T2/TPM chipped units. +- Provides protection against damage to vulnerable Mac nvRAM by UEFI Windows boot. +- Provides mitigation against boot failures and related issues on T2/TPM chipped units. - Provides Pre-Boot Configuration Screen on units running GPUs without native EFI on Macs. -- Extensive memory management improvements with associated speed and stability gains. - Emulates UEFI 2.x on EFI 1.x units to permit running UEFI 2.x utilities on such units. -- Provides improved support for languages that use unicode text. +- Extensive memory management improvements with associated speed and stability gains. +- Provides improved text display support for languages that require unicode text. +- Identifies and automatically handles `Ventoy` instances if present. + - Rationalises binaries displayed. + - Displays an `os_ventoy` icon if available. - Adds a debug (DBG) binary that provides extensive logging. - The release (REL) binary is an optimised build for day to day use. - Fixes inability to print to screen on some Macs. @@ -50,15 +53,29 @@ Some features: ## Installation -[MyBootMgr](https://www.dakanji.com/creations/index.html) is recommended to automate installing RefindPlus on macOS. Alternatively, as the RefindPlus efi file can function as a drop-in replacement for the upstream efi file, the [rEFInd package](https://www.rodsbooks.com/refind/installing.html) can be installed first and its efi file replaced with the RefindPlus efi file. (Ensure the RefindPlus efi file is renamed to match). This manual process allows installing RefindPlus on other operating systems supported upstream. On macOS, MyBootMgr can optionally be used to set a RefindPlus|OpenCore chain-loading arrangement up for MacPro3,1 to MacPro5,1 as well as on Xserve2,1 and Xserve3,1. +[MyBootMgr](https://www.dakanji.com/creations/index.html) is recommended to automate installing RefindPlus when running macOS on Intel-based Macs. Alternatively, as the RefindPlus efi file can function as a drop-in replacement for the upstream efi file, the [rEFInd package](https://www.rodsbooks.com/refind/installing.html) can be installed first and its efi file replaced with the RefindPlus efi file. (Ensure the RefindPlus efi file is renamed to match). This manual process allows installing RefindPlus on other operating systems supported upstream. + +> [!NOTE] +> +> MyBootMgr can optionally also be used to create a flexible and powerful `RefindPlus|OpenCore` chain-loading arrangement for MacPro3,1 to MacPro5,1 as well as for Xserve2,1 and Xserve3,1. + +Upstream post-release code updates are typically ported to RefindPlus as they happen and as such, the RefindPlus code base is usually at the state of the base upstream release version plus any such updates. The code base typically also includes updates for subsequent upstream release versions since the base version. + +> [!TIP] +> +> Consider replacing upstream filesystem drivers with those packaged with RefindPlus as these are always either exactly the same as upstream versions or have had fixes applied. -Users may also want to replace upstream filesystem drivers with those packaged with RefindPlus as these are always either exactly the same as upstream versions or have had fixes applied. +RefindPlus will function with the upstream configuration file, `refind.conf`, but users may wish to replace this with the RefindPlus configuration file, `config.conf`, to configure the additional options provided by RefindPlus. A sample RefindPlus configuration file is available here: [config.conf-sample](https://github.com/dakanji/RefindPlus/blob/GOPFix/config.conf-sample). -> Upstream post-release code updates are typically ported to RefindPlus as they happen and as such, the RefindPlus code base is usually at the state of the base upstream release version plus any such updates. The code base typically also includes updates for subsequent upstream release versions since the base version. +> [!TIP] +> +> RefindPlus-specific options can also be simply added to upstream configuration files. -RefindPlus will function with the upstream configuration file, `refind.conf`, but users may wish to replace this with the RefindPlus configuration file, `config.conf`, to configure the additional options provided by RefindPlus. A sample RefindPlus configuration file is available here: [config.conf-sample](https://github.com/dakanji/RefindPlus/blob/GOPFix/config.conf-sample). RefindPlus-specific options can also be added to an upstream configuration file and used that way if preferred. +When run without activating RefindPlus-specific configuration options, as will be the case with unmodified upstream configuration files, a RefindPlus run will be equivalent to running the upstream version it is based on, currently v0.14.2. That is, the additional options provided in RefindPlus must be actively enabled if they are required. -When run without activating RefindPlus-specific configuration options, as will be the case if using an unmodified upstream configuration file, a RefindPlus run will be equivalent to running the upstream version it is based on, currently v0.14.1. That is, the additional options provided in RefindPlus must be actively enabled if they are required. This equivalence is subject to a few divergent items in RefindPlus as outlined under the [Divergence Section](https://github.com/dakanji/RefindPlus#divergence) below. +> [!NOTE] +> +> This equivalence is subject to a few divergent items as outlined under the [Divergence Section](https://github.com/dakanji/RefindPlus#divergence) below. ## Additional Functionality @@ -72,9 +89,8 @@ continue_on_warning |Proceed as if a key was pressed after screen warnings (fo csr_dynamic |Actively enables or disables Apple's `System Integrity Protection` (SIP) csr_normalise |Removes the `APPLE_INTERNAL` bit, when present, to permit OTA updates decline_help_icon |Disables feature that may improve loading speed by preferring generic icons -decline_help_scan |Disables feature that skips showing misc typically unwanted loaders decline_help_size |Disables feature that sets additional UI scaling for very high DPI screens -decline_help_text |Disables complementary text colours if not required +decline_help_text |Disables feature that sets screen text to complementary colours decouple_key_f10 |Unmaps the `F10` key from native screenshots (the `\` key remains mapped) disable_apfs_load |Disables inbuilt provision of APFS filesystem capability disable_apfs_sync |Disables feature allowing direct APFS/FileVault boot (Without "PreBoot") @@ -90,7 +106,6 @@ disable_set_applefb |Disables provision, under some circumstances, of missing disable_set_consolegop|Disables feature that fixes some issues with GOP graphics on legacy units enable_esp_filter |Prevents other ESPs other than the RefindPlus ESP being scanned for loaders force_trim |Forces `TRIM` on Third-Party SSDs on Macs if required -handle_ventoy |Rationalises the binaries displayed for `Ventoy` instances hidden_icons_external |Allows scanning for `.VolumeIcon` icons on external volumes hidden_icons_ignore |Disables scanning for `.VolumeIcon` image icons if not required hidden_icons_prefer |Prioritises `.VolumeIcon` and `.VolumeBadge` image icons when available @@ -121,8 +136,9 @@ In addition to the new functionality listed above, the following upstream tokens - **"timeout":** The default is no timeout unless explicitly set. - **"use_nvram":** RefindPlus variables are written to the file system, not the motherboard's nvRAM chip, unless explicitly set to do so by activating this configuration token. - **"use_graphics_for":** Additional options added: - - `none` option to disable graphics mode loading for everything. - - `everything` option to enable graphics mode loading for everything. + - `tools` option to _enable_ graphics mode loading for such. + - `none` option to _disable_ graphics mode loading for everything. + - `everything` option to _enable_ graphics mode loading for everything. - `OpenCore` and `Clover` can be specifically set to load in graphics mode. - **"showtools":** Additional tool added: - `clean_nvram` : Allows resetting nvRAM directly from RefindPlus. @@ -148,23 +164,37 @@ In addition to the new functionality listed above, the following upstream tokens ## Divergence Significant visible implementation differences vis-a-vis the upstream base are: -- **GZipped Loaders:** RefindPlus only provides stub support for handling GZipped loaders as this is largely only relevant for units on the ARM architecture. This stub support is only used for debug logging in RefindPlus and can be activated using the same `support_gzipped_loaders` configuration token as upstream. -- **Screenshots:** These are saved in the PNG format with a significantly smaller file size. Additionally, the file naming is slightly different and the files are always saved to the same ESP as the RefindPlus efi file. -- **UI Flags:** RefindPlus requires that any desired previously set `hideui` configuration token options are explicitly defined in supplementary/theme configuration files; as whenever the token is found in such files, the token setting is reset by RefindPlus to the specified option(s). This is consistent with how other configuration tokens in such files are handled. The upstream implementation effectively adds new settings to any previously existing ones for this configuration token instead. -- **UI Scaling:** WQHD monitors are correctly determined not to be HiDPI monitors and UI elements are not scaled up on such monitors when the RefindPlus-specific `scale_ui` configuration token is set to automatically detect the screen resolution. RefindPlus also takes vertically orientated screens into account and additionally scales UI elements down when low resolution screens (less than 1025px on the longest edge) are detected. Additionally, UI elements on extremely high resultion screens (greater than 5999px on the longest edge) receive a `4X scaling` as opposed to the `2X scaling` applied for standard HiDPI screens. -- **Loader Icons:** RefindPlus defaults to preferring generic icons for loaders ahead of the slower to load custom icons where possible. The upstream icon search implementation involves only loading such icons after a search for custom icons has not turned anything up. Users can activate the RefindPlus-specific `decline_help_icon` configuration token to use the upstream icon search implementation instead of the RefindPlus default. -- **GOP Driver Provision:** RefindPlus attempts to ensure that UEFI 2.x GOP drivers are available on EFI 1.x units by attempting to reload such drivers when it detects an absence of GOP on such units to permit the use of modern GPUs on legacy units. Users that wish to disable this feature can activate the RefindPlus-specific `disable_reload_gop` configuration token to switch it off. -- **Apple Framebuffer Provision:** RefindPlus defaults to always providing Apple framebuffers on Macs, when not available under certain circumstances. This is done using an inbuilt `SetAppleFB` feature. Users that wish to disable this feature can activate the RefindPlus-specific `disable_set_applefb` configuration token to switch it off. -- **APFS Filesystem Provision:** RefindPlus defaults to always providing APFS Filesystem capability, when not available but is required, without a need to load an APFS driver. This is done using an inbuilt `SupplyAPFS` feature. Users that wish to disable this feature can activate the RefindPlus-specific `disable_apfs_load` configuration token to switch it off. -- **APFS PreBoot Volumes:** RefindPlus always synchronises APFS System and PreBoot partitions transparently such that the Preboot partitions of APFS volumes are always used to boot APFS formatted macOS. Hence, a single option for booting macOS on APFS volumes is presented in RefindPlus to provide maximum APFS compatibility. Users that wish to disable this feature can activate the RefindPlus-specific `disable_apfs_sync` configuration token to switch it off. -- **Mac nvRAM Protection:** RefindPlus always prevents UEFI Windows Secure Boot from saving certificates to Mac nvRAM as this can result in damage and an inability to boot. Blocking these certificates does not impact the operation of UEFI Windows on Macs. This filtering only happens when Mac firmware is detected and is not applied to other types of firmware. Users that wish to disable this feature can activate the RefindPlus-specific `disable_nvram_protect` configuration token to switch it off. -- **Mac Legacy BIOS Boot:** RefindPlus originally assumed all Macs were capable of legacy BIOS boot based on code that went in upstream back in 2012 when this was a reasonable default. However, some later Intel Macs do not support legacy BIOS boot and RefindPlus now attempts to categorise Macs to enable/disable legacy boot accordingly. Users can activate the RefindPlus-specific `disable_legacy_sync` configuration token to base legacy BIOS boot availability on the old assumption. -- **Secondary Configuration Files:** While the upstream documentation prohibits including tertiary configuration files from secondary configuration files, there is no mechanism enforcing this prohibition. Hence, tertiary, quaternary, quinary, and more, configuration files can in fact be included. RefindPlus enforces a limitation to secondary configuration files. -- **Disabled Manual Stanzas:** The processing of a user configured boot stanza is halted, and the `Entry` object immediately discarded, once a `Disabled` setting is encountered. The outcome is the same as upstream, which always continues to create and return a fully built object in such cases to be discarded later. The approach adopted in RefindPlus allows for an optimised loading process particularly when such `Disabled` tokens are placed immediately after the `menuentry` line (see examples near the bottom of the `config.conf-sample` file). This also applies to `submenuentry` items which can be enabled or disabled separately. -- **Pointer Device Priority:** The upstream implementation of pointer device priority is based on how the `enable_mouse` and `enable_touch` pointer device control tokens appear in the configuration file(s) when both are active. The last pointer device control token read in the main configuration file and/or any supplementary/override configuration file will be used and the other disregarded. In RefindPlus however, `enable_touch` always takes priority when both tokens are active without regard to the order of appearance in the configuration file(s). This means that to use a mouse in RefindPlus, `enable_touch` must be disabled (default) in addition to enabling `enable_mouse`. +- **GZipped Loaders:** RefindPlus only provides stub support for handling GZipped loaders as this is largely only relevant for units on the ARM architecture. + - > This stub support is only used for debug logging in RefindPlus and can be activated using the same `support_gzipped_loaders` configuration token as upstream. +- **Screenshots:** These are saved in the PNG format with a significantly smaller file size. + - > Additionally, the file naming is slightly different and the files are always saved to the same ESP as the RefindPlus efi file. +- **UI Flags:** RefindPlus requires that any desired previously set `hideui` configuration token options are explicitly defined in supplementary/theme configuration files; as whenever the token is found in such files, the token setting is reset by RefindPlus to the specified option(s). The upstream implementation effectively adds new settings to any previously existing ones for this configuration token instead. + - > The RefindPlus implementation maintains consistency with how other configuration tokens are handled. +- **UI Scaling:** WQHD monitors are correctly determined not to be HiDPI monitors and UI elements are not scaled up on such monitors when the RefindPlus-specific `scale_ui` configuration token is set to automatically detect the screen resolution. RefindPlus also takes vertically orientated screens into account and additionally scales UI elements down when low resolution screens (less than 1025px on the longest edge) are detected. + - > Additionally, UI elements on extremely high resultion screens (greater than 5999px on the longest edge) receive a `4X scaling` as opposed to the `2X scaling` applied for standard HiDPI screens. +- **Loader Icons:** RefindPlus defaults to preferring generic icons for loaders ahead of the slower to load custom icons where possible. The upstream icon search implementation involves only loading such icons after a search for custom icons has not turned anything up. + - > Activate the RefindPlus-specific `decline_help_icon` configuration token to use the upstream icon search implementation instead of the RefindPlus default. +- **GOP Driver Provision:** RefindPlus attempts to ensure that UEFI 2.x GOP drivers are available on EFI 1.x units by attempting to reload such drivers when it detects an absence of GOP on such units to permit the use of modern GPUs on legacy units. + - > Activate the RefindPlus-specific `disable_reload_gop` configuration token to switch this feature off. +- **Apple Framebuffer Provision:** RefindPlus defaults to always providing Apple framebuffers on Macs, when not available under certain circumstances. This is done using an inbuilt `SetAppleFB` feature. + - > Activate the RefindPlus-specific `disable_set_applefb` configuration token to switch this feature off. +- **APFS Filesystem Provision:** RefindPlus defaults to always providing APFS Filesystem capability, when not available but is required, without a need to load an APFS driver. This is done using an inbuilt `SupplyAPFS` feature. + - > Activate the RefindPlus-specific `disable_apfs_load` configuration token to switch this feature off. +- **APFS PreBoot Volumes:** RefindPlus always synchronises APFS System and PreBoot partitions transparently such that the Preboot partitions of APFS volumes are always used to boot APFS formatted macOS. Hence, a single option for booting macOS on APFS volumes is presented in RefindPlus to provide maximum APFS compatibility. + - > Activate the RefindPlus-specific `disable_apfs_sync` configuration token to switch this feature off. +- **Mac nvRAM Protection:** RefindPlus always prevents UEFI Windows Secure Boot from saving certificates to Mac nvRAM as this can result in damage and an inability to boot. Blocking these certificates does not impact the operation of UEFI Windows on Macs. This filtering only happens when Mac firmware is detected and is not applied to other types of firmware. + - > Activate the RefindPlus-specific `disable_nvram_protect` configuration token to switch this feature off. +- **Mac Legacy BIOS Boot:** RefindPlus originally assumed all Macs were capable of legacy BIOS boot based on code that went in upstream back in 2012 when this was a reasonable default. However, some later Intel Macs do not support legacy BIOS boot and RefindPlus now attempts to categorise Macs to enable/disable legacy boot accordingly. + - > Activate the RefindPlus-specific `disable_legacy_sync` configuration token to base legacy BIOS boot availability on the old assumption. +- **Secondary Configuration Files:** While the upstream documentation prohibits including tertiary configuration files from secondary configuration files, there is no mechanism enforcing this prohibition. Hence, tertiary, quaternary, quinary, and more, configuration files can in fact be included. + - > The RefindPlus implementation enforces the limitation for inclusion to secondary configuration files. +- **Disabled Manual Stanzas:** The processing of a user configured boot stanza is halted, and the `Entry` object immediately discarded, once a `Disabled` setting is encountered. The outcome is the same as upstream, which always continues to create and return a fully built object in such cases to be discarded later. The approach adopted in RefindPlus allows for an optimised loading process particularly when such `Disabled` tokens are placed immediately after the `menuentry` line (see examples near the bottom of the `config.conf-sample` file). + - > This also applies to `submenuentry` items which can be enabled or disabled separately. +- **Pointer Device Priority:** The upstream implementation of pointer device priority is based on how the `enable_mouse` and `enable_touch` pointer device control tokens appear in the configuration file(s) when both are active. The last pointer device control token read in the main configuration file and/or any supplementary/override configuration file will be used and the other disregarded. In RefindPlus however, `enable_touch` always takes priority when both tokens are active without regard to the order of appearance in the configuration file(s). + - > Hence, to use a mouse in RefindPlus, `enable_touch` must be disabled (default) in addition to enabling `enable_mouse`. ## Roll Your Own -Refer to [BUILDING.md](https://github.com/dakanji/RefindPlus/blob/GOPFix/BUILDING.md) for build instructions (x86_64 Only). +Refer to [BUILDING.md](https://github.com/dakanji/RefindPlus/blob/GOPFix/BUILDING.md) for build instructions. [CLICK HERE](https://github.com/dakanji/RefindPlus/blob/GOPFix/README-Dev.md) for the ReadMe file related to the current (work in progress) code base. diff --git a/config.conf-sample b/config.conf-sample index 58a0fa93..11e4c248 100644 --- a/config.conf-sample +++ b/config.conf-sample @@ -63,16 +63,6 @@ # #decline_help_icon -# The "HelpScan" feature always adds program defaults to 'dont_scan-xyz' lists. -# This deviates from the upstream implementation where such program defaults are -# overwritten unless a "+" item is added as the first item of user defined entries. -# These program defaults ensure that certain items are not shown as first row icons. -# Users that wish to disable the default "HelpScan" feature can activate this option. -# -# The "HelpScan" feature is active when commented out -# -#decline_help_scan - # The "HelpSize" feature always adds additional UI scaling whenever screens # with 'ExDPI' resolutions are detected for which the 2x scaling applied for # the 'HiDPI' resolutions may not be sufficient. The 'ExDPI' resolutions are @@ -289,16 +279,6 @@ # #force_trim -# The 'Ventoy' tool allows flexibly running ISO images, typically Linux. -# However, it comes with multiple loaders, many of which have incompatible -# CPU architectures, that show on the RefindPlus screen but are not unusable. -# When this token is active, only the relevant Ventoy loader is shown instead. -# NB: Default Ventoy naming is required for proper instance identification. -# -# Inactive when commented out (Does not specifically manage Ventoy) -# -#handle_ventoy - # RefindPlus defaults to only scanning for ".VolumeIcon" icons on "internal" # volumes. However, when this token is active (and the "hidden_icons_ignore" # token is not) RefindPlus will also scan "external" volumes for these icons. @@ -423,11 +403,11 @@ # #persist_boot_args -# RefindPlus defaults to using the Graphic Output Protocol (GOP) for graphics -# output if available and only falls backs on the Universal Graphics Adapter +# RefindPlus defaults to using the Graphics Output Protocol (GOP) +# to render displays and only falls backs on the Universal Graphics Adapter # (UGA) when this is available and GOP is not. When this setting is active, # it will instead always use UGA when available and will not consider GOP. -# This may also improve RefindPlus loading speed on legacy UGA-Only GPUs. +# This may also improve RefindPlus loading speed on legacy UGA-only GPUs. # # Inactive when commented out (Does not prefer UGA over GOP for graphics) # @@ -541,7 +521,6 @@ # - bluetoothInternalControllerinfo # - bluetoothActiveControllerInfo # - bluetoothExternalDongleFailed -# - opencore-version (macOS boots ... including installers) # # This token accepts these options: # 0 - Sync is never attempted (Default/Base Option:- Y) @@ -555,7 +534,6 @@ # 2. Option '1' is as '4' when 'transient_boot' is active # 3. Option '2' is as '3' when 'transient_boot' is active # 4. Qualifying boots are macOS, OpenCore or Clover boots -# 5. opencore-version when *NOT* chainloaded via OpenCore # # Inactive when commented out (Does not sync nvRAM) # @@ -566,22 +544,22 @@ # this issue. The 'SyncTrust' feature is useful on computers running enhanced # boot security setups, particularly in conjunction with T2/TPM chipped units. # -# macos - macOS loader -# linux - Linux loaders -# windows - Windows loader -# clover - The Clover boot-loader -# opencore - The OpenCore boot-loader -# similar - Any other uEFI loader -# verify - Always check first -# every - All of the above -# none - None of the above (default) +# macos - macOS Loader +# windows - Windows Loader +# linux - Linux Stub Loader +# clover - Clover Boot Loader +# opencore - OpenCore Boot Loader +# similar - Any Other uEFI Loader +# verify - Always Check First +# every - All of the Above +# none - None of the Above (Default) # # NOTES: # 1. The 'every' option takes precedence over others apart from 'none' # 2. The 'none' option takes precedence over every other setting # 3. The 'DirectBoot' feature is disabled by this token # -# Inactive when commented out or set to 'none' (Does not trigger native reboots) +# Inactive when commented out or set to 'none' (Does not trigger reboots) # #sync_trust macos verify @@ -772,7 +750,8 @@ # NB: Requires external program # See documentation for details # memtest - Memory Testing Utility. -# NB: Requires external memtest program +# NB: Requires external program +# Only the first valid instance found is presented # gptsync - The (Dangerous) 'GPTsync' Utility. # NB: Requires external program # See documentation for details @@ -780,7 +759,8 @@ # NB: Requires external program # See documentation for details # clean_nvram - Enables nvRAM Reset from RefindPlus. -# NB: Needs External program. +# NB: Requires external program +# Only the first valid instance found is presented # apple_recovery - Loads Apple Mac Recovery partitions, if present # windows_recovery - Boots an OEM Windows recovery tool, if present. # NB: Also refer to the "windows_recovery_files" option @@ -844,15 +824,16 @@ # That is, 'use_graphics_for' alone works like setting 'everything'. # # Valid options: -# none - No loader -# osx - macOS loader -# windows - Windows loader -# linux - Linux stub loader -# grub - The GRUB boot loader -# elilo - The ELILO boot loader -# clover - The Clover boot loader -# opencore - The OpenCore boot loader -# everything - Graphics for every loader +# none - No Loader +# osx - macOS Loader +# windows - Windows Loader +# linux - Linux Stub Loader +# grub - The GRUB Boot Loader +# elilo - The ELILO Boot Loader +# clover - The Clover Boot Loader +# opencore - The OpenCore Boot Loader +# tools - 2nd Row Items:- All Tools +# everything - For All Loaders and Tools # # NOTES: # 1. The 'everything' option takes precedence over others apart from 'none' @@ -904,6 +885,13 @@ #also_scan_dirs ESP2:EFI/linux/kernels #also_scan_dirs @/kernels,@/root/boot +# Additional directories to scan for tools. You may specify a directory +# alone or a volume identifier plus pathname. The default is to scan no +# extra directories, beyond EFI/tools, EFI/BOOT/tools and any directory +# in which a uEFI loader is found. +# +#also_scan_tool_dirs EFI/memtest,ESP2:/EFI/tools/memtest86 + # Use a custom title banner and not the default (embedded) banner. The # file path is relative to the directory where the RefindPlus binary is # located. The colour of the top left corner of the image is used for the @@ -963,17 +951,11 @@ # This token takes precedence if a directory is listed both here and in # "also_scan_dirs". Note that this applies to ALL the filesystems that # RefindPlus scans, and not just the ESP, unless the directory name -# is preceded by a filesystem name or partition unique GUID, such -# as "myvol:EFI/somedir", to exclude EFI/somedir from the scan -# on the "myvol" volume but not on other volumes. -# -# The default setting is L"EFI/tools_{arch},EFI\tools, -# EFI\tools_{arch}\memtest86,EFI\tools_{arch}\memtest,EFI\tools_{arch}\memtest86p, -# EFI\tools\memtest86,EFI\tools\memtest,EFI\tools\memtest86p, -# EFI\BOOT\tools_{arch}\memtest86,EFI\BOOT\tools_{arch}\memtest, -# EFI\BOOT\tools_{arch}\memtest86p,EFI\BOOT\tools\memtest86,EFI\BOOT\tools\memtest, -# EFI\BOOT\tools\memtest86p,EFI\BOOT\memtest86,EFI\BOOT\memtest,EFI\BOOT\memtest86p, -# EFI\memtest86,EFI\memtest,EFI\memtest86p" ("{arch}" is architecture, such as "x64"). +# is preceded by a filesystem name or unique partition GUID, such +# as "myvol:EFI/somedir", to exclude the "EFI/somedir" path from +# being scanned on the "myvol" volume but not on other volumes. +# +# The default is the "SelfDir" path. # # Uses default setting when commented out # @@ -1292,12 +1274,12 @@ # #windows_recovery_files LRS_ESP:/EFI/Microsoft/Boot/LrsBootmgr.efi -# Set 'systemd' nvRAM variables (currently only LoaderDevicePartUUID) -# when launching Linux via an EFI stub loader, ELILO, or GRUB. This -# variable, when present, causes systemd to mount the ESP at /boot -# *IF* that directory is empty and nothing else is mounted there. +# Passes variable settings to 'SystemD' (currently LoaderDevicePartUUID) +# when launching Linux instances. This variable setting, when present, +# causes SystemD to mount the ESP as '/boot' *IF* that directory +# is empty and nothing else has been mounted there earlier. # -# Inactive when commented out (No nvRAM variable write attempt) +# Inactive when commented out (variable is not set) # #write_systemd_vars diff --git a/include/version.h b/include/version.h index ed2e16a6..537bb9af 100644 --- a/include/version.h +++ b/include/version.h @@ -16,4 +16,4 @@ * Modifications distributed under the preceding terms. */ -#define REFINDPLUS_VERSION L"0.14.2.AA (PRE-RELEASE)" +#define REFINDPLUS_VERSION L"0.14.2.AA"