Skip to content

Commit bae9a92

Browse files
Bump version
1 parent ceb0e8d commit bae9a92

File tree

8 files changed

+54
-50
lines changed

8 files changed

+54
-50
lines changed

Docs/Configuration.md5

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
42f83ed3c3cf33918b838b381cbb29e4
1+
acf401d82534ccdab968f900d687f049

Docs/Configuration.pdf

-591 Bytes
Binary file not shown.

Docs/Configuration.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@
9494

9595
\vspace{0.2in}
9696

97-
Reference Manual (1.0.4)
97+
Reference Manual (1.0.5)
9898

9999
\vspace{0.2in}
100100

Docs/Differences/Differences.pdf

-132 KB
Binary file not shown.

Docs/Differences/Differences.tex

Lines changed: 27 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
\documentclass[]{article}
22
%DIF LATEXDIFF DIFFERENCE FILE
3-
%DIF DEL PreviousConfiguration.tex Tue Dec 24 15:56:59 2024
4-
%DIF ADD ../Configuration.tex Sun Feb 23 10:59:10 2025
3+
%DIF DEL PreviousConfiguration.tex Tue Mar 4 16:49:56 2025
4+
%DIF ADD ../Configuration.tex Tue Mar 4 16:49:56 2025
55

66
\usepackage{lmodern}
77
\usepackage{amssymb,amsmath}
@@ -83,16 +83,16 @@
8383
\RequirePackage[normalem]{ulem} %DIF PREAMBLE
8484
\RequirePackage{color}\definecolor{RED}{rgb}{1,0,0}\definecolor{BLUE}{rgb}{0,0,1} %DIF PREAMBLE
8585
\providecommand{\DIFaddtex}[1]{{\protect\color{blue}\uwave{#1}}} %DIF PREAMBLE
86-
\providecommand{\DIFdeltex}[1]{{\protect\color{red}\sout{#1}}} %DIF PREAMBLE
86+
\providecommand{\DIFdeltex}[1]{{\protect\color{red}\sout{#1}}} %DIF PREAMBLE
8787
%DIF ONLYCHANGEDPAGE PREAMBLE %DIF PREAMBLE
8888
\RequirePackage{atbegshi} %DIF PREAMBLE
8989
\RequirePackage{etoolbox} %DIF PREAMBLE
9090
\RequirePackage{zref} %DIF PREAMBLE
9191
% redefine label command to write immediately to aux file - page references will be lost %DIF PREAMBLE
92-
\makeatletter \let\oldlabel\label% Store \label %DIF PREAMBLE
93-
\renewcommand{\label}[1]{% Update \label to write to the .aux immediately %DIF PREAMBLE
94-
\zref@wrapper@immediate{\oldlabel{#1}}} %DIF PREAMBLE
95-
\makeatother %DIF PREAMBLE
92+
\makeatletter \let\oldlabel\label% Store \label %DIF PREAMBLE
93+
\renewcommand{\label}[1]{% Update \label to write to the .aux immediately %DIF PREAMBLE
94+
\zref@wrapper@immediate{\oldlabel{#1}}} %DIF PREAMBLE
95+
\makeatother %DIF PREAMBLE
9696
\newbool{DIFkeeppage} %DIF PREAMBLE
9797
\newbool{DIFchange} %DIF PREAMBLE
9898
\boolfalse{DIFkeeppage} %DIF PREAMBLE
@@ -118,12 +118,7 @@
118118
%DIF HYPERREF PREAMBLE %DIF PREAMBLE
119119
\providecommand{\DIFadd}[1]{\texorpdfstring{\DIFaddtex{#1}}{#1}} %DIF PREAMBLE
120120
\providecommand{\DIFdel}[1]{\texorpdfstring{\DIFdeltex{#1}}{}} %DIF PREAMBLE
121-
%DIF AMSMATHULEM PREAMBLE %DIF PREAMBLE
122-
\makeatletter %DIF PREAMBLE
123-
\let\sout@orig\sout %DIF PREAMBLE
124-
\renewcommand{\sout}[1]{\ifmmode\text{\sout@orig{\ensuremath{#1}}}\else\sout@orig{#1}\fi} %DIF PREAMBLE
125-
\makeatother %DIF PREAMBLE
126-
%DIF COLORLISTINGS PREAMBLE %DIF PREAMBLE
121+
%DIF LISTINGS PREAMBLE %DIF PREAMBLE
127122
\RequirePackage{listings} %DIF PREAMBLE
128123
\RequirePackage{color} %DIF PREAMBLE
129124
\lstdefinelanguage{DIFcode}{ %DIF PREAMBLE
@@ -139,8 +134,6 @@
139134
} %DIF PREAMBLE
140135
\lstnewenvironment{DIFverbatim}{\lstset{style=DIFverbatimstyle}}{} %DIF PREAMBLE
141136
\lstnewenvironment{DIFverbatim*}{\lstset{style=DIFverbatimstyle,showspaces=true}}{} %DIF PREAMBLE
142-
\lstset{extendedchars=\true,inputencoding=utf8}
143-
144137
%DIF END PREAMBLE EXTENSION ADDED BY LATEXDIFF
145138

146139
\begin{document}
@@ -161,7 +154,7 @@
161154

162155
\vspace{0.2in}
163156

164-
Reference Manual (1.0.4)
157+
Reference Manual (1.0\DIFdelbegin \DIFdel{.4}\DIFdelend \DIFaddbegin \DIFadd{.5}\DIFaddend )
165158

166159
\vspace{0.2in}
167160

@@ -173,7 +166,7 @@
173166

174167
\rmfamily
175168

176-
Copyright \textcopyright \DIFdelbegin \DIFdel{2018-2024 }\DIFdelend \DIFaddbegin \DIFadd{2018-2025 }\DIFaddend vit9696
169+
Copyright \textcopyright 2018-2025 vit9696
177170

178171
\end{center}
179172
\end{titlepage}
@@ -1585,26 +1578,23 @@ \subsection{Quirks Properties}\label{booterpropsquirks}
15851578
\emph{Note}: Most types of firmware, apart from Apple and VMware, need this quirk.
15861579

15871580
\item
1588-
\DIFaddbegin \texttt{\DIFadd{ClearTaskSwitchBit}}\\
1589-
\textbf{\DIFadd{Type}}\DIFadd{: }\texttt{\DIFadd{plist\ boolean}}\\
1590-
\textbf{\DIFadd{Failsafe}}\DIFadd{: }\texttt{\DIFadd{false}}\\
1591-
\textbf{\DIFadd{Description}}\DIFadd{: Clear task switch bit during UEFI runtime services calls.
1592-
}
1581+
\texttt{ClearTaskSwitchBit}\\
1582+
\textbf{Type}: \texttt{plist\ boolean}\\
1583+
\textbf{Failsafe}: \texttt{false}\\
1584+
\textbf{Description}: Clear task switch bit during UEFI runtime services calls.
15931585

1594-
\DIFadd{This quirk resolves FPU-related crashes in UEFI runtime services when using either the
1586+
This quirk resolves FPU-related crashes in UEFI runtime services when using either the
15951587
32-bit kernel on a 64-bit UEFI implementation, or the 64-bit kernel on a 32-bit UEFI implementation
1596-
by removing the task switch (}\texttt{\DIFadd{TS}}\DIFadd{) bit from }\texttt{\DIFadd{CR0}} \DIFadd{register during their execution.
1588+
by removing the task switch (\texttt{TS}) bit from \texttt{CR0} register during their execution.
15971589
These crashes occur if there is any FPU/SSE instruction usage in UEFI runtime services as XNU
1598-
is unable to handle exceptions from mixed-mode code. This quirk requires }\texttt{\DIFadd{OC\_FIRMWARE\_RUNTIME}}
1599-
\DIFadd{protocol implemented in }\texttt{\DIFadd{OpenRuntime.efi}}\DIFadd{.
1600-
}
1590+
is unable to handle exceptions from mixed-mode code. This quirk requires \texttt{OC\_FIRMWARE\_RUNTIME}
1591+
protocol implemented in \texttt{OpenRuntime.efi}.
16011592

1602-
\emph{\DIFadd{Note}}\DIFadd{: This quirk should only be required when running older macOS versions when the
1593+
\emph{Note}: This quirk should only be required when running older macOS versions when the
16031594
32-bit kernel is used on a 64-bit UEFI implementation, such as Microsoft Hyper-V.
1604-
}
16051595

16061596
\item
1607-
\DIFaddend \texttt{DevirtualiseMmio}\\
1597+
\texttt{DevirtualiseMmio}\\
16081598
\textbf{Type}: \texttt{plist\ boolean}\\
16091599
\textbf{Failsafe}: \texttt{false}\\
16101600
\textbf{Description}: Remove runtime attribute from certain MMIO regions.
@@ -2102,8 +2092,7 @@ \section{Kernel}\label{kernel}
21022092
\subsection{Introduction}\label{kernelintro}
21032093

21042094
This section allows the application of different kinds of kernelspace modifications on
2105-
Apple Kernel (\DIFdelbegin %DIFDELCMD < \href{https://opensource.apple.com/source/xnu}{%%%
2106-
\DIFdelend \DIFaddbegin \href{https://github.com/apple-oss-distributions/xnu}{\DIFaddend XNU}). The modifications
2095+
Apple Kernel (\href{https://github.com/apple-oss-distributions/xnu}{XNU}). The modifications
21072096
currently provide driver (kext) injection, kernel and driver patching, and driver
21082097
blocking.
21092098

@@ -5170,8 +5159,7 @@ \subsection{Recommended Variables}\label{nvramvarsrec}
51705159
\texttt{7C436110-AB2A-4BBB-A880-FE41995C9F82:csr-active-config}
51715160
\break
51725161
32-bit System Integrity Protection bitmask. Declared in XNU source code in
5173-
\DIFdelbegin %DIFDELCMD < \href{https://opensource.apple.com/source/xnu/xnu-4570.71.2/bsd/sys/csr.h.auto.html}{%%%
5174-
\DIFdelend \DIFaddbegin \href{https://github.com/apple-oss-distributions/xnu/blob/main/bsd/sys/csr.h}{\DIFaddend csr.h}.
5162+
\href{https://github.com/apple-oss-distributions/xnu/blob/main/bsd/sys/csr.h}{csr.h}.
51755163
\item
51765164
\texttt{4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:ExtendedFirmwareFeatures}
51775165
\break
@@ -5213,8 +5201,7 @@ \subsection{Recommended Variables}\label{nvramvarsrec}
52135201
\break
52145202
ASCII string defining FireWire security mode. Legacy, can be found in IOFireWireFamily
52155203
source code in
5216-
\DIFdelbegin %DIFDELCMD < \href{https://opensource.apple.com/source/IOFireWireFamily/IOFireWireFamily-473/IOFireWireFamily.kmodproj/IOFireWireController.cpp.auto.html}{%%%
5217-
\DIFdelend \DIFaddbegin \href{https://github.com/apple-oss-distributions/IOFireWireFamily/blob/main/IOFireWireFamily.kmodproj/IOFireWireController.cpp}{\DIFaddend IOFireWireController.cpp}.
5204+
\href{https://github.com/apple-oss-distributions/IOFireWireFamily/blob/main/IOFireWireFamily.kmodproj/IOFireWireController.cpp}{IOFireWireController.cpp}.
52185205
It is recommended not to set this variable, which may speedup system startup. Setting to
52195206
\texttt{full} is equivalent to not setting the variable and \texttt{none} disables
52205207
FireWire security.
@@ -7296,7 +7283,7 @@ \subsection{OpenNetworkBoot}\label{uefinetboot}
72967283
\end{itemize}
72977284

72987285
\emph{Note 1}: This option is written to NVRAM and will remain present even if the option is removed from the driver
7299-
\texttt{Arguments}, unless \DIFdelbegin \DIFdel{NVRAM is cleared or }\DIFdelend an alternative value is written or the value deleted, using this option.
7286+
\texttt{Arguments}, unless an alternative value is written or the value deleted, using this option.
73007287

73017288
\emph{Note 2}: This setting will normally cause a static IP to be assigned during pre-boot, even in vendor-provided
73027289
network stacks. However, due to a quirk of the design of PXE and HTTP boot, any such static assignment will then be
@@ -7308,7 +7295,7 @@ \subsection{OpenNetworkBoot}\label{uefinetboot}
73087295
(see \texttt{UEFI} \texttt{Unload} option) and the OpenCore version used instead.
73097296

73107297
\emph{Note 3}: If \texttt{Ip4Dxe} is loaded before OpenCore then any setting here will only take effect after one
7311-
reboot (during which network boot is not \DIFdelbegin \DIFdel{be }\DIFdelend attempted). If \texttt{Ip4Dxe} is loaded after \texttt{OpenNetworkBoot}
7298+
reboot (during which network boot is not attempted). If \texttt{Ip4Dxe} is loaded after \texttt{OpenNetworkBoot}
73127299
the setting will take effect immediately.
73137300
\medskip
73147301

@@ -8890,8 +8877,8 @@ \subsection{Output Properties}\label{uefioutputprops}
88908877
(e.g. \texttt{1920x1080}) formatted string to request custom resolution
88918878
from GOP if available.
88928879
\item Set to \texttt{Max} to attempt using the largest
8893-
available screen resolution\DIFaddbegin \DIFadd{. When set to }\texttt{\DIFadd{Max}} \DIFadd{all available resolutions
8894-
will be listed in lines starting }\texttt{\DIFadd{OCC: Mode}} \DIFadd{in the debug log}\DIFaddend .
8880+
available screen resolution. When set to \texttt{Max} all available resolutions
8881+
will be listed in lines starting \texttt{OCC: Mode} in the debug log.
88958882
\end{itemize}
88968883

88978884
On HiDPI screens \texttt{APPLE\_VENDOR\_VARIABLE\_GUID} \texttt{UIScale}

Docs/Differences/PreviousConfiguration.tex

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@
106106

107107
\rmfamily
108108

109-
Copyright \textcopyright 2018-2024 vit9696
109+
Copyright \textcopyright 2018-2025 vit9696
110110

111111
\end{center}
112112
\end{titlepage}
@@ -1517,6 +1517,22 @@ \subsection{Quirks Properties}\label{booterpropsquirks}
15171517

15181518
\emph{Note}: Most types of firmware, apart from Apple and VMware, need this quirk.
15191519

1520+
\item
1521+
\texttt{ClearTaskSwitchBit}\\
1522+
\textbf{Type}: \texttt{plist\ boolean}\\
1523+
\textbf{Failsafe}: \texttt{false}\\
1524+
\textbf{Description}: Clear task switch bit during UEFI runtime services calls.
1525+
1526+
This quirk resolves FPU-related crashes in UEFI runtime services when using either the
1527+
32-bit kernel on a 64-bit UEFI implementation, or the 64-bit kernel on a 32-bit UEFI implementation
1528+
by removing the task switch (\texttt{TS}) bit from \texttt{CR0} register during their execution.
1529+
These crashes occur if there is any FPU/SSE instruction usage in UEFI runtime services as XNU
1530+
is unable to handle exceptions from mixed-mode code. This quirk requires \texttt{OC\_FIRMWARE\_RUNTIME}
1531+
protocol implemented in \texttt{OpenRuntime.efi}.
1532+
1533+
\emph{Note}: This quirk should only be required when running older macOS versions when the
1534+
32-bit kernel is used on a 64-bit UEFI implementation, such as Microsoft Hyper-V.
1535+
15201536
\item
15211537
\texttt{DevirtualiseMmio}\\
15221538
\textbf{Type}: \texttt{plist\ boolean}\\
@@ -2016,7 +2032,7 @@ \section{Kernel}\label{kernel}
20162032
\subsection{Introduction}\label{kernelintro}
20172033

20182034
This section allows the application of different kinds of kernelspace modifications on
2019-
Apple Kernel (\href{https://opensource.apple.com/source/xnu}{XNU}). The modifications
2035+
Apple Kernel (\href{https://github.com/apple-oss-distributions/xnu}{XNU}). The modifications
20202036
currently provide driver (kext) injection, kernel and driver patching, and driver
20212037
blocking.
20222038

@@ -5083,7 +5099,7 @@ \subsection{Recommended Variables}\label{nvramvarsrec}
50835099
\texttt{7C436110-AB2A-4BBB-A880-FE41995C9F82:csr-active-config}
50845100
\break
50855101
32-bit System Integrity Protection bitmask. Declared in XNU source code in
5086-
\href{https://opensource.apple.com/source/xnu/xnu-4570.71.2/bsd/sys/csr.h.auto.html}{csr.h}.
5102+
\href{https://github.com/apple-oss-distributions/xnu/blob/main/bsd/sys/csr.h}{csr.h}.
50875103
\item
50885104
\texttt{4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:ExtendedFirmwareFeatures}
50895105
\break
@@ -5125,7 +5141,7 @@ \subsection{Recommended Variables}\label{nvramvarsrec}
51255141
\break
51265142
ASCII string defining FireWire security mode. Legacy, can be found in IOFireWireFamily
51275143
source code in
5128-
\href{https://opensource.apple.com/source/IOFireWireFamily/IOFireWireFamily-473/IOFireWireFamily.kmodproj/IOFireWireController.cpp.auto.html}{IOFireWireController.cpp}.
5144+
\href{https://github.com/apple-oss-distributions/IOFireWireFamily/blob/main/IOFireWireFamily.kmodproj/IOFireWireController.cpp}{IOFireWireController.cpp}.
51295145
It is recommended not to set this variable, which may speedup system startup. Setting to
51305146
\texttt{full} is equivalent to not setting the variable and \texttt{none} disables
51315147
FireWire security.
@@ -7207,7 +7223,7 @@ \subsection{OpenNetworkBoot}\label{uefinetboot}
72077223
\end{itemize}
72087224

72097225
\emph{Note 1}: This option is written to NVRAM and will remain present even if the option is removed from the driver
7210-
\texttt{Arguments}, unless NVRAM is cleared or an alternative value is written or the value deleted, using this option.
7226+
\texttt{Arguments}, unless an alternative value is written or the value deleted, using this option.
72117227

72127228
\emph{Note 2}: This setting will normally cause a static IP to be assigned during pre-boot, even in vendor-provided
72137229
network stacks. However, due to a quirk of the design of PXE and HTTP boot, any such static assignment will then be
@@ -7219,7 +7235,7 @@ \subsection{OpenNetworkBoot}\label{uefinetboot}
72197235
(see \texttt{UEFI} \texttt{Unload} option) and the OpenCore version used instead.
72207236

72217237
\emph{Note 3}: If \texttt{Ip4Dxe} is loaded before OpenCore then any setting here will only take effect after one
7222-
reboot (during which network boot is not be attempted). If \texttt{Ip4Dxe} is loaded after \texttt{OpenNetworkBoot}
7238+
reboot (during which network boot is not attempted). If \texttt{Ip4Dxe} is loaded after \texttt{OpenNetworkBoot}
72237239
the setting will take effect immediately.
72247240
\medskip
72257241

@@ -8801,7 +8817,8 @@ \subsection{Output Properties}\label{uefioutputprops}
88018817
(e.g. \texttt{1920x1080}) formatted string to request custom resolution
88028818
from GOP if available.
88038819
\item Set to \texttt{Max} to attempt using the largest
8804-
available screen resolution.
8820+
available screen resolution. When set to \texttt{Max} all available resolutions
8821+
will be listed in lines starting \texttt{OCC: Mode} in the debug log.
88058822
\end{itemize}
88068823

88078824
On HiDPI screens \texttt{APPLE\_VENDOR\_VARIABLE\_GUID} \texttt{UIScale}

Docs/Errata/Errata.pdf

26 Bytes
Binary file not shown.

Include/Acidanthera/Library/OcMainLib.h

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
OpenCore version reported to log and NVRAM.
3131
OPEN_CORE_VERSION must follow X.Y.Z format, where X.Y.Z are single digits.
3232
**/
33-
#define OPEN_CORE_VERSION "1.0.4"
33+
#define OPEN_CORE_VERSION "1.0.5"
3434

3535
/**
3636
OpenCore build type reported to log and NVRAM.

0 commit comments

Comments
 (0)