diff --git a/Docs/Configuration.md5 b/Docs/Configuration.md5 index 71256a47..c898ec3b 100644 --- a/Docs/Configuration.md5 +++ b/Docs/Configuration.md5 @@ -1 +1 @@ -896e53e7e20bab69a5f0c0aaed33c45b +1a71d1870e336326d90153724e52def0 diff --git a/Docs/Configuration.pdf b/Docs/Configuration.pdf index 06ab78cf..2aaf99c1 100644 Binary files a/Docs/Configuration.pdf and b/Docs/Configuration.pdf differ diff --git a/Docs/Configuration.tex b/Docs/Configuration.tex index 63a03755..88a3528f 100755 --- a/Docs/Configuration.tex +++ b/Docs/Configuration.tex @@ -1484,7 +1484,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \tightlist \item No better slide exists (all the memory is used) \item \texttt{slide=0} is forced (by an argument or safe mode) - \item KASLR (slide) is unsupported (this is macOS 10.7 or older) + \item KASLR (slide) is unsupported (this is Mac OS X 10.7 or older) \end{itemize} This quirk requires \texttt{ProvideCustomSlide} to be enabled and @@ -1617,7 +1617,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \textbf{Description}: Fix errors in early Mac OS X boot.efi images. Modern secure PE loaders will refuse to load \texttt{boot.efi} images from - macOS 10.4 to 10.12 due to these files containing \texttt{W\^{}X} errors + Mac OS X 10.4 to macOS 10.12 due to these files containing \texttt{W\^{}X} errors (in all versions) and illegal overlapping sections (in 10.4 and 10.5 32-bit versions only). @@ -1646,7 +1646,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. within their filesystem. \end{itemize} - \emph{Note 3}: This quirk is needed for macOS 10.4 to 10.12 (and + \emph{Note 3}: This quirk is needed for Mac OS X 10.4 to macOS 10.12 (and higher, if Apple secure boot is not enabled), but only when the firmware itself includes a modern, more secure PE COFF image loader. This applies to current builds of OpenDuet, and to OVMF if built from audk source code. @@ -1802,7 +1802,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \emph{Note 2}: The need for this quirk is determined by early boot failures. This quirk replaces \texttt{EnableWriteUnprotector} on firmware supporting Memory Attribute Tables (MAT). This quirk is typically unnecessary when using - \texttt{OpenDuetPkg} but may be required to boot macOS 10.6, and earlier, for + \texttt{OpenDuetPkg} but may be required to boot Mac OS X 10.6, and earlier, for reasons that are as yet unclear. \item @@ -2948,7 +2948,7 @@ Kernel and kext changes apply with the following effective order: \texttt{XhciPortLimit}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ - \textbf{Requirement}: 10.11 (not required for older)\\ + \textbf{Requirement}: 10.11+ (not required for older)\\ \textbf{Description}: Patch various kexts (AppleUSBXHCI.kext, AppleUSBXHCIPCI.kext, IOUSBHostFamily.kext) to remove USB port count limit of 15 ports. @@ -2984,13 +2984,13 @@ to install and troubleshoot such macOS installations. \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Use \texttt{kernelcache} with different checksums when available. - On macOS 10.6 and earlier, \texttt{kernelcache} filename has a checksum, which essentially + On Mac OS X 10.6 and earlier, \texttt{kernelcache} filename has a checksum, which essentially is \texttt{adler32} from SMBIOS product name and EfiBoot device path. On certain firmware, the EfiBoot device path differs between UEFI and macOS due to ACPI or hardware specifics, rendering \texttt{kernelcache} checksum as always different. This setting allows matching the latest \texttt{kernelcache} with a suitable architecture - when the \texttt{kernelcache} without suffix is unavailable, improving macOS 10.6 boot + when the \texttt{kernelcache} without suffix is unavailable, improving Mac OS X 10.6 boot performance on several platforms. \item @@ -3000,7 +3000,7 @@ to install and troubleshoot such macOS installations. \textbf{Description}: Prefer specified kernel architecture (\texttt{i386}, \texttt{i386-user32}, \texttt{x86\_64}) when available. - On macOS 10.7 and earlier, the XNU kernel can boot with architectures different from + On Mac OS X 10.7 and earlier, the XNU kernel can boot with architectures different from the usual \texttt{x86\_64}. This setting will use the specified architecture to boot macOS when it is supported by the macOS and the configuration: @@ -3014,9 +3014,9 @@ to install and troubleshoot such macOS installations. \tightlist \item On macOS, 64-bit capable processors are assumed to support \texttt{SSSE3}. This is not the case for older 64-bit capable Pentium - processors, which cause some applications to crash on macOS~10.6. This behaviour + processors, which cause some applications to crash on Mac OS X~10.6. This behaviour corresponds to the \texttt{-legacy} kernel boot argument. - \item This option is unavailable on macOS~10.4 and 10.5 when running on 64-bit firmware + \item This option is unavailable on Mac OS X~10.4 and 10.5 when running on 64-bit firmware due to an uninitialised 64-bit segment in the XNU kernel, which causes AppleEFIRuntime to incorrectly execute 64-bit code as 16-bit code. \end{itemize} @@ -3053,20 +3053,20 @@ to install and troubleshoot such macOS installations. \texttt{x86\_64}, \texttt{i386}, \texttt{i386-user32}. \end{enumerate} - Unlike macOS~10.7 (where certain board identifiers are treated as \texttt{i386} - only machines), and macOS~10.5 or earlier (where \texttt{x86\_64} is not supported - by the macOS kernel), macOS~10.6 is very special. The architecture choice on macOS~10.6 + Unlike Mac OS X~10.7 (where certain board identifiers are treated as \texttt{i386} + only machines), and Mac OS X~10.5 or earlier (where \texttt{x86\_64} is not supported + by the macOS kernel), Mac OS X~10.6 is very special. The architecture choice on Mac OS X~10.6 depends on many factors including not only the board identifier, but also the macOS product type (client vs server), macOS point release, and amount of RAM. The detection of all these is complicated and impractical, as several point releases had implementation flaws resulting in a failure to properly execute the server detection in the first place. - For this reason when \texttt{Auto} is set, OpenCore on macOS~10.6 falls back + For this reason when \texttt{Auto} is set, OpenCore on Mac OS X~10.6 falls back to the \texttt{x86\_64} architecture when it is supported by the board, as - on macOS~10.7. The 32-bit \texttt{KernelArch} options can still be configured + on Mac OS X~10.7. The 32-bit \texttt{KernelArch} options can still be configured explicitly however. A 64-bit Mac model compatibility matrix corresponding to actual - EfiBoot behaviour on macOS 10.6.8 and 10.7.5 is outlined below. + EfiBoot behaviour on Mac OS X 10.6.8 and 10.7.5 is outlined below. \begin{center} \begin{tabular}{|p{0.9in}|c|c|c|c|} @@ -3880,8 +3880,8 @@ the default boot entry choice will remain changed until the next manual reconfig \begin{itemize} \tightlist \item \texttt{Acidanthera\textbackslash GoldenGate} --- macOS 11 styled icon set. - \item \texttt{Acidanthera\textbackslash Syrah} --- macOS 10.10 styled icon set. - \item \texttt{Acidanthera\textbackslash Chardonnay} --- macOS 10.4 styled icon set. + \item \texttt{Acidanthera\textbackslash Syrah} --- OS X 10.10 styled icon set. + \item \texttt{Acidanthera\textbackslash Chardonnay} --- Mac OS X 10.4 styled icon set. \end{itemize} For convenience purposes there also are predefined aliases: @@ -6556,7 +6556,7 @@ even cause permanent firmware damage. Some of the known drivers are listed below builtin \texttt{KeySupport}, which may work better or worse depending on the firmware. \\ \href{https://github.com/acidanthera/OpenCorePkg}{\texttt{OpenPartitionDxe}}\textbf{*} & Partition management driver with Apple Partitioning Scheme support. - This driver can be used to support loading older DMG recoveries such as macOS 10.9 + This driver can be used to support loading older DMG recoveries such as OS X 10.9 using Apple Partitioning Scheme, or for loading other macOS Installers where these were created using the Apple Partitioning Scheme (creating macOS Installers using GPT avoids the need for this). OpenDuet already includes this driver. \\ @@ -8721,7 +8721,7 @@ OpenCore is installed, in order for the \texttt{Launchd.command} script to work \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Replaces the Apple Framebuffer Info protocol with a builtin version. This may be used to override framebuffer information on VMs and legacy Macs - to improve compatibility with legacy EfiBoot such as the one in macOS 10.4. + to improve compatibility with legacy EfiBoot such as the one in Mac OS X 10.4. \emph{Note}: The current implementation of this property results in it only being active when GOP is available (it is always equivalent to \texttt{false} otherwise). @@ -9188,7 +9188,7 @@ image and modify it if necessary. Visit this archived Apple Support for a list of the bundled device-specific builds for legacy operating systems. However, as this may not always be accurate, the latest versions are listed below. -\subsubsection{macOS 10.8 and 10.9}\label{legacy108} +\subsubsection{OS X 10.8 and 10.9}\label{legacy108} \begin{itemize} \item Disk images on these systems use the Apple Partitioning Scheme @@ -9202,31 +9202,31 @@ However, as this may not always be accurate, the latest versions are listed belo loading in order to inject networking or audio drivers. \end{itemize} -\subsubsection{macOS 10.7}\label{legacy107} +\subsubsection{Mac OS X 10.7}\label{legacy107} \begin{itemize} \item All previous issues apply. \item \texttt{SSSE3} support (not to be confused with \texttt{SSE3} support) - is a hard requirement for macOS 10.7 kernel. + is a hard requirement for Mac OS X 10.7 kernel. \item Many kexts, including \texttt{Lilu} when 32-bit kernel is used and a lot of \texttt{Lilu} plugins, are - unsupported on macOS~10.7 and older as they require newer - kernel APIs, which are not part of the macOS~10.7 SDK. - \item Prior to macOS~10.8 KASLR sliding is not supported, which + unsupported on Mac OS X~10.7 and older as they require newer + kernel APIs, which are not part of the Mac OS X~10.7 SDK. + \item Prior to OS X~10.8 KASLR sliding is not supported, which will result in memory allocation failures on firmware that utilise lower memory for their own purposes. Refer to \href{https://github.com/acidanthera/bugtracker/issues/1125}{acidanthera/bugtracker\#1125} for tracking. \end{itemize} -\subsubsection{macOS 10.6}\label{legacy106} +\subsubsection{Mac OS X 10.6}\label{legacy106} \begin{itemize} \item All previous issues apply. - \item \texttt{SSSE3} support is a requirement for macOS 10.6 kernel + \item \texttt{SSSE3} support is a requirement for Mac OS X 10.6 kernel with 64-bit userspace enabled. This limitation can mostly be lifted by enabling the \texttt{LegacyCommpage} quirk. - \item Last released installer images for macOS~10.6 are macOS~10.6.7 + \item Last released installer images for Mac OS X~10.6 are Mac OS X~10.6.7 builds \texttt{10J3250} (for \texttt{MacBookPro8,x}) and \texttt{10J4139} (for \texttt{iMac12,x}), without Xcode). These images are limited to their target model identifiers and have no @@ -9234,9 +9234,9 @@ However, as this may not always be accurate, the latest versions are listed belo (with \texttt{ACDT} suffix) without model restrictions can be found \href{https://archive.org/details/10.6.7-10j3250-disk-images}{here} (\href{https://mega.nz/folder/z5YUhYTb#gA\_IRY5KMuYpnNCg7kR3ug}{MEGA Mirror}), - assuming macOS~10.6 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming Mac OS X~10.6 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that these are the earliest tested - versions of macOS~10.6 with OpenCore. + versions of Mac OS X~10.6 with OpenCore. \end{itemize} Model checking may also be erased by editing \texttt{OSInstall.mpkg} @@ -9267,7 +9267,7 @@ rm -rf DS_STORE RW hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg \end{lstlisting} -\subsubsection{macOS 10.5}\label{legacy105} +\subsubsection{Mac OS X 10.5}\label{legacy105} \begin{itemize} \item All previous issues apply. @@ -9279,25 +9279,25 @@ hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg \texttt{Mkext} kext injection will still work without noticeable performance drain and will be chosen automatically when \texttt{KernelCache} is set to \texttt{Auto}. - \item Last released installer image for macOS~10.5 is macOS~10.5.7 + \item Last released installer image for Mac OS X~10.5 is Mac OS X~10.5.7 build \texttt{9J3050} (for \texttt{MacBookPro5,3}). Unlike the others, this image is not limited to the target model identifiers and can be used as is. The original \texttt{9J3050} image can be found \href{https://archive.org/details/10.5.7-9-j-3050}{here} (\href{https://mega.nz/folder/inRBTarD#zanf7fUbviwz3WHBU5xpCg}{MEGA Mirror}), - assuming macOS~10.5 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming Mac OS X~10.5 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that this is the earliest tested - version of macOS~10.5 with OpenCore. + version of Mac OS X~10.5 with OpenCore. \end{itemize} -\subsubsection{macOS 10.4}\label{legacy104} +\subsubsection{Mac OS X 10.4}\label{legacy104} \begin{itemize} \item All previous issues apply. \item This macOS version has a hard requirement to access all the optional packages on the second DVD disk installation media, requiring either two disks or USB media installation. - \item Last released installer images for macOS~10.4 are macOS~10.4.10 + \item Last released installer images for Mac OS X~10.4 are Mac OS X~10.4.10 builds \texttt{8R4061a} (for \texttt{MacBookPro3,1}) and \texttt{8R4088} (for \texttt{iMac7,1})). These images are limited to their target model identifiers as on newer macOS versions. @@ -9305,9 +9305,9 @@ hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg model restrictions can be found \href{https://archive.org/details/10.4.10-8-r-4088-acdt}{here} (\href{https://mega.nz/folder/D3ASzLzA\#7sjYXE2X09f6aGjol\_C7dg}{MEGA Mirror}), - assuming macOS~10.4 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming Mac OS X~10.4 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that these are the earliest tested - versions of macOS~10.4 with OpenCore. + versions of Mac OS X~10.4 with OpenCore. \end{itemize} \subsection{UEFI Secure Boot}\label{uefisecureboot} diff --git a/Docs/Differences/Differences.pdf b/Docs/Differences/Differences.pdf index ca1dacc0..deaf32c8 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 3874765a..d82f80c9 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 Mar 12 09:53:49 2024 -%DIF ADD ../Configuration.tex Tue Mar 12 09:53:49 2024 +%DIF DEL PreviousConfiguration.tex Tue Mar 12 23:19:24 2024 +%DIF ADD ../Configuration.tex Wed Mar 13 00:03:04 2024 \usepackage{lmodern} \usepackage{amssymb,amsmath} @@ -118,7 +118,7 @@ %DIF HYPERREF PREAMBLE %DIF PREAMBLE \providecommand{\DIFadd}[1]{\texorpdfstring{\DIFaddtex{#1}}{#1}} %DIF PREAMBLE \providecommand{\DIFdel}[1]{\texorpdfstring{\DIFdeltex{#1}}{}} %DIF PREAMBLE -%DIF COLORLISTINGS PREAMBLE %DIF PREAMBLE +%DIF LISTINGS PREAMBLE %DIF PREAMBLE \RequirePackage{listings} %DIF PREAMBLE \RequirePackage{color} %DIF PREAMBLE \lstdefinelanguage{DIFcode}{ %DIF PREAMBLE @@ -1544,7 +1544,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \tightlist \item No better slide exists (all the memory is used) \item \texttt{slide=0} is forced (by an argument or safe mode) - \item KASLR (slide) is unsupported (this is macOS 10.7 or older) + \item KASLR (slide) is unsupported (this is \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.7 or older) \end{itemize} This quirk requires \texttt{ProvideCustomSlide} to be enabled and @@ -1677,7 +1677,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \textbf{Description}: Fix errors in early Mac OS X boot.efi images. Modern secure PE loaders will refuse to load \texttt{boot.efi} images from - macOS 10.4 to 10.12 due to these files containing \texttt{W\^{}X} errors + \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.4 to \DIFaddbegin \DIFadd{macOS }\DIFaddend 10.12 due to these files containing \texttt{W\^{}X} errors (in all versions) and illegal overlapping sections (in 10.4 and 10.5 32-bit versions only). @@ -1706,7 +1706,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. within their filesystem. \end{itemize} - \emph{Note 3}: This quirk is needed for macOS 10.4 to 10.12 (and + \emph{Note 3}: This quirk is needed for \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.4 to \DIFaddbegin \DIFadd{macOS }\DIFaddend 10.12 (and higher, if Apple secure boot is not enabled), but only when the firmware itself includes a modern, more secure PE COFF image loader. This applies to current builds of OpenDuet, and to OVMF if built from audk source code. @@ -1862,7 +1862,7 @@ To view their current state, use the \texttt{pmset -g} command in Terminal. \emph{Note 2}: The need for this quirk is determined by early boot failures. This quirk replaces \texttt{EnableWriteUnprotector} on firmware supporting Memory Attribute Tables (MAT). This quirk is typically unnecessary when using - \texttt{OpenDuetPkg} but may be required to boot macOS 10.6, and earlier, for + \texttt{OpenDuetPkg} but may be required to boot \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6, and earlier, for reasons that are as yet unclear. \item @@ -3008,7 +3008,7 @@ Kernel and kext changes apply with the following effective order: \texttt{XhciPortLimit}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ - \textbf{Requirement}: 10.11 (not required for older)\\ + \textbf{Requirement}: 10.11\DIFaddbegin \DIFadd{+ }\DIFaddend (not required for older)\\ \textbf{Description}: Patch various kexts (AppleUSBXHCI.kext, AppleUSBXHCIPCI.kext, IOUSBHostFamily.kext) to remove USB port count limit of 15 ports. @@ -3044,13 +3044,13 @@ to install and troubleshoot such macOS installations. \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Use \texttt{kernelcache} with different checksums when available. - On macOS 10.6 and earlier, \texttt{kernelcache} filename has a checksum, which essentially + On \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6 and earlier, \texttt{kernelcache} filename has a checksum, which essentially is \texttt{adler32} from SMBIOS product name and EfiBoot device path. On certain firmware, the EfiBoot device path differs between UEFI and macOS due to ACPI or hardware specifics, rendering \texttt{kernelcache} checksum as always different. This setting allows matching the latest \texttt{kernelcache} with a suitable architecture - when the \texttt{kernelcache} without suffix is unavailable, improving macOS 10.6 boot + when the \texttt{kernelcache} without suffix is unavailable, improving \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6 boot performance on several platforms. \item @@ -3060,7 +3060,7 @@ to install and troubleshoot such macOS installations. \textbf{Description}: Prefer specified kernel architecture (\texttt{i386}, \texttt{i386-user32}, \texttt{x86\_64}) when available. - On macOS 10.7 and earlier, the XNU kernel can boot with architectures different from + On \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.7 and earlier, the XNU kernel can boot with architectures different from the usual \texttt{x86\_64}. This setting will use the specified architecture to boot macOS when it is supported by the macOS and the configuration: @@ -3074,9 +3074,9 @@ to install and troubleshoot such macOS installations. \tightlist \item On macOS, 64-bit capable processors are assumed to support \texttt{SSSE3}. This is not the case for older 64-bit capable Pentium - processors, which cause some applications to crash on macOS~10.6. This behaviour + processors, which cause some applications to crash on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6. This behaviour corresponds to the \texttt{-legacy} kernel boot argument. - \item This option is unavailable on macOS~10.4 and 10.5 when running on 64-bit firmware + \item This option is unavailable on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.4 and 10.5 when running on 64-bit firmware due to an uninitialised 64-bit segment in the XNU kernel, which causes AppleEFIRuntime to incorrectly execute 64-bit code as 16-bit code. \end{itemize} @@ -3113,20 +3113,20 @@ to install and troubleshoot such macOS installations. \texttt{x86\_64}, \texttt{i386}, \texttt{i386-user32}. \end{enumerate} - Unlike macOS~10.7 (where certain board identifiers are treated as \texttt{i386} - only machines), and macOS~10.5 or earlier (where \texttt{x86\_64} is not supported - by the macOS kernel), macOS~10.6 is very special. The architecture choice on macOS~10.6 + Unlike \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.7 (where certain board identifiers are treated as \texttt{i386} + only machines), and \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.5 or earlier (where \texttt{x86\_64} is not supported + by the macOS kernel), \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 is very special. The architecture choice on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 depends on many factors including not only the board identifier, but also the macOS product type (client vs server), macOS point release, and amount of RAM. The detection of all these is complicated and impractical, as several point releases had implementation flaws resulting in a failure to properly execute the server detection in the first place. - For this reason when \texttt{Auto} is set, OpenCore on macOS~10.6 falls back + For this reason when \texttt{Auto} is set, OpenCore on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 falls back to the \texttt{x86\_64} architecture when it is supported by the board, as - on macOS~10.7. The 32-bit \texttt{KernelArch} options can still be configured + on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.7. The 32-bit \texttt{KernelArch} options can still be configured explicitly however. A 64-bit Mac model compatibility matrix corresponding to actual - EfiBoot behaviour on macOS 10.6.8 and 10.7.5 is outlined below. + EfiBoot behaviour on \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6.8 and 10.7.5 is outlined below. \begin{center} \begin{tabular}{|p{0.9in}|c|c|c|c|} @@ -3940,8 +3940,8 @@ the default boot entry choice will remain changed until the next manual reconfig \begin{itemize} \tightlist \item \texttt{Acidanthera\textbackslash GoldenGate} --- macOS 11 styled icon set. - \item \texttt{Acidanthera\textbackslash Syrah} --- macOS 10.10 styled icon set. - \item \texttt{Acidanthera\textbackslash Chardonnay} --- macOS 10.4 styled icon set. + \item \texttt{Acidanthera\textbackslash Syrah} --- \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{OS X }\DIFaddend 10.10 styled icon set. + \item \texttt{Acidanthera\textbackslash Chardonnay} --- \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.4 styled icon set. \end{itemize} For convenience purposes there also are predefined aliases: @@ -6616,7 +6616,7 @@ even cause permanent firmware damage. Some of the known drivers are listed below builtin \texttt{KeySupport}, which may work better or worse depending on the firmware. \\ \href{https://github.com/acidanthera/OpenCorePkg}{\texttt{OpenPartitionDxe}}\textbf{*} & Partition management driver with Apple Partitioning Scheme support. - This driver can be used to support loading older DMG recoveries such as macOS 10.9 + This driver can be used to support loading older DMG recoveries such as \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{OS X }\DIFaddend 10.9 using Apple Partitioning Scheme, or for loading other macOS Installers where these were created using the Apple Partitioning Scheme (creating macOS Installers using GPT avoids the need for this). OpenDuet already includes this driver. \\ @@ -8781,7 +8781,7 @@ OpenCore is installed, in order for the \texttt{Launchd.command} script to work \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Replaces the Apple Framebuffer Info protocol with a builtin version. This may be used to override framebuffer information on VMs and legacy Macs - to improve compatibility with legacy EfiBoot such as the one in macOS 10.4. + to improve compatibility with legacy EfiBoot such as the one in \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.4. \emph{Note}: The current implementation of this property results in it only being active when GOP is available (it is always equivalent to \texttt{false} otherwise). @@ -9248,7 +9248,7 @@ image and modify it if necessary. Visit this archived Apple Support for a list of the bundled device-specific builds for legacy operating systems. However, as this may not always be accurate, the latest versions are listed below. -\subsubsection{macOS 10.8 and 10.9}\label{legacy108} +\subsubsection{\DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{OS X }\DIFaddend 10.8 and 10.9}\label{legacy108} \begin{itemize} \item Disk images on these systems use the Apple Partitioning Scheme @@ -9262,31 +9262,31 @@ However, as this may not always be accurate, the latest versions are listed belo loading in order to inject networking or audio drivers. \end{itemize} -\subsubsection{macOS 10.7}\label{legacy107} +\subsubsection{\DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.7}\label{legacy107} \begin{itemize} \item All previous issues apply. \item \texttt{SSSE3} support (not to be confused with \texttt{SSE3} support) - is a hard requirement for macOS 10.7 kernel. + is a hard requirement for \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.7 kernel. \item Many kexts, including \texttt{Lilu} when 32-bit kernel is used and a lot of \texttt{Lilu} plugins, are - unsupported on macOS~10.7 and older as they require newer - kernel APIs, which are not part of the macOS~10.7 SDK. - \item Prior to macOS~10.8 KASLR sliding is not supported, which + unsupported on \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.7 and older as they require newer + kernel APIs, which are not part of the \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.7 SDK. + \item Prior to \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{OS X}\DIFaddend ~10.8 KASLR sliding is not supported, which will result in memory allocation failures on firmware that utilise lower memory for their own purposes. Refer to \href{https://github.com/acidanthera/bugtracker/issues/1125}{acidanthera/bugtracker\#1125} for tracking. \end{itemize} -\subsubsection{macOS 10.6}\label{legacy106} +\subsubsection{\DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6}\label{legacy106} \begin{itemize} \item All previous issues apply. - \item \texttt{SSSE3} support is a requirement for macOS 10.6 kernel + \item \texttt{SSSE3} support is a requirement for \DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.6 kernel with 64-bit userspace enabled. This limitation can mostly be lifted by enabling the \texttt{LegacyCommpage} quirk. - \item Last released installer images for macOS~10.6 are macOS~10.6.7 + \item Last released installer images for \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 are \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6.7 builds \texttt{10J3250} (for \texttt{MacBookPro8,x}) and \texttt{10J4139} (for \texttt{iMac12,x}), without Xcode). These images are limited to their target model identifiers and have no @@ -9294,9 +9294,9 @@ However, as this may not always be accurate, the latest versions are listed belo (with \texttt{ACDT} suffix) without model restrictions can be found \href{https://archive.org/details/10.6.7-10j3250-disk-images}{here} (\href{https://mega.nz/folder/z5YUhYTb#gA\_IRY5KMuYpnNCg7kR3ug}{MEGA Mirror}), - assuming macOS~10.6 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that these are the earliest tested - versions of macOS~10.6 with OpenCore. + versions of \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.6 with OpenCore. \end{itemize} Model checking may also be erased by editing \texttt{OSInstall.mpkg} @@ -9327,7 +9327,7 @@ rm -rf DS_STORE RW hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg \end{lstlisting} -\subsubsection{macOS 10.5}\label{legacy105} +\subsubsection{\DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.5}\label{legacy105} \begin{itemize} \item All previous issues apply. @@ -9339,25 +9339,25 @@ hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg \texttt{Mkext} kext injection will still work without noticeable performance drain and will be chosen automatically when \texttt{KernelCache} is set to \texttt{Auto}. - \item Last released installer image for macOS~10.5 is macOS~10.5.7 + \item Last released installer image for \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.5 is \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.5.7 build \texttt{9J3050} (for \texttt{MacBookPro5,3}). Unlike the others, this image is not limited to the target model identifiers and can be used as is. The original \texttt{9J3050} image can be found \href{https://archive.org/details/10.5.7-9-j-3050}{here} (\href{https://mega.nz/folder/inRBTarD#zanf7fUbviwz3WHBU5xpCg}{MEGA Mirror}), - assuming macOS~10.5 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.5 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that this is the earliest tested - version of macOS~10.5 with OpenCore. + version of \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.5 with OpenCore. \end{itemize} -\subsubsection{macOS 10.4}\label{legacy104} +\subsubsection{\DIFdelbegin \DIFdel{macOS }\DIFdelend \DIFaddbegin \DIFadd{Mac OS X }\DIFaddend 10.4}\label{legacy104} \begin{itemize} \item All previous issues apply. \item This macOS version has a hard requirement to access all the optional packages on the second DVD disk installation media, requiring either two disks or USB media installation. - \item Last released installer images for macOS~10.4 are macOS~10.4.10 + \item Last released installer images for \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.4 are \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.4.10 builds \texttt{8R4061a} (for \texttt{MacBookPro3,1}) and \texttt{8R4088} (for \texttt{iMac7,1})). These images are limited to their target model identifiers as on newer macOS versions. @@ -9365,9 +9365,9 @@ hdiutil convert ReadWrite.dmg -format UDZO -o ReadOnly.dmg model restrictions can be found \href{https://archive.org/details/10.4.10-8-r-4088-acdt}{here} (\href{https://mega.nz/folder/D3ASzLzA\#7sjYXE2X09f6aGjol\_C7dg}{MEGA Mirror}), - assuming macOS~10.4 is legally owned. Refer to the \texttt{DIGEST.txt} file + assuming \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.4 is legally owned. Refer to the \texttt{DIGEST.txt} file for details. Note that these are the earliest tested - versions of macOS~10.4 with OpenCore. + versions of \DIFdelbegin \DIFdel{macOS}\DIFdelend \DIFaddbegin \DIFadd{Mac OS X}\DIFaddend ~10.4 with OpenCore. \end{itemize} \subsection{UEFI Secure Boot}\label{uefisecureboot} diff --git a/Docs/Errata/Errata.pdf b/Docs/Errata/Errata.pdf index 75704ad8..23fc2978 100644 Binary files a/Docs/Errata/Errata.pdf and b/Docs/Errata/Errata.pdf differ