archive-gh-me/OpenCorePkg
1
0
Fork 0
mirror of https://github.com/acidanthera/OpenCorePkg.git synced 2025-12-08 19:25:01 +00:00
Code Issues Projects Releases Wiki Activity

Docs: Fixed legacy OS text

Browse Source
This commit is contained in:
Andrey1970 2024-03-13 00:11:07 +03:00
parent 2cbe647045
commit cafe2fb54e
6 changed files with 82 additions and 82 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Docs/Configuration.md5
View File

@ -1 +1 @@
896e53e7e20bab69a5f0c0aaed33c45b
1a71d1870e336326d90153724e52def0

BIN
Docs/Configuration.pdf
View File

Binary file not shown.

78
Docs/Configuration.tex
View File

@ -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}

BIN
Docs/Differences/Differences.pdf
View File

Binary file not shown.

84
Docs/Differences/Differences.tex
View File

@ -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}

BIN
Docs/Errata/Errata.pdf
View File

Binary file not shown.