Files
OpenCore-Legacy-Patcher/DEBUG.html
2024-09-15 17:45:40 +00:00

35 lines
20 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.9.10">
<link rel="&#39;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.14fef702.css" as="style"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/app.7c5117e0.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.8759056f.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/1.1467e9e8.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/29.b1a2fdb5.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/7.74149ebd.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/11.7f39d821.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.9ad4d864.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.7365f6c6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.10dfe60a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/15.d690052c.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/16.81c353d4.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.6e6c06cf.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.a4685f96.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/19.85af28b0.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/20.2f9f89fc.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.bbf4721e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.2e2aa446.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.7d7757ed.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/24.6f2101e8.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.a1531d7e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.51a1acb0.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.335e9e83.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.70820800.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.a16a743b.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/30.dafc49fb.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/31.8b809d93.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/32.0a79591e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/33.c208a1b6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/34.82c884cc.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/35.161fd93e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/36.e1822a0f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/37.e63185ce.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/38.560a9c52.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/39.c13097dc.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.54d9fbfb.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/40.7f277fd6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/41.8fa5709e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/42.4b1b3386.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/43.304e36c3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/44.53246182.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/45.90910d1a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/46.41c2b313.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/47.06629e77.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/48.3ca73508.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/49.fb8f08ca.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.58adf236.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/50.0562bbc6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.2ba4dd32.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/8.6d158fb0.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/vendors~docsearch.05bc6775.js">
<link rel="stylesheet" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.14fef702.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></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"><span>macOS Sequoia</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/SEQUOIA-DROP.html" class="sidebar-link">macOS Sequoia Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Sonoma</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/SONOMA-DROP.html" class="sidebar-link">macOS Sonoma Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Ventura</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/VENTURA-DROP.html" class="sidebar-link">macOS Ventura Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Monterey</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/MONTEREY-DROP.html" class="sidebar-link">macOS Monterey Support</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/ACCEL.html" class="sidebar-link">Working Around Legacy Acceleration Issues</a></li><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 Patches</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><li><a href="/OpenCore-Legacy-Patcher/WINDOWS.html" class="sidebar-link">Installing Windows in UEFI Mode</a></li><li><a href="/OpenCore-Legacy-Patcher/UNIVERSALCONTROL.html" class="sidebar-link">Universal Control on unsupported Macs</a></li><li><a href="/OpenCore-Legacy-Patcher/PROCESS.html" class="sidebar-link">Background process</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 License</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/ISSUES-HOLD.html" class="sidebar-link">The current hold on new issues and pull requests</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></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 are unsure if it's user error or within the patcher, we recommend asking on the <a href="https://discord.gg/rqdPgH8xSN" target="_blank" rel="noopener noreferrer">OpenCore Patcher Paradise 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.</p> <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>&quot;Enable Verbose Mode&quot;</li> <li>&quot;Enable OpenCore DEBUG&quot;</li> <li>&quot;Enable Kext DEBUG&quot;</li></ul> <p><img src="/OpenCore-Legacy-Patcher/assets/img/ocdebugimage.f846d5a0.png" alt=""></p> <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 &quot;Enable OpenCore DEBUG&quot; set, on every boot there will be a .txt file generated on the EFI Partition. 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 &quot;Enable Kext DEBUG&quot; 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">&gt;</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> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>Currently issues have been disabled due to <a href="/OpenCore-Legacy-Patcher/ISSUES-HOLD.html">current events</a>. You can continue to receive support in the <a href="https://discord.gg/rqdPgH8xSN" target="_blank" rel="noopener noreferrer">OpenCore Patcher Paradise 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>, where there are active members of the community available.</p></div> <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>. This is a reminder to include the following info:</p> <ul><li>Model that you're 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 to see if 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">4/1/2024, 3:44:18 PM</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 Patches
</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.7c5117e0.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.8759056f.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/1.1467e9e8.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/29.b1a2fdb5.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/7.74149ebd.js" defer></script>
</body>
</html>