diff --git a/Docs/Configuration.pdf b/Docs/Configuration.pdf index 426345ea..9a22dae2 100644 Binary files a/Docs/Configuration.pdf and b/Docs/Configuration.pdf differ diff --git a/Docs/Configuration.tex b/Docs/Configuration.tex index 6920d2e5..2edfcbe0 100755 --- a/Docs/Configuration.tex +++ b/Docs/Configuration.tex @@ -4566,6 +4566,13 @@ be used. Version with macOS specific enhancements can be downloaded from \textbf{Description}: Update Data Hub fields. These fields are read from \texttt{Generic} or \texttt{DataHub} sections depending on \texttt{Automatic} value. + + \emph{Note}: The implementation of the Data Hub protocol in EFI firmware on + essentially all systems, including Apple hardware, means that existing Data Hub + entries cannot be overridden, while new entries are added to the end with + macOS ignoring them. You can work around this by reinstalling the Data Hub + protocol using the \texttt{ProtocolOverrides} section. Refer to the \texttt{DataHub} + protocol override description for details. \item \texttt{UpdateNVRAM}\\ \textbf{Type}: \texttt{plist\ boolean}\\ @@ -6559,15 +6566,21 @@ functioning. Feature highlights: \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Reinstalls Data Hub protocol with a builtin version. - This will delete all previous properties if the protocol was already installed. + + \emph{Note}: This will discard all previous entries if the protocol was already + installed, so all properties required for safe operation of the system must be + specified in your configuration. \item \texttt{DeviceProperties}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Reinstalls Device Property protocol with a builtin - version. This will delete all previous properties if it was already installed. - This may be used to ensure full compatibility on VMs or legacy Macs. + version. This may be used to ensure full compatibility on VMs or legacy Macs. + + \emph{Note}: This will discard all previous entries if the protocol was already + installed, so all properties required for safe operation of the system must be + specified in your configuration. \item \texttt{FirmwareVolume}\\ diff --git a/Docs/Differences/Differences.pdf b/Docs/Differences/Differences.pdf index 68b4bdf0..be6510eb 100644 Binary files a/Docs/Differences/Differences.pdf and b/Docs/Differences/Differences.pdf differ diff --git a/Docs/Differences/Differences.tex b/Docs/Differences/Differences.tex index 00533aab..15ff73b3 100644 --- a/Docs/Differences/Differences.tex +++ b/Docs/Differences/Differences.tex @@ -1,7 +1,7 @@ \documentclass[]{article} %DIF LATEXDIFF DIFFERENCE FILE -%DIF DEL PreviousConfiguration.tex Tue Feb 2 21:33:12 2021 -%DIF ADD ../Configuration.tex Tue Feb 2 21:35:18 2021 +%DIF DEL PreviousConfiguration.tex Wed Feb 3 11:12:00 2021 +%DIF ADD ../Configuration.tex Thu Feb 4 09:54:49 2021 \usepackage{lmodern} \usepackage{amssymb,amsmath} @@ -4626,7 +4626,15 @@ be used. Version with macOS specific enhancements can be downloaded from \textbf{Description}: Update Data Hub fields. These fields are read from \texttt{Generic} or \texttt{DataHub} sections depending on \texttt{Automatic} value. -\item +\DIFaddbegin + + \emph{\DIFadd{Note}}\DIFadd{: The implementation of the Data Hub protocol in EFI firmware on + essentially all systems, including Apple hardware, means that existing Data Hub + entries cannot be overridden, while new entries are added to the end with + macOS ignoring them. You can work around this by reinstalling the Data Hub + protocol using the }\texttt{\DIFadd{ProtocolOverrides}} \DIFadd{section. Refer to the }\texttt{\DIFadd{DataHub}} + \DIFadd{protocol override description for details. +}\DIFaddend \item \texttt{UpdateNVRAM}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ @@ -6619,15 +6627,24 @@ functioning. Feature highlights: \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Reinstalls Data Hub protocol with a builtin version. - This will delete all previous properties if the protocol was already installed. +\DIFdelbegin \DIFdel{This will delete all previous properties }\DIFdelend \DIFaddbegin + + \emph{\DIFadd{Note}}\DIFadd{: This will discard all previous entries }\DIFaddend if the protocol was already + installed\DIFaddbegin \DIFadd{, so all properties required for safe operation of the system must be + specified in your configuration}\DIFaddend . \item \texttt{DeviceProperties}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Reinstalls Device Property protocol with a builtin - version. This will delete all previous properties if it was already installed. - This may be used to ensure full compatibility on VMs or legacy Macs. + version. This \DIFdelbegin \DIFdel{will delete all previous properties if it was already installed. + This }\DIFdelend may be used to ensure full compatibility on VMs or legacy Macs\DIFaddbegin \DIFadd{. +} + + \emph{\DIFadd{Note}}\DIFadd{: This will discard all previous entries if the protocol was already + installed, so all properties required for safe operation of the system must be + specified in your configuration}\DIFaddend . \item \texttt{FirmwareVolume}\\ diff --git a/Docs/Errata/Errata.pdf b/Docs/Errata/Errata.pdf index 3d5eb84c..ba278f19 100644 Binary files a/Docs/Errata/Errata.pdf and b/Docs/Errata/Errata.pdf differ