@@ -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.
\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.
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
\subsubsection{\DIFdelbegin\DIFdel{macOS }\DIFdelend\DIFaddbegin\DIFadd{Mac OS X }\DIFaddend10.6}\label{legacy106}
\begin{itemize}
\item All previous issues apply.
\item\texttt{SSSE3} support is a requirement for macOS10.6 kernel
\item\texttt{SSSE3} support is a requirement for \DIFdelbegin\DIFdel{macOS }\DIFdelend\DIFaddbegin\DIFadd{Mac OS X }\DIFaddend10.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
\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
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{macOS10.4}\label{legacy104}
\subsubsection{\DIFdelbegin\DIFdel{macOS }\DIFdelend\DIFaddbegin\DIFadd{Mac OS X }\DIFaddend10.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.