EliteMacx86

Administrator
Staff member
Joined
Jul 22, 2018
Messages
3,861
Motherboard
Supermicro X11SPA-T
CPU
Intel Xeon W-3275 28 Core
Graphics
2xAMD RX 580 8GB
OS X/macOS
11.0.x
Bootloader
  1. OpenCore
Mac
  1. Mac mini
  2. MacBook Pro
Mobile Phone
  1. Android
  2. iOS
Common Boot Args for macOS [Clover/OpenCore]

Booting macOS requires some boot args. Boot args are also known as boot flags. There are several boot args used for different purposes. There are some common boot args and some are kexts specific. This is a list of common boot boot args for macOS which can be used on Clover and OpenCore as well.

Common Boot Args


Boot ArgsPurpose
-v
  • Enables verbose mode.
  • Helpful to track the installation progress or when booting.
  • We recommend using this boot arg.
  • Once you're done with the installation and post-installation, you can disable this boot arg.
-s
  • Enables single-user mode.
-x
  • Enables safe mode.
npci=0x2000
  • Disables PCI debugging related to kIOPCIConfiguratorPFM64.
  • Required for all HEDT and a few 500 and 600 series Motherboards.
  • This issue can also fix stuck on "PCI Start Configuration Begin" as there are IRQ conflicts relating to PCI lanes.
  • This boot flag may cause a hang on systems where it is not required.
  • Do not use npci=0x2000 and npci=0x3000 together
npci=0x3000
  • Required for all HEDT and a few 500 and 600 series Motherboards.
  • Required where npci=0x2000 is not compatible
  • This issue can also fix stuck on "PCI Start Configuration Begin" as there are IRQ conflicts relating to PCI lanes.
  • This boot flag may cause a hang on systems where it is not required.
  • Do not use npci=0x3000 and npci=0x2000 together
slide=0
-xcpm
  • Enables XCPM
  • Only required on OS X 10.11 and older
cpus=1
  • Enables Single CPU Core Mode.
dart=0
  • Disables VT-d
  • Drops OEM DMAR table.
  • Superseded by OpenCore's DisableIoMapper Quirk.
debug=0x100
  • This disables macOS's watchdog which helps prevents a reboot on a kernel panic.
nvda_drv=1
  • Enables loading of NVIDIA Drivers
  • Similar to Clover's NVIDIAWeb
nv_disable=1
  • Disables loading of NVIDIA Drivers.
  • If you're having NVIDIA GPU and cannot reach the installation screen or unable to boot into your Desktop after the installation, use this boot arg to disable the NVIDIA drivers and install the drivers at the time of postinstallation.
keepsyms=1
  • This is a companion setting to debug=0x100 that tells the OS to also print the symbols on a kernel panic.
  • This can give some more helpful insight as to what's causing the panic itself.
kext-dev-mode=1
  • Allows loading of unsigned kexts
  • Only valid on Yosemite
rootless=0
  • Enables Rootless Mode
  • Only valid on Yosemite.
-disablegfxfirmware
  • To avoid firmware load endless loop


Kexts Specific

Lilu



-liludbgto enable debug printing (available in DEBUG binaries).
-liludbgallto enable debug printing in Lilu and all loaded plugins (available in DEBUG binaries).
-liluoffto disable Lilu.
-liluuseroffto disable Lilu user patcher (for e.g. dyld_shared_cache manipulations).
-liluslowto enable legacy user patcher.
-lilulowmemto disable kernel unpack (disables Lilu in recovery mode).
-lilubetato enable Lilu on unsupported OS versions (macOS 12 and below are enabled by default).
-lilubetaallto enable Lilu and all loaded plugins on unsupported os versions (use very carefully).
-liluforceto enable Lilu regardless of the mode, OS, installer, or recovery.
liludelay=1000to enable 1 second delay after each print for troubleshooting.
lilucpu=N
  • Spoofs CPU Generation.
liludump=N
  • to let Lilu DEBUG version dump log to /var/log/Lilu_VERSION_KERN_MAJOR.KERN_MINOR.txt after N seconds


VirtualSMC


-vsmcdbg
  • Enables debug printing.
  • Requires DEBUG version of VirtualSMC.
-vsmcoff
  • Disables all the Lilu enhancements.
-vsmcbeta
  • Enables VirtualSMC on unsupported macOS versions.
  • Usually relevant for newly announced macOS.
-vsmcrptto report about missing SMC keys to the system log.
-vsmccompto prefer existing hardware SMC implementation if found.
vsmcgen=Xto force exposing X-gen SMC device (1 and 2 are supported).
vsmchbkp=Xto set HBKP dumping mode (0 - off, 1 - normal, 2 - without encryption).
vsmcslvl=Xto set value serialisation level (0 - off, 1 - normal, 2 - with sensitive data (default)).
smcdebug=0xffto enable AppleSMC debug information printing.
watchdog=0
  • Disables WatchDog timer.
  • Required if you get accidental reboots.

WhateverGreen


-wegdbg
  • Enables debug printing. Requires DEBUG version of WhateverGreen
-wegoff
  • Disables WhateverGreen
-wegbeta
  • Enables WhateverGreen on unsupported macOS versions
  • Usually relevant for newly announced macOS.
-wegnoegpu
  • Disables all external GPUs (NVIDIA and AMD). Mainly required on Dual GPU Laptops.
  • Users who have patched ACPI and dGPU is disabled via DSDT and SSDT, you don't need to use this boot arg.
  • This boot arg is a temporary solution. It's recommended to patch your DSDT and related SSDTs to disable the discrete Graphics for a better power management and improved battery performance.
-wegnoigpu
  • Disables internal GPU
-wegswitchgpu
  • Disables internal GPU when external GPU is installed.
-radvesa
  • Disables ATI/AMD graphics acceleration.
-rad24
  • Enforces 24-bit display mode
-raddvi
  • Enables DVI transmitter correction
  • Required for 290X, 370, etc.
-radcodec
  • Forces the spoofed PID to be used in AMDRadeonVADriver
radpg=15
  • Fixes initialization for Radeon HD 7730/7750/7770/R7 250/R7 250X
  • Disables several power gating modes
agdpmod=vit9696
  • Disables board-id check
agdpmod=pikera
  • Fixes the black screen when macOS finishes loading.
  • Required for Navi based AMD GPU.
agdpmod=ignore
  • Disables AGDP patches
ngfxgl=1
  • Disables metal support on NVIDIA GPUs
ngfxcompat=1
  • Ignores compatibility check in NVDAStartupWeb
ngfxsubmit=0
  • Disables interface stuttering fix on 10.13
-ngfxdbg
  • Enables NVIDIA driver error logging
gfxrst=1
  • Prefers drawing Apple logo at 2nd boot stage instead of framebuffer copying.
gfxrst=4
  • Disables framebuffer init interaction during 2nd boot stage
igfxframe=frame
  • Injects a dedicated framebuffer identifier into IGPU
  • Only for TESTING purposes.
igfxsnb=0
  • Disables IntelAccelerator name fix for Sandy Bridge CPUs.
igfxgl=1
  • Disables Metal support on IGPU.
igfxmetal=1to force enable Metal support on Intel for offline rendering.
igfxpavp=1to force enable PAVP output
igfxfw=2
  • Forces loading of Apple GuC firmware
  • Requires 300 series chipset.
-igfxvesa
  • Disables IGPU acceleration.
-igfxnohdmi
  • Disables DP to HDMI conversion patches for digital sound.
-igfxtypec
  • Forces DP connectivity for Type-C platforms.
-cdfon
  • Enables CoreDisplayFixup functionality via WhateverGreen.kext.
  • Enables HDMI 2.0 patches.
  • This prevents a black screen for HDMI in UHD resolution with 60FPS or more.
  • Usually relevant for 4K/UHD/QHD Display. If your Laptop has a 4K/UHD/QHD panel, you'll need to use this boot arg.
  • If you get "gIOScreenLockState3 error", you'll need to use this property.
-igfxdump
  • Dumps IGPU framebuffer kext to /var/log/AppleIntelFramebuffer_X_Y (available in DEBUG binaries).
-igfxfbdump
  • Dumps native and patched framebuffer table to IOReg at IOService:/IOResources/WhateverGreen
applbkl=0
  • Disables AppleBacklight.kext patches for IGPU
-igfxmlr
  • Fixes invalid maximum link rate
  • This property on IGPU can fix the invalid link rate otherwise a kernel panic can occur due to a division-by-zero.
  • Usually required by Laptops with a Sharp Display and more refresh rate.
-igfxhdmidivs
  • Fixes the infinite loop when establishing an HDMI connection with a higher pixel clock.
  • For example, connecting to a 2K/4K display with HDMI 1.4, otherwise, the system just hangs and the built-in display will remain black when plugging the HDMI cable.
-igfxlspcon
  • Enables LSPCPN driver support to enable DisplayPort to HDMI 2.0 output on IGPU.
  • LSPCON driver is only applicable for Laptops with HDMI 2.0 routed to IGPU.
  • If your HDMI 2.0 is routed to IGPU and is working properly right now, you don't need to enable this driver, as your onboard LSPCON might have been already configured in the firmware to work in PCON mode.
  • This property can also provide HDR signaling over HDMI.
-igfxi2cdbg
  • Enables verbose output in I2C-over-AUX transactions (only for debugging purposes).
igfxagdc=0
  • Disables AGDC
igfxfcms=1to force complete modeset on Skylake or Apple firmwares.
igfxfcmsfbs=to specify indices of connectors for which complete modeset must be enforced. Each index is a byte in a 64-bit word; for example, value 0x010203 specifies connectors 1, 2, 3. If a connector is not in the list, the driver's logic is used to determine whether complete modeset is needed. Pass -1 to disable.
igfxonln=1
  • Forces online status on all displays.
  • Resolves display after wake on CFL and later.
igfxonlnfbs=MASKto specify indices of connectors for which online status is enforced. Format is similar to igfxfcmsfbs
wegtree=1
  • Forces device renaming on Apple FW.
igfxrpsc=1
  • Enables RPS control patch (improves IGPU performance)
-igfxcdc
  • Enables all valid Core Display Clock (CDCLK) frequencies on ICL platforms.
  • This property on IGPU can be used to prevent a kernel due to an unsupported CD clock decimal frequency.
  • Usually required by Laptops with lower clock frequency values such as 172.8MHz.
-igfxdvmt
  • Fixes Kernel Panic due to incorrect amount of DVMT pre-allocated memory.
  • This property on IGPU can fix the invalid link rate otherwise a kernel panic can occur due to a division-by-zero.
  • Usually required by Laptops where the BIOS is locked and the variables cannot be modified using Shell.
-igfxmpc
  • Fixes HDMI in UHD resolution with 60FPS
  • This property on IGPU can be used to raise the max pixel clock limit.
  • This prevents a black screen for HDMI in UHD resolution with 60FPS or more.
  • This property can be used for 4K@60Hz over HDMI 2.0.
  • Usually required by Laptops with 4K/UHD/QHD Display. If your Laptop has a 4K/UHD/QHD panel, you'll need to use this property.
  • If you get "gIOScreenLockState3" when booting, you'll need to use this property.
-igfxbls
  • Make brightness transitions smoother on IVB+ platforms
-igfxdbeo
  • Fixes garbled display on the built-in screen on Ice Lake platforms.
-igfxsklaskbl
  • To enforce Kaby Lake (KBL) graphics kext loading on SKL.
  • KBL device-id and ig-platform-id are required.
applbkl=3
  • Enables PWM backlight control of AMD Radeon RX 5000 series graphic cards

AppleALC


alcid=xx
  • Sets Layout ID for AppleALC.
  • The xx represents the layout ID for your codec.
-alcoff
  • Disables AppleALC
-alcdbg
  • Enables debug printing.
  • Requires DEBUG version of AppleALC
-alcbeta
  • Enables WhateverGreen on unsupported macOS versions
  • Usually relevant for newly announced macOS.

AirPortBrcmFixup


-brcmfxdbg
  • Enables debug printing.
  • Requires DEBUG version of AirPortBrcmFixup
-brcmfxbeta
  • Enables WhateverGreen on unsupported macOS versions
  • Usually relevant for newly announced macOS.
-brcmfxoff
  • Disables AirPortBrcmFixup
-brcmfxwowl
  • Enables WOWL (WoWLAN)
  • WOWL is disabled by default
-brcmfx-alldrv
  • Allows patching for all supported drivers, disregarding the current system version
brcmfx-country=XX
  • Changes the country code to XX (US, CN, #a, ...)
  • Can be injected via DSDT or Properties → DeviceProperties in bootloader
brcmfx-aspm
  • Overrides value used for pci-aspm-default
brcmfx-delay
  • Delays start of native Broadcom driver for the specified amount of milliseconds.
  • It can solve panics or missing wi-fi devices in Monterey. You can start with 15 seconds (brcmfx-delay=15000) and successively reduce this value until you notice instability in boot.
brcmfx-driver=0|1|2|3Enables only one kext for loading
0 - AirPortBrcmNIC-MFG,
1 - AirPortBrcm4360,
2 - AirPortBrcmNIC,
3 - AirPortBrcm4331,
Can be injected via DSDT or Properties → DeviceProperties in bootloader
 
Last edited:
  • Like
Reactions: oldman20

oldman20

Member
Joined
Nov 6, 2021
Messages
123
Motherboard
Dell 3558
CPU
Broadwell 5200U
Graphics
Intel HD5500
OS X/macOS
12.0.x
Bootloader
  1. Clover (UEFI)
  2. OpenCore
Mac
  1. MacBook Pro
Mobile Phone
  1. Android
  2. iOS
very clear, thank!
But i dont see some key like:
darkwake=0
abm_firstpolldelay=16000
alcverbs=1
Hope you can explain more! cheer

I found in acidanthera
  • alcverbs=1 — to enable alc-verb support (also alc-verbs device property);
    but dont clear alc-verb sp for what?

    In sbd github
  • darkwake=0
    Disable wake up of certain parts of your Mac from sleep, while leaving other parts in sleep mode. This feature often messes up sleep on Hackintoshes. Enter darkwake=1 to turn it on, if turning it off doesn’t do the trick). if your verbose boot is freezing be sure to remove SleepEnabler.kext completely by deleting it from either /Extra/Extensions or /System/Library/Extensions in your hard drive.

    and in tonymax has a post found darkwake=0 cause autosleep not working
    So i wonder what differrent between flag darkwake=no and didnt put this flag boot-arg?
  • Thank and sorry if wrong thread
 
Last edited:
  • Like
Reactions: EliteMacx86

EliteMacx86

Administrator
Staff member
Joined
Jul 22, 2018
Messages
3,861
Motherboard
Supermicro X11SPA-T
CPU
Intel Xeon W-3275 28 Core
Graphics
2xAMD RX 580 8GB
OS X/macOS
11.0.x
Bootloader
  1. OpenCore
Mac
  1. Mac mini
  2. MacBook Pro
Mobile Phone
  1. Android
  2. iOS
very clear, thank!
But i dont see some key like:
darkwake=0
abm_firstpolldelay=16000
alcverbs=1
Hope you can explain more! cheer

I found in acidanthera
  • alcverbs=1 — to enable alc-verb support (also alc-verbs device property);
    but dont clear alc-verb sp for what?

    In sbd github
  • darkwake=0
    Disable wake up of certain parts of your Mac from sleep, while leaving other parts in sleep mode. This feature often messes up sleep on Hackintoshes. Enter darkwake=1 to turn it on, if turning it off doesn’t do the trick). if your verbose boot is freezing be sure to remove SleepEnabler.kext completely by deleting it from either /Extra/Extensions or /System/Library/Extensions in your hard drive.

    and in tonymax has a post found darkwake=0 cause autosleep not working
    So i wonder what differrent between flag darkwake=no and didnt put this flag boot-arg?
  • Thank and sorry if wrong thread
Thank you for your feedback on this thread!

We're in the process of redesigning the forum with some major improvements. You might have already noticed ;)

The threads will be updated as soon as we finish the backend tasks. We'll include all those args which you have mentioned. There is a lot more to add ;)

Cheers!
 
  • Like
Reactions: oldman20

Forum statistics

Threads
749
Messages
7,931
Members
6,855
Latest member
Breakthru81