You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: troubleshooting/extended/kernel-issues.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ The main culprits to watch for in the Booter section are:
25
25
***SetupVirtualMap**
26
26
* This quirk is required for the majority of firmwares and without it it's very common to kernel panic here, so enable it if not already
27
27
* Mainly Z390 and older require this quirk enabled
28
-
* However, certain firmwares(mainly 2020+) do not work with this quirk and so may actually cause this kernel panic:
28
+
* However, certain firmwares(mainly 2020+) do not work with this quirk and so may actually cause this kernel panic:
29
29
* Intel's Ice Lake series
30
30
* Intel's Comet Lake series(B460, H470, Z490, etc)
31
31
* AMD's B550 and A520(Latest BIOS on X570 are also included now)
@@ -37,16 +37,16 @@ The main culprits to watch for in the Booter section are:
37
37
***EnableWriteUnprotector**
38
38
39
39
* Another issue may be that macOS is conflicting with the write protection from CR0 register, to resolve this we have 2 options:
40
-
* If your firmware supports MATs(2018+ firmwares):
40
+
* If your firmware supports MATs(2018+ firmwares):
41
41
* EnableWriteUnprotector -> False
42
42
* RebuildAppleMemoryMap -> True
43
43
* SyncRuntimePermissions -> True
44
44
* For older firmwares:
45
45
* EnableWriteUnprotector -> True
46
46
* RebuildAppleMemoryMap -> False
47
47
* SyncRuntimePermissions -> False
48
-
* Note: Some laptops(ex. Dell Inspiron 5370) even with MATs support will halt on boot up, in these cases you'll have two options:
49
-
* Boot with the old firmware quirk combo(ie. With EnableWriteUnprotector and disable `RebuildAppleMemoryMap` + `SyncRuntimePermissions`)
48
+
* Note: Some laptops(ex. Dell Inspiron 5370) even with MATs support will halt on boot up, in these cases you'll have two options:
49
+
* Boot with the old firmware quirk combo(ie. With EnableWriteUnprotector and disable `RebuildAppleMemoryMap` + `SyncRuntimePermissions`)
50
50
* Enable `DevirtualiseMmio` and follow [MmioWhitelist guide](https://dortania.github.io/OpenCore-Install-Guide/extras/kaslr-fix.html)
51
51
52
52
Regarding MATs support, firmwares built against EDK 2018 will support this and many OEMs have even added support all the way back to Skylake laptops. Issue is it's not always obvious if an OEM has updated the firmware, you can check the OpenCore logs whether yours supports it([See here how to get a log](../debug.html)):
@@ -408,7 +408,7 @@ Example of what a disabled RTC with no way to enable looks like(note that there
408
408
## Bootlooping when updating or installing macOS in Sonoma or later
409
409
410
410
This occurs because since macOS Sonoma 14.4, Apple changed how system updates worked, adding extra verifications to Apple Secure Boot, thing OpenCore's Secure Boot struggles to verify and calls panic() because it can't verify it correctly.
411
-
To fix this, disable Apple Secure Boot temporally via config.plist
411
+
To fix this, disable Apple Secure Boot temporarily via config.plist
412
412
* ie. set `Misc -> Security -> SecureBootModel -> Disabled`
413
413
414
414
::: warning
@@ -462,7 +462,7 @@ This assumes you're only booting the installer USB and not macOS itself.
462
462
463
463
### SATA Issues
464
464
465
-
On rare occasions(mainly laptops), the SATA controller isn't officially supported by macOS. To resolve this, we'll want to do a few things:
465
+
On rare occasions(mainly laptops), the SATA controller isn't officially supported by macOS. To resolve this, we'll want to do a few things:
466
466
467
467
* Set SATA to AHCI mode in the BIOS
468
468
* macOS doesn't support hardware RAID or IDE mode properly.
@@ -541,7 +541,7 @@ Note: macOS 11, Big Sur no longer requires this patch for MSI Navi.
541
541
Generally seen as an issue surrounding the prelinked kernel, specifically that macOS is having a hard time interpreting the ones we injected. Verify that:
542
542
543
543
* Your kexts are in the correct order(master then plugins, Lilu always before the plugins)
544
-
* Kexts with executables have them and plist only kexts don't(ie. USBmap.kext, XHCI-unspported.kext, etc does not contain an executable)
544
+
* Kexts with executables have them and plist only kexts don't(ie. USBmap.kext, XHCI-unsupported.kext, etc does not contain an executable)
545
545
* Don't include multiple of the same kexts in your config.plist(ie. including multiple copies of VoodooInput from multiple kexts, we recommend choosing the first kext in your config's array and disable the rest)
546
546
547
547
Note: this error may also look very similar to [Kernel Panic on `Invalid frame pointer`](#kernel-panic-on-invalid-frame-pointer)
0 commit comments