mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-04-15 05:08:20 +10:00
35 lines
16 KiB
HTML
35 lines
16 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>How to debug with OpenCore | OpenCore Legacy Patcher</title>
|
|
<meta name="generator" content="VuePress 1.7.1">
|
|
<link rel="'stylesheet" href="/OpenCore-Legacy-Patcher/styles/website.css">
|
|
<meta name="description" content="">
|
|
<meta name="theme-color" content="#3eaf7c">
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
|
|
|
<link rel="preload" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css" as="style"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/app.5cb98f21.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.643d5328.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/11.7896368f.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/15.7b027baf.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/10.40e061c4.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.dab03ee6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.a70a441d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.6e79443a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/16.421b5af3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.6f1af41f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.b31640b3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/19.cfe7f260.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/20.5c51b21d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.835daf4f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.aa0f172d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.6f538b98.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/24.89b3ad51.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.903ab4ef.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.0d4feafa.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.26f6b91b.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.5756714c.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.ba946387.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.037b6905.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.12814ad4.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.cda538f4.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/7.dcf99b23.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/8.0aa772f2.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/9.26828ff5.js">
|
|
<link rel="stylesheet" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/OpenCore-Legacy-Patcher/" class="home-link router-link-active"><img src="homepage.png" alt="OpenCore Legacy Patcher" class="logo"> <span class="site-name can-hide">OpenCore Legacy Patcher</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Introduction</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/START.html" class="sidebar-link">What is OpenCore?</a></li><li><a href="/OpenCore-Legacy-Patcher/MODELS.html" class="sidebar-link">Supported Models</a></li><li><a href="/OpenCore-Legacy-Patcher/BENIFITS.html" class="sidebar-link">Benefits and drawbacks</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Setting up</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/INSTALLER.html" class="sidebar-link">Download and build macOS Installers</a></li><li><a href="/OpenCore-Legacy-Patcher/BUILD.html" class="sidebar-link">Building and installing OpenCore</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Installation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/BOOT.html" class="sidebar-link">Booting OpenCore and macOS</a></li><li><a href="/OpenCore-Legacy-Patcher/POST-INSTALL.html" class="sidebar-link">Post-Installation</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>Misc</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html" class="sidebar-link">Troubleshooting</a></li><li><a href="/OpenCore-Legacy-Patcher/DEBUG.html" aria-current="page" class="active sidebar-link">How to debug with OpenCore</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/DEBUG.html#debugging-yourself" class="sidebar-link">Debugging yourself</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/DEBUG.html#obtaining-opencore-logs-from-disk" class="sidebar-link">Obtaining OpenCore logs from disk</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/DEBUG.html#obtaining-kernel-logs-from-macos" class="sidebar-link">Obtaining Kernel logs from macOS</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/DEBUG.html#filing-an-issue-with-us" class="sidebar-link">Filing an issue with us</a></li></ul></li><li><a href="/OpenCore-Legacy-Patcher/UPDATE.html" class="sidebar-link">Updating OpenCore and Co.</a></li><li><a href="/OpenCore-Legacy-Patcher/UNINSTALL.html" class="sidebar-link">Uninstalling OpenCore</a></li><li><a href="/OpenCore-Legacy-Patcher/ICNS.html" class="sidebar-link">Creating custom icons for OpenCore and Mac Boot Picker</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Credit</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/DONATE.html" class="sidebar-link">Supporting the patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/LICENSE.html" class="sidebar-link">OpenCore Legacy Patcher Licence</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Documentation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/TESTED.html" class="sidebar-link">Tested Models on OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/TERMS.html" class="sidebar-link">OpenCore Patcher Terminology</a></li><li><a href="/OpenCore-Legacy-Patcher/HOW.html" class="sidebar-link">Boot Process with OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html" class="sidebar-link">Explaining the patches in OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/CLI.html" class="sidebar-link">Command Line Args</a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-succinct-content content__default"><h1 id="how-to-debug-with-opencore"><a href="#how-to-debug-with-opencore" class="header-anchor">#</a> How to debug with OpenCore</h1> <p>For those who've hit an odd bug and unsure if it's user error or patcher, the below will tell you how to get more verbose debug information as well as logs to help <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/issues" target="_blank" rel="noopener noreferrer">file issues with us<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <ul><li>For users who are less experienced, we recommend asking on the <a href="https://discord.gg/XbbWAsE" target="_blank" rel="noopener noreferrer">Unsupported Mac Discord Server<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> for help.</li></ul> <h2 id="debugging-yourself"><a href="#debugging-yourself" class="header-anchor">#</a> Debugging yourself</h2> <p>The easiest way to debug yourself is via Patcher Settings. Here there are many different settings however the 3 main options that will help are:</p> <ul><li>"Enable Verbose Mode"</li> <li>"Enable OpenCore DEBUG"</li> <li>"Enable Kext DEBUG"</li></ul> <p>When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.</p> <h2 id="obtaining-opencore-logs-from-disk"><a href="#obtaining-opencore-logs-from-disk" class="header-anchor">#</a> Obtaining OpenCore logs from disk</h2> <p>With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, <a href="https://github.com/corpnewt/MountEFI" target="_blank" rel="noopener noreferrer">download and run MountEFI<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>:</p> <p><img src="/OpenCore-Legacy-Patcher/assets/img/mountefi.f1bedccd.png" alt=""></p> <p>Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:</p> <p><img src="/OpenCore-Legacy-Patcher/assets/img/logs-efi.c416d33f.png" alt=""></p> <h2 id="obtaining-kernel-logs-from-macos"><a href="#obtaining-kernel-logs-from-macos" class="header-anchor">#</a> Obtaining Kernel logs from macOS</h2> <p>With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:</p> <div class="language-sh extra-class"><pre class="language-sh"><code><span class="token function">sudo</span> <span class="token function">dmesg</span> <span class="token operator">></span> ~/Desktop/DMESG.txt
|
|
</code></pre></div><p>From there, you'll have a log on your desktop.</p> <h2 id="filing-an-issue-with-us"><a href="#filing-an-issue-with-us" class="header-anchor">#</a> Filing an issue with us</h2> <p>Now that you have proper logs, you can now <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/issues" target="_blank" rel="noopener noreferrer">file issues with us<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>. Reminder we want the following info:</p> <ul><li>Model patching for (ie. MacBookPro10,1)</li> <li>Target OS (ie. macOS 11.2.3)</li> <li>Host OS (ie. macOS 10.15.7)</li> <li>Upload of your OpenCore Build Folder</li> <li>Upload of your OpenCore log (if applicable)</li> <li>Upload of your Kernel log (if applicable)</li></ul> <p>Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.</p></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/dortania/OpenCore-Legacy-Patcher/edit/main/docs/DEBUG.md" target="_blank" rel="noopener noreferrer">Help us improve this page!</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">Last Updated:</span> <span class="time">3/15/2021, 1:05:21 AM</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
|
|
⟵
|
|
<a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html" class="prev">
|
|
Troubleshooting
|
|
</a></span> <span class="next"><a href="/OpenCore-Legacy-Patcher/UPDATE.html">
|
|
Updating OpenCore and Co.
|
|
</a>
|
|
⟶
|
|
</span></p></div> </main></div><div class="global-ui"><div style="visibility:hidden;display:none;"></div><!----></div></div>
|
|
<script src="/OpenCore-Legacy-Patcher/assets/js/app.5cb98f21.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.643d5328.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/11.7896368f.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/15.7b027baf.js" defer></script>
|
|
</body>
|
|
</html>
|