Skip to content

Commit 1e3375b

Browse files
authored
Update kernel-issues.md
1 parent abe42a4 commit 1e3375b

1 file changed

Lines changed: 7 additions & 7 deletions

File tree

troubleshooting/extended/kernel-issues.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ The main culprits to watch for in the Booter section are:
2525
* **SetupVirtualMap**
2626
* 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
2727
* 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:
2929
* Intel's Ice Lake series
3030
* Intel's Comet Lake series(B460, H470, Z490, etc)
3131
* 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:
3737
* **EnableWriteUnprotector**
3838

3939
* 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):
4141
* EnableWriteUnprotector -> False
4242
* RebuildAppleMemoryMap -> True
4343
* SyncRuntimePermissions -> True
4444
* For older firmwares:
4545
* EnableWriteUnprotector -> True
4646
* RebuildAppleMemoryMap -> False
4747
* 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`)
5050
* Enable `DevirtualiseMmio` and follow [MmioWhitelist guide](https://dortania.github.io/OpenCore-Install-Guide/extras/kaslr-fix.html)
5151

5252
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
408408
## Bootlooping when updating or installing macOS in Sonoma or later
409409

410410
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
412412
* ie. set `Misc -> Security -> SecureBootModel -> Disabled`
413413

414414
::: warning
@@ -462,7 +462,7 @@ This assumes you're only booting the installer USB and not macOS itself.
462462

463463
### SATA Issues
464464

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:
466466

467467
* Set SATA to AHCI mode in the BIOS
468468
* 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.
541541
Generally seen as an issue surrounding the prelinked kernel, specifically that macOS is having a hard time interpreting the ones we injected. Verify that:
542542

543543
* 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)
545545
* 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)
546546

547547
Note: this error may also look very similar to [Kernel Panic on `Invalid frame pointer`](#kernel-panic-on-invalid-frame-pointer)

0 commit comments

Comments
 (0)