diff --git a/Changelog.md b/Changelog.md index c1e06ef9..b553a0d8 100644 --- a/Changelog.md +++ b/Changelog.md @@ -10,6 +10,7 @@ OpenCore Changelog - Added kext blocking `Strategy` for prelinked and newer - Added global MSR 35h fix to `ProvideCurrentCpuInfo`, allowing `-cpu host` in KVM - Fixed potential memory corruption with AVX acceleration enabled +- Added `LogModules` for positive and negative log filtering by modules #### v0.7.8 - Updated ocvalidate to warn about insecure `DmgLoading` with secure `SecureBootModel` (already disallowed in runtime) diff --git a/Docs/Configuration.md5 b/Docs/Configuration.md5 index f70a2f84..79096dab 100644 --- a/Docs/Configuration.md5 +++ b/Docs/Configuration.md5 @@ -1 +1 @@ -af8312e880f1b5c8f1773e840ef3dbf0 +cc719727cce977f2aed6cdaa5b88c23f diff --git a/Docs/Configuration.pdf b/Docs/Configuration.pdf index 9f0dde10..52b72f80 100644 Binary files a/Docs/Configuration.pdf and b/Docs/Configuration.pdf differ diff --git a/Docs/Differences/Differences.pdf b/Docs/Differences/Differences.pdf index 83fdecd2..7a5b47bb 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 f5536ecb..342380ea 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 Thu Feb 10 18:56:25 2022 -%DIF ADD ../Configuration.tex Sat Feb 12 04:35:26 2022 +%DIF DEL PreviousConfiguration.tex Fri Feb 11 00:24:26 2022 +%DIF ADD ../Configuration.tex Fri Feb 25 23:37:24 2022 \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 LISTINGS PREAMBLE %DIF PREAMBLE +%DIF COLORLISTINGS PREAMBLE %DIF PREAMBLE \RequirePackage{listings} %DIF PREAMBLE \RequirePackage{color} %DIF PREAMBLE \lstdefinelanguage{DIFcode}{ %DIF PREAMBLE @@ -3766,7 +3766,36 @@ cat Kernel.panic | grep macOSProcessedStackshotData | \end{itemize} \item - \texttt{SerialInit}\\ + \DIFaddbegin \texttt{\DIFadd{LogModules}}\\ + \textbf{\DIFadd{Type}}\DIFadd{: }\texttt{\DIFadd{plist\ string}}\\ + \textbf{\DIFadd{Failsafe}}\DIFadd{: }\texttt{\DIFadd{*}}\\ + \textbf{\DIFadd{Description}}\DIFadd{: Filter log entries by module. +} + + \DIFadd{This option filters logging generated by specific modules, both in the log and onscreen. + Two modes are supported: + }\begin{itemize} + \tightlist + \item \texttt{\DIFadd{+}} \DIFadd{--- Positive filtering: Only present selected modules. + }\item \texttt{\DIFadd{-}} \DIFadd{--- Negative filtering: Exclude selected modules. + }\end{itemize} + \DIFadd{When multiple ones are selected, comma (}\texttt{\DIFadd{,}}\DIFadd{) should be used as the splitter. + For instance, }\texttt{\DIFadd{+OCCPU,OCA,OCB}} \DIFadd{means }\emph{\DIFadd{only}} \texttt{\DIFadd{OCCPU}}\DIFadd{, }\texttt{\DIFadd{OCA}}\DIFadd{, }\texttt{\DIFadd{OCB}} \DIFadd{being printed, + while }\texttt{\DIFadd{-OCCPU,OCA,OCB}} \DIFadd{indicates these modules being filtered out (i.e. }\emph{\DIFadd{not}} \DIFadd{logged). + When no symbol is specified, positive filtering (}\texttt{\DIFadd{+}}\DIFadd{) will be used. + }\texttt{\DIFadd{*}} \DIFadd{indicates all modules being logged. +} + + \emph{\DIFadd{Note 1}}\DIFadd{: Acronyms of libraries can be found in the + }\hyperref[oc-mod-libs]{\texttt{Libraries}} \DIFadd{section below. +} + + \emph{\DIFadd{Note 2}}\DIFadd{: Messages printed before the configuration of log protocol + cannot be filtered. +} + +\item + \DIFaddend \texttt{SerialInit}\\ \textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Failsafe}: \texttt{false}\\ \textbf{Description}: Perform serial port initialisation. @@ -3880,7 +3909,8 @@ nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:boot-log | \item \texttt{VMOPT} --- VerifyMemOpt \end{itemize} - \textbf{Libraries}: + \DIFaddbegin \label{oc-mod-libs} + \DIFaddend \textbf{Libraries}: \begin{itemize} \tightlist \item \texttt{AAPL} --- OcDebugLogLib, Apple EfiBoot logging diff --git a/Docs/Errata/Errata.pdf b/Docs/Errata/Errata.pdf index c7c2ba7c..a843644b 100644 Binary files a/Docs/Errata/Errata.pdf and b/Docs/Errata/Errata.pdf differ