mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-04-14 04:38:20 +10:00
35 lines
19 KiB
HTML
35 lines
19 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="'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.ac854a4f.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.fe046bb4.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/1.b553216b.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/29.e51316dc.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/7.ef1a2bef.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/11.f2953214.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.63a7faf3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.826bc012.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.8fcd7546.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/15.377a0153.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/16.cc8d6b95.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.ca6833c1.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.14c98260.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/19.deacfd2d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/20.86ebc74b.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.625fb5b2.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.4e895bfc.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.99938961.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/24.07230b66.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.02bf41f5.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.fc4d21de.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.f2e8d6c3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.4b248e9e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.f55f280a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/30.cfad7a4d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/31.4884b4fb.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/32.0a79591e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/33.1e009dc8.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/34.a08275e9.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/35.fec7ab90.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/36.8b871dba.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/37.331f7eaa.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/38.e637d566.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/39.52dc124a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.526bfd28.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/40.0c128b1f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/41.8d0c42c3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/42.586742c6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/43.5a1c7c13.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/44.23e634a4.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/45.40adea3f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/46.562b0379.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/47.53ab8459.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/48.4cbec02a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/49.f1bf7b17.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.60374ea6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.e8ba4a53.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/8.fe2836e7.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/vendors~docsearch.f37ba6b6.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 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>"Enable Verbose Mode"</li> <li>"Enable OpenCore DEBUG"</li> <li>"Enable Kext DEBUG"</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 "Enable OpenCore DEBUG" 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 "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> <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.ac854a4f.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.fe046bb4.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/1.b553216b.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/29.e51316dc.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/7.ef1a2bef.js" defer></script>
|
|
</body>
|
|
</html>
|