INFO - Common Boot Args For macOS (Clover - OpenCore) - EliteMacx86 Forum

3/13/24, 10:21 AM INFO - Common Boot Args for macOS [Clover/OpenCore] | EliteMacx86 Forum
󰋽 Become a Premium Member for $25/year with no ads to improve your community experience.
INFO Common Boot Args for macOS [Clover/OpenCore]

󰀓 EliteMacx86󰄴 · 󰅐 Jun 23, 2022 · 󱋷 applealc boot args boot arguments boot flag clover darwin lilu macos
opencore virtualsmc whatevergreen
󰚡 󰅂 Forums 󰅂 Installation 󰅂 Basics
Jun 23, 2022 󱔔 #1
Common Boot Args for macOS

[Clover/OpenCore]
EliteMacx86󰄴
Administrator 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
Staff member common boot args and some are kexts specific. This is a list of common boot
Joined: Jul 22, 2018 boot args for macOS which can be used on Clover and OpenCore as well.
Messages: 6,437
Motherboard: Common Boot Args
Supermicro X11SPA-T
󰍜
CPU: Intel Xeon W-3275 28 Core 󰷖 󰅌 󰇙 󰍉
Graphics: 2xAMD RX 580 8GB Boot Args Purpose
OS X/macOS: 13.x
Bootloader: OpenCore (UEFI)
Enables verbose mode. Replaces the progress
Mac: Mac mini, MacBook Pro bar below the Apple logo with a text output of
Mobile Phone: Android, iOS the boot process.
Helpful to track the installation progress or when
-v
booting.
We recommend using this boot arg.
Once you're done with the installation and post-
installation, you can disable this boot arg.
Enables single-user mode.

-s
Boots macOS in Terminal mode.
-x
Enables safe mode.
https://elitemacx86.com/threads/common-boot-args-for-macos-clover-opencore.937/ 1/27
󰅖 Boots macOS with a minimal set of system

extensions and features.
Useful for reverting the root patches applied by
OpenCore Legacy Patcher if they no longer work
or if macOS won't boot after applying the
patches.
Enables cacheless booting.

Only applicable for Clover Bootloader. OpenCore
uses a different option available in
-f
Kernel>Scheme>KernelCache . Change Auto to
Cacheless .
Only applicable to OS X 10.6 to OS X 10.9.
This disables macOS's watchdog which helps prevents a

debug=0x100
reboot on a kernel panic.
This is a companion setting to debug=0x100 that

tells the OS to also print the symbols on a kernel
keepsyms=1 panic.
This can give some more helpful insight as to
what's causing the panic itself.
Enables Rootless Mode

rootless=0
Only valid on Yosemite.
slide=0
Disables VT-d
Drops OEM DMAR table.
dart=0
Superseded by OpenCore's DisableIoMapper
Quirk.
cpus=1 Enables Single CPU Core Mode.
Enables XCPM
-xcpm
Only required on OS X 10.11 and older
Allows loading of unsigned kexts

kext-dev-mode=1
Only valid on Yosemite
- To avoid firmware load endless loop

disablegfxfirmware Only applicable to IGPUs.
󰅖
Disables macOS compatibility checks.
Allows booting macOS with unsupported
SMBIOS/board-ids.
Required for booting new macOS version on old
-no_compat_check hardware while using the old SMBIOS, which is
considered obsolete by Apple.
A clean install isn't possible when using this boot
arg. In addition, you cannot install system
updates if this boot-arg is active.
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
npci=0x2000 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
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
npci=0x3000
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
Enables loading of NVIDIA Drivers

nvda_drv=1
Similar to Clover's NVIDIAWeb
Disables loading of NVIDIA Drivers.

If you're having NVIDIA GPU and cannot reach
the installation screen or unable to boot into
nv_disable=1
your Desktop after the installation, use this boot
arg to disable the NVIDIA drivers and install the
drivers at the time of postinstallation.
󰅖
Kexts Specific
Lilu
-liludbg Enables debug printing. Requires DEBUG version of Lilu.

Enables debug printing in Lilu and all loaded plugins
-liludbgall
(available in DEBUG binaries).
Disables Lilu.
All other kexts relying on Lilu will not be injected when
-liluoff using this boot-arg.
Be careful when using this boot-arg. It's highly
recommended not to use this boot-arg.
Disables Lilu user patcher (for e.g. dyld_shared_cache

-liluuseroff
manipulations).
-liluslow Enables legacy user patcher.
-lilulowmem Disables kernel unpack (disables Lilu in recovery mode).
Enables Lilu on unsupported macOS versions (macOS 13 and

below are enabled by default).
-lilubeta
Usually relevant for newly announced macOS.
Enables Lilu and all loaded plugins on unsupported os

-lilubetaall
versions (use very carefully).
Enables Lilu regardless of the mode, OS, installer, or

-liluforce
recovery.
Adds 1 second (100ms) delay after each print for

liludelay=1000
troubleshooting.
Spoofs CPU Generation.

The Nrefers to the following Intel generations:
4 - Sandy Bridge
5 - Ivy Bridge
lilucpu=N 6 - Haswell
7 - Broadwell
8 - Skylake
9 - Kaby Lake
10 - Coffee Lake
󰅖
to let Lilu DEBUG version dump log to
liludump=N /var/log/Lilu_VERSION_KERN_MAJOR.KERN_MINOR.txt
after N seconds
VirtualSMC
Enables debug printing.

-vsmcdbg
Requires DEBUG version of VirtualSMC.
Disables all the Lilu enhancements.

Without this kext, no macOS/OS X version will boot
-vsmcoff due to a lack of SMC Emulation.
Enables VirtualSMC on unsupported macOS versions

-vsmcbeta (macOS 13 and below are enabled by default).
-vsmcrpt Reports missing SMC keys to the system log.
-vsmccomp Prefer existing hardware SMC implementation if found.
Forces exposing X-gen SMC device (1 and 2 are

vsmcgen=X
supported).
Sets HBKP dumping mode (0 - off, 1 - normal, 2 - without

vsmchbkp=X
encryption).
Set value serialisation level (0 - off, 1 - normal, 2 - with

vsmcslvl=X
sensitive data (default)).
smcdebug=0xff Enables AppleSMC debug information printing.
Disables WatchDog timer.

watchdog=0
Required if you get accidental reboots.
WhateverGreen
Global
󰅖
Enables debug printing. Requires DEBUG version of
-wegdbg
WhateverGreen
Disables WhateverGreen
Disabling this boot-arg can cause several Graphics
-wegoff related issues.
Enables WhateverGreen on unsupported macOS versions

-wegbeta (macOS 13 and below are enabled by default).
Enables CoreDisplayFixup functionality via

WhateverGreen.kext.
Enables HDMI 2.0 patches on IGPU and dGPU.
Patches CheckTimingWithRange in
CoreDisplay.framework to skip validation of the pixel
clock.
-cdfon This prevents a black screen for HDMI in UHD resolution
with 60FPS or more.
Required for Laptops and OEM systems with
4K/UHD/QHD Displays.
If you get "gIOScreenLockState3 error", you'll need to
use this property.
Does not work on macOS Big Sur (11.x) and later.
wegtree=1 Forces device renaming on Apple FW.
Prefers drawing Apple logo at 2nd boot stage instead of

gfxrst=1
framebuffer copying.
Disables framebuffer init interaction during 2nd boot

gfxrst=4
stage
Board-id
Boot Args Purpose
󰅖
Disables board-id check.
agdpmod=vit9696
Fixes black screen
Fixes black screen when macOS finishes loading.

agdpmod=pikera
Required for Navi based AMD GPU.
agdpmod=ignore Disables AGDP patches
GPU Switching
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
-wegnoegpu 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
-
Disables internal GPU when external GPU is installed.
wegswitchgpu
NVIDIA Graphics
-ngfxdbg Enables NVIDIA driver error logging
ngfxgl=1 Disables metal support on NVIDIA GPUs
ngfxcompat=1 Ignores compatibility check in NVDAStartupWeb
ngfxsubmit=0 Disables interface stuttering fix on 10.13
AMD Graphics 󰅖
-radvesa Disables ATI/AMD graphics acceleration.
-rad24 Enforces 24-bit display mode
Enables DVI transmitter correction

-raddvi
Required for 290X, 370, etc.
- Forces the spoofed PID to be used in

radcodec AMDRadeonVADriver
Fixes initialization for Radeon HD 7730/7750/7770/R7

radpg=15 250/R7 250X
Disables several power gating modes
Intel Graphics
Injects a dedicated framebuffer identifier into

igfxframe=frame IGPU
Only for TESTING purposes.
Disables IntelAccelerator name fix for Sandy

igfxsnb=0
Bridge CPUs.
igfxgl=1 Disables Metal support on IGPU.
to force enable Metal support on Intel for offline

igfxmetal=1
rendering.
igfxpavp=1 to force enable PAVP output
Forces loading of Apple GuC firmware

igfxfw=2
Requires 300 series chipset.
-igfxvesa Disables IGPU acceleration.
󰅖
Disables DP to HDMI conversion patches for
-igfxnohdmi
digital sound.
-igfxtypec Forces DP connectivity for Type-C platforms.
Dumps IGPU framebuffer kext to

-igfxdump /var/log/AppleIntelFramebuffer_X_Y (available
in DEBUG binaries).
Dumps native and patched framebuffer table to

-igfxfbdump IOReg at
IOService:/IOResources/WhateverGreen
applbkl=0 Disables AppleBacklight.kext patches for IGPU
Fixes invalid maximum link rate

This property on IGPU can fix the invalid link
rate otherwise a kernel panic can occur due to a
-igfxmlr
division-by-zero.
Usually required by Laptops with a Sharp
Display and more refresh rate.
Fixes the infinite loop when establishing an

HDMI connection with a higher pixel clock.
For example, connecting to a 2K/4K display with
-igfxhdmidivs
HDMI 1.4, otherwise, the system just hangs and
the built-in display will remain black when
plugging the HDMI cable.
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
-igfxlspcon 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.
󰅖
Enables verbose output in I2C-over-AUX
-igfxi2cdbg
transactions (only for debugging purposes).
Disables iGPU telemetry loading that may cause a

-
freeze during startup on certain laptops such as
igfxnotelemetryload
Chromebooks
igfxagdc=0 Disables AGDC
to force complete modeset on Skylake or Apple

igfxfcms=1
firmwares.
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
igfxfcmsfbs=
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.
Forces online status on all displays.

igfxonln=1
Resolves display after wake on CFL and later.
to specify indices of connectors for which online status

igfxonlnfbs=MASK
is enforced. Format is similar to igfxfcmsfbs
wegtree=1 Forces device renaming on Apple FW.
Enables RPS control patch (improves IGPU

igfxrpsc=1
performance)
Enables all valid Core Display Clock (CDCLK)

frequencies on ICL platforms.
This property on IGPU can be used to prevent a
-igfxcdc 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.
Fixes HDMI in UHD resolution with 60FPS

This property on IGPU can be used to raise the
max pixel clock limit (as an alternative to
patching CoreDisplay.framework).
Prevents black screen on 4K/UHD/QHD Displays
@60Hz and HDMI 2.0 in UHD resolution with
60Hz or more.
-igfxmpc Requires Invalid Maximum Link rate for Laptop
Displays with more than 60Hz.
This property can be used for 4K@60Hz over
HDMI 2.0.
Required for Laptops and OEM systems with
4K/UHD/QHD Displays @60Hz.
If you get "gIOScreenLockState3" when
booting, you'll need to use this property.
Make brightness transitions smoother on IVB+

-igfxbls
platforms
Fixes garbled display on the built-in screen on

-igfxdbeo
Ice Lake platforms.
To enforce Kaby Lake (KBL) graphics kext

-igfxsklaskbl loading on SKL.
KBL device-id and ig-platform-id are required.
Enables PWM backlight control of AMD Radeon

applbkl=3
RX 5000 series graphic cards
Backlight
applbkl=0 Disables AppleBacklight.kext patches for IGPU
Enables PWM backlight control of AMD Radeon RX 5000

applbkl=3
series graphic cards
NootedRed
-nreddbg 󰅖 debugging output from kext and FB.

Enable
-
Enables Display Core debugging output
nreddmlogger
-nredoff Disables NootedRed

Boot in FB-only, without acceleration. Visual artifacts and
-nredfbonly
glitches are present.
-nred24bit
AppleALC
Sets Layout ID for AppleALC.

alcid=xx
The xx represents the layout ID for your codec.
-alcoff Disables AppleALC

-alcdbg
Requires DEBUG version of AppleALC
Enables WhateverGreen on unsupported macOS

-alcbeta versions (macOS 13 and below are enabled by default).
alcverbs=1 Enables alc-verb support.
Adds delay in AppleHDAController.

Useful where the hardware isn't initialized in time for
alcdelay=xxx AppleHDAController which results in no Audio output.
The xx represents the delay in ms.
Must not exceed 3000ms.
alctcsel=1 Fixes Audio on macOS after rebooting from Windows.
AirPortBrcmFixup

-brcmfxdbg
Requires DEBUG version of AirPortBrcmFixup
󰅖
Enables AirPortBrcmFixup on unsupported macOS
versions (macOS 13 and below are enabled by
-brcmfxbeta
default).
-brcmfxoff Disables AirPortBrcmFixup
Enables WOWL (WoWLAN)

-brcmfxwowl
WOWL is disabled by default
Allows patching for all supported drivers,

-brcmfx-alldrv
disregarding the current system version
Changes the country code to XX (US, CN, #a, ...)

brcmfx-
Can be injected via DSDT or Properties →
country=XX
DeviceProperties in bootloader
brcmfx-aspm Overrides value used for pci-aspm-default
Delays start of native Broadcom driver for the

specified amount of milliseconds.
It can solve panics or missing wi-fi devices in
brcmfx-
Monterey. You can start with 15 seconds (brcmfx-
delay=xxxxx
delay=15000) and successively reduce this value
until you notice instability in boot.
The xxxxx represents the delay in ms.
Enables only one kext for loading

0 - AirPortBrcmNIC-MFG,
1 - AirPortBrcm4360,
brcmfx-
2 - AirPortBrcmNIC,
driver=0|1|2|3
3 - AirPortBrcm4331,
Can be injected via DSDT or Properties → DeviceProperties
in bootloader
BrcmPatchRAM
Boot Args Description
bpr_initialdelay=x
Changes mInitialDelay , where x
represents the delay in ms before any
󰅖 communication happens with the device. The

default value is 100 .
Overrides mSupportsHandshake , firmware

uploaded handshake support status.
0 means wait bpr_preresetdelay ms after
bpr_handshake=x uploading firmware, and then reset the device.
1 means wait for a specific response from
the device and then reset the device. The
default value depends on the device identifier.
Changes mPreResetDelay , where x represents

the delay in ms assumed to be needed for the
device to accept the firmware. The value is
bpr_preresetdeay unused when bpr_handshake is 1 (passed
manually or applied automatically based on
the device identifier). The default value is
250 .
Changes mPostResetDelay , where x

represents the delay in ms assumed to be
bpr_postresetdelay=x needed for the firmware to initialize after
resetting the device upon firmware upload.
The default value is 100 .
Changes mProbeDelay (removed in

bpr_probedelay=x BrcmPatchRAM3), the delay in ms before
probing the device. The default value is 0.
Disables address check in macOS 12.4 and

newer.
Required for macOS 12.4 and newer as Apple
-btlfxallowanyaddr introduced a new address check in
bluetoothd , which will trigger an error if two
Bluetooth devices have the same address.
Only applicable for macOS 12.4 and newer.
itlwm
itlwm_cc=COUNTRY_CODE Change the country code to a desired one,

effective on all devices, mostly useful for iwn,
󰅖 7000 & 8000 series iwm using itlwm.kext or

running macOS earlier than 10.14.
Disables IEEE802.11AC support
-novht
Useful if the router has compatibility issues.
Disables 40MHz when using 2.4GHz (Use this

option if the network with this config causes
-noht40
instabilities. Natively supported adapters by
Apple disable 2.4GHz HT40 by default)
IntelMausi
Boot
Description
Args
Froce enables Wake on LAN functionality for Intel

- Ethernet for testing purposes.
mausiwol Required for misconfigured hardware.
Requires IntelMausi.kext.
CPUTscSync
Enables debug logging. Requires DEBUG version of

-cputsdbg
CPUTscSync.
-cputsoff Disables CPUTscSync.
Enables CPUTscSync on unsupported macOS versions

-
(macOS 13 and below are enabled by default).
cputsbeta
Forces using of method clock_get_calendar_microtime to

-
sync TSC (the same method is used when boot-arg
cputsclock
TSC_sync_margin is specified)
CPUFriend
Boot
Description
Args

-cpufdbg
CPUFriend.
󰅖
-cpufoff Disables CPUFriend.
Enables CPUFriend on unsupported macOS versions

-cpufbeta (macOS 13 and below are enabled by default).
CryptexFixup
Enables verbose logging. Requires DEBUG

-cryptdbg
version of CryptexFixup
-cryptoff Disables CryptexFixup
Enables CryptexFixup on unsupported macOS

default).
-cryptbeta
Usually relevant for newly announced
macOS.
-
Disables APFS.kext patching
crypt_allow_hash_validation
Force installing Rosetta Cryptex on AVX2.0

-crypt_force_avx
systems
ECEnabler
Boot
Description
Args
-ecedbg Enables verbose logging. Requires DEBUG version of ECEnabler.

-eceoff Disables ECEnabler
Enables ECEnabler on unsupported macOS versions (macOS 13

and below are enabled by default).
-ecebeta
NVMeFix
-nvmefdbg Enables debug logging. Requires DEBUG version of NVMeFix.
-nvmefoff Disables NVMeFix.
- Forces ASPM L1 on all the devices. This argument is

nvmefaspm recommended exclusively for testing purposes, as for daily
usage󰅖one could inject pci-aspm-default device property

with <02 00 00 00> value into the SSD devices and bridge
devices they are connected to onboard. Updated values will be
visible as pci-aspm-custom in the affected devices.
FeatureUnlock
Enables verbose logging. Requires DEBUG version of

-cardbg
FeatureUnlock.
Enables FeatureUnlock on unsupported macOS

-carbeta default).
-caroff Disables FeatureUnlock
-allow_sidecar_ipad Enables SideCar support on unsupported iPads.
-
Disables SideCar/AirPlay/Universal Control patches.
disable_sidecar_mac
-disable_nightshift Disables NightShift patches
Forces Universal Control patching even when model

-force_uni_control
doesn't require.
BrightnessKeys
- Enables debug printing. Requires DEBUG version of

brkeysdbg BrightnessKeys.
MacHyperVSupport
Core Controller (HyperVController)

Core Hyper-V controller module
Boot Arg Description

hvctrldbg MacHyperVSupport.
CPU Disabler (HyperVCPU)

Disables additional CPUs under macOS 10.4
- 󰅖 debug printing. Requires DEBUG version of

Enables
hvcpudbg MacHyperVSupport.
File Copy (HyperVFileCopy)

Provides host to guest file copy support (Guest Services). Requires the
hvfilecopyd userspace daemon to be running.

-hvfcopydbg
MacHyperVSupport.
- Enables debug printing of message data. Requires DEBUG

hvfcopymsgdbg version of MacHyperVSupport.
-hvfcopyoff Disables this module
Graphics Bridge (HyperVGraphicsBridge)

Provides basic graphics support for macOS.

-hvgfxbdgb
MacHyperVSupport.

hvgfxbmsgdbg version of MacHyperVSupport
-hvgfxboff Disables this module
Heartbeat (HyoerVHeartbeat)
Provides heartbeat reporting to Hyper-V.

-hvheartdbg
MacHyperVSupport.

hvheartmsgdbg version of MacHyperVSupport
-hvheartoff Disables this module
Keyboard (HyperVKeyboard)
Provides keyboard support.

-hvkbddbg
MacHyperVSupport.

hvkbdmsgdbg version of MacHyperVSupport
-hvkbdoff Disables this module
Mouse (HyperVMouse)
󰅖
Provides mouse support.

-hvkbddbg
MacHyperVSupport.

hvkbdmsgdbg version of MacHyperVSupport
-hvmouseoff Disables this module
Network (HyperVNetwork)
Provides networking support.

-hvnetdbg
MacHyperVSupport.

hvnetdmsgdbg version of MacHyperVSupport
-hvnetoff Disables this module
PCI Bridge (HyperVPCIBridge)

Provides PCI passthrough support.

-hvpcibddbg
MacHyperVSupport.

hvpcibmsgdbg version of MacHyperVSupport
-hvpciboff Disables this module
PCI Module Device (HyperVmoduleDevice)

Provides MMIO allocation/deallocation functions for PCI passthrough.

hvpcimdbg MacHyperVSupport.
PCI Provider (HyperVPCIProvider)

Provides IOACPIPlatformDevice nub on generation 2 VMS for fake PCI root
bridge (HyperVPCIRoot).

hvkbddbg MacHyperVSupport.
PCI Root Bridge (HyperVPCIRoot)

Provides a fake PCI root bridge for proper macOS functionality on generation
󰅖support for PCI passthrough.

2 VMs, and provides

hvpcirddbg MacHyperVSupport.
Shutdown (HyperVShutdown)
Provides software shutdown through Virtual Machine Connection and
PowerShell. Requires the hvshutdownd userspace daemon to be running.

-hvshutdbg
MacHyperVSupport.

hvshutmsgdbg version of MacHyperSupport
-hvshutoff Disables this module
Storage (HyperVStorage)
Provides SCSI storage support.

-hvstordbg
MacHyperVSupport.

hvstormsgdbg version of MacHyperSupport
-hvstoroff Disables this module
Time Synchronization (HyperVTimeSync)

Provides host to guest time synchronization support. Requires the
hvtimesyncd userspace daemon to be running.

-hvtimedbg
MacHyperVSupport.
hvtimemsgdbg version of MacHyperSupport
-hvtimeoff Disables this module
VMBus Controller (HyperVVMBus)

Provides root of VMBus devices and services.

hvvmbusdbg MacHyperVSupport.
VMBus Device Nub (HyperVVMBusDevice)

󰅖nub for child VMBus device modules.

Provides connection

hvvmbusdebdbg MacHyperVSupport.
RealtekCardReader
initialize all cards at 3.3V, so cards can work at the default

-iosd3v3
or the high speed mode only.
initialize all cards at the default speed mode. The maximum

-iosddsm
data transfer rate is limited to 12 MB/s.
initialize all cards at the high speed mode. The maximum

-iosdhsm
data transfer rate is limited to 25 MB/s.
separate each CMD18/25 request into multiple CMD17/24
-iosdsabr ones, so the host driver will not access multiple blocks on
the card in one shot.
ask the host driver not to issue the ACMD23 before sending
the CMD25 to the card. When the driver processes a multi-
block write (CMD25) request, the specification recommends
- to issue an ACMD23 to pre-erase blocks to be written to
iosdnoacmd23 improve the write performance. By default, the host driver
always sends the ACMD23 before the CMD25. Use this boot
argument if you observe any write performance
degradation.
Specify the maximum number of attempts to retry an

iosdamna
application command (ACMD*).
Specify the amount of time in milliseconds to delay the card

initialization if the card is present when the driver starts.
rtsxdcib
Increase the delay if your card cannot be initialized when
the system boots.
Specify the interval in milliseconds of polling for the device

status. A background thread checks whether a card is
present every interval milliseconds and notifies other driver
rtsxdspi components if a card is inserted or removed. Increasing the
interval will increase the latency of processing the card
event, while decreasing the value will waste your CPU cycle,
so please choose an interval value wisely.
󰅖 the card status via the control endpoint instead of a

fetch
bulk transfer. Some RTS5139 chips can report the card
-rtsxppsta
status only via the control endpoint thus are not compatible
with the default mechanism.
Specify the amount of time in milliseconds to wait until the

SSC clock becomes stable. If the value is too small,
rtsxdssc commands may timeout after the driver switches the card
clock. Increase this value if you find that the driver fails to
enable the 4-bit bus in the kernel log.
VoodooI2C
Force enable polling mode for specific I2C

-vi2c-force-
Controller.
polling
Required where APIC interrupt is unavailable.
RTCMemoryFixup
Enables debug logging.

-rtcfxdbg Requires DEBUG version of
RTCMemoryFixup.
List of offsets or ranges of

rtcfx_exclude=offset1,offset2,start_offset-
offsets where writing is not
end_offset
allowed
HibernationFixup

-hbfxdbg
RTCMemoryFixup.
Enables FeatureUnlock on unsupported macOS

-hbfxbeta default).
-hbfxoff disables kext loading
Saves NVRAM to a file nvram.plist before

-hbfx-dump-nvram hibernation and after kernel panic (with panic
info)
󰅖 disables patching of IOPCIFamily (this patch helps to

-hbfx-disable-
avoid hang & black screen after resume
patch-pci
(restoreMachineState won't be called for all devices)
allows to specify explicit device list (and

hbfx-patch-
restoreMachineState won't be called only for these
pci=XHC,IMEI,IGPU
devices). Also supports values none, false, off.
controls auto-hibernation feature, where abhm_value

is an arithmetic sum of respective values below:
EnableAutoHibernation = 1: If this flag is set,

system will hibernate instead of regular sleep
(flags below can be used to limit this behavior)
WhenLidIsClosed = 2: Auto hibernation can
happen when lid is closed (if bit is not set - no
matter which status lid has)
WhenExternalPowerIsDisconnected = 4: Auto
hibernation can happen when external power is
disconnected (if bit is not set - no matter
whether it is connected)
WhenBatteryIsNotCharging = 8: Auto
hibernation can happen when battery is not
charging (if bit is not set - no matter whether it
hbfx-
is charging)
ahbm=abhm_value
WhenBatteryIsAtWarnLevel = 16: Auto
hibernation can happen when battery is at
warning level (macOS and battery kext are
responsible for this level)
WhenBatteryAtCriticalLevel = 32: Auto
hibernation can happen when battery is at
critical level (macOS and battery kext are
responsible for this level)
DoNotOverrideWakeUpTime = 64: Do not alter
next wake up time, macOS is fully responsible
for sleep maintenance dark wakes
DisableStimulusDarkWakeActivityTickle = 128:
Disable power event
kStimulusDarkWakeActivityTickle in kernel, so
this event cannot trigger a switching from dark
wake to full wake
RestrictEvents
Enables verbose logging. Requires DEBUG version of

-revdbg
RestrictEvents.
-revoff Disables RestrictEvents.
󰅖 Enables RestrictEvents on unsupported macOS versions

(macOS 13 and below are enabled by default).
-revbeta
Enables verbose process logging. Requires DEBUG

-revproc
version of RestrictEvents.
Enables patching as comma separated options.

The default value is auto.
Possible values for patching:
memtab - enable memory tab in System
Information on MacBookAir and
MacBookPro10,x platforms
pci - prevent PCI configuration warnings in
System Settings on MacPro7,1 platforms
cpuname - custom CPU name in System
Information
diskread - disables uninitialized disk
warning in Finder
asset - allows Content Caching when sysctl
revpatch=value
kern.hv_vmm_present returns 1 on macOS
11.3 or newer
sbvmm - forces VMM SB model, allowing
OTA updates for unsupported models on
macOS 11.3 or newer
f16c - resolve CoreGraphics crashing on
Ivy Bridge CPUs by disabling f16c
instruction set reporting in macOS 13.3 or
newer
none - disable all patching
auto - same as memtab,pci,cpuname,
without memtab and pci patches being
applied on real Macs
Enables or disables CPU brand string patching.

revcpu=value
1 = non-Intel default, 0 = Intel default
Custom CPU brand string (max 48 characters, 20 or less

revcpuname=value
recommended, taken from CPUID otherwise)
revblock=value
To block processes as comma separated options.
The default value is auto
Possible values for patching:
pci - prevent PCI and RAM configuration
notifications on MacPro7,1 platforms
oldman20 gmux - block displaypolicyd on Big Sur+
(for genuine MacBookPro9,1/10,1)
󰅖 media - block mediaanalysisd on Ventura+

󰼠 Reply
(for Metal 1 GPUs)
none - disable all blocking
Jul 21, 2022 auto - same as PCI 󱔔 #2
O very clear, thank!

But i dont see some key like:
NOTE: 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:revpatch , 4D1FDA02-38C7-
darkwake=0
4A6A-9CC6-4BCCA8B30102:revcpu , 4D1FDA02-38C7-4A6A-9CC6-
abm_firstpolldelay=16000
oldman20 4BCCA8B30102:revcpuname and 4D1FDA02-38C7-4A6A-9CC6-
alcverbs=1
Member 4BCCA8B30102:revblock NVRAM variables work the same as the boot
Hope you can explain more! cheer
Joined: Nov 6, 2021 arguments, but have lower priority.
Messages: 141
I found in acidanthera
Motherboard: Dell 3558 DebugEnhancer
CPU: Broadwell 5200U alcverbs=1 — to enable alc-verb support (also alc-verbs device
Graphics: Intel HD5500 Bootproperty);
Args Description
OS X/macOS: 13.x but dont clear alc-verb sp for what?
Enables debugging output. Requires DEBUG version of
Bootloader: -dbgenhdbg
DebugEnhancer
Clover (UEFI), OpenCore (UEFI) In sbd github
Mac: MacBook Pro darkwake=0 Enables DebugEnhancer on unsupported macOS versions
Mobile Phone: Android, iOS Disable wake
(macOSup of13certain parts are
and below of your Mac by
enabled from sleep, while leaving
default).
-dbgenhbeta
other parts in sleep mode. This feature often messes up sleep on
Hackintoshes. EnterUsually relevant for
darkwake=1 newly
to turn announced
it on, if turningmacOS.
it off doesn’t do
the trick). if your verbose boot is freezing be sure to remove
-dbgenhoff Disablescompletely
SleepEnabler.kext DebugEnhancer.
by deleting it from either /Extra/Extensions
or /System/Library/Extensions in your hard drive.
- Redirects IOLog output to kernel vprintf (the same as for
dbgenhiolog kdb_printf and kprintf)
and in tonymax has a post found darkwake=0 cause autosleep not
working
Last edited: May 24, 2023
So i wonder what differrent between flag darkwake=no and didnt put
this flag boot-arg?
Thank and sorry if wrong thread
Last edited: Jul 21, 2022
EliteMacx86
󰼠 Reply
Jul 21, 2022 󱔔 #3
oldman20 said: 󰕍
very clear, thank!

EliteMacx86󰄴 But i dont see some key like:
Administrator darkwake=0
󰚼 abm_firstpolldelay=16000
Staff member alcverbs=1
Joined: Jul 22, 2018 󰅖 more! cheer

Hope you can explain
Messages: 6,437 Click to expand...
Motherboard: If di id th
Supermicro X11SPA-T Thank you for your feedback on this thread!
CPU: Intel Xeon W-3275 28 Core
Graphics: 2xAMD RX 580 8GB We're in the process of redesigning the forum with some major
OS X/macOS: 13.x improvements. You might have already noticed
Bootloader: OpenCore (UEFI)
Mac: Mac mini, MacBook Pro The threads will be updated as soon as we finish the backend tasks. We'll
Mobile Phone: Android, iOS include all those args which you have mentioned. There is a lot more to add
Cheers!
oldman20
󰼠 Reply
󰉤 󰉷 󰦨 󰇙 󰉹 󰉢 󰉽 󰌷 󰥶 󰇙 󰕌 󰇙
? 󰱽
Write your reply...
󰼠 Post reply
Similar threads
INFO Common Device Properties for macOS 󰤱 Replies: 0 Mar 29, 2023
[Clover/OpenCore] Views: 2K EliteMacx86󰄴
EliteMacx86󰄴 · Mar 29, 2023 · Basics
INFO Common SSDT usage for macOS 󰈤 Replies: 0 Apr 7, 2023

EliteMacx86󰄴 · Apr 7, 2023 · Basics Views: 2K EliteMacx86󰄴
GUIDE MSI Z690 UNIFY - Intel Core i7-14700KF - 64GB Replies: 0 Dec 31, 2023
RAM - AMD RX 6900XT - WiFi/BT - Thunderbolt 3 - Views: 453 EliteMacx86󰄴
OpenCore
EliteMacx86󰄴 · Dec 31, 2023 · Ventura Desktop Guides
󰅖
GIGABYTE Z790 AERO G - Intel Core i9-13900KF - 64GB Replies: 0 Dec 31, 2023
DDR5 RAM - AMD RX 6800XT - WiFi/BT - OpenCore Views: 332 EliteMacx86󰄴
GUIDEGIGABYTE Z790 UD - Intel Core i9-13900KF - Replies: 0 Dec 31, 2023

64GB DDR5 RAM - AMD RX 6800XT - WiFi/BT - Views: 398 EliteMacx86󰄴
OpenCore
OpenCore 0.9.5 Update 󰈤 Replies: 0 Sep 11, 2023

EliteMacx86󰄴 · Sep 11, 2023 · OpenCore Views: 2K EliteMacx86󰄴
GUIDE How to Install macOS on Hyper-V - OpenCore Replies: 7 Mar 2, 2024

D
Install Guide Views: 9K Dreaded2400
EliteMacx86󰄴 · Oct 20, 2023 · Virtualization
Share: 󰈌 󰑍 󰐇 󰖣 󰇰 󰌷
󰚡 󰅂 Forums 󰅂 Installation 󰅂 Basics
EliteMacx86 Dark Contact Us Terms and Conditions Privacy Policy Help Home 󰁝 󰑫
Community platform by XenForo® © 2010-2024 XenForo Ltd. 󰈌 󰙯 󰕄 󰗃

INFO - Common Boot Args For macOS (Clover - OpenCore) - EliteMacx86 Forum

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

INFO - Common Boot Args For macOS (Clover - OpenCore) - EliteMacx86 Forum

Uploaded by

Copyright:

Available Formats

3/13/24, 10:21 AM INFO - Common Boot Args for macOS [Clover/OpenCore] | EliteMacx86 Forum

INFO Common Boot Args for macOS [Clover/OpenCore]

󰚡 󰅂 Forums 󰅂 Installation 󰅂 Basics

Jun 23, 2022 󱔔 #1

Common Boot Args for macOS

Enables single-user mode.

󰅖 Boots macOS with a minimal set of system

Enables cacheless booting.

This disables macOS's watchdog which helps prevents a

This is a companion setting to debug=0x100 that

Enables Rootless Mode

cpus=1 Enables Single CPU Core Mode.

Allows loading of unsigned kexts

- To avoid firmware load endless loop

Disables PCI debugging related to

Required for all HEDT and a few 500 and 600

Enables loading of NVIDIA Drivers

Disables loading of NVIDIA Drivers.

-liludbg Enables debug printing. Requires DEBUG version of Lilu.

Disables Lilu user patcher (for e.g. dyld_shared_cache

-liluslow Enables legacy user patcher.

-lilulowmem Disables kernel unpack (disables Lilu in recovery mode).

Enables Lilu on unsupported macOS versions (macOS 13 and

Enables Lilu and all loaded plugins on unsupported os

Enables Lilu regardless of the mode, OS, installer, or

Adds 1 second (100ms) delay after each print for

Spoofs CPU Generation.

Enables debug printing.

Disables all the Lilu enhancements.

Enables VirtualSMC on unsupported macOS versions

-vsmcrpt Reports missing SMC keys to the system log.

-vsmccomp Prefer existing hardware SMC implementation if found.

Forces exposing X-gen SMC device (1 and 2 are

Sets HBKP dumping mode (0 - off, 1 - normal, 2 - without

Set value serialisation level (0 - off, 1 - normal, 2 - with

smcdebug=0xff Enables AppleSMC debug information printing.

Disables WatchDog timer.

Enables WhateverGreen on unsupported macOS versions

Enables CoreDisplayFixup functionality via

wegtree=1 Forces device renaming on Apple FW.

Prefers drawing Apple logo at 2nd boot stage instead of

Disables framebuffer init interaction during 2nd boot

Boot Args Purpose

Fixes black screen when macOS finishes loading.

agdpmod=ignore Disables AGDP patches

Disables all external GPUs (NVIDIA and AMD). Mainly

-wegnoigpu Disables internal GPU

-ngfxdbg Enables NVIDIA driver error logging

ngfxgl=1 Disables metal support on NVIDIA GPUs

ngfxcompat=1 Ignores compatibility check in NVDAStartupWeb

ngfxsubmit=0 Disables interface stuttering fix on 10.13

-radvesa Disables ATI/AMD graphics acceleration.

-rad24 Enforces 24-bit display mode

Enables DVI transmitter correction

- Forces the spoofed PID to be used in

Fixes initialization for Radeon HD 7730/7750/7770/R7

Injects a dedicated framebuffer identifier into

Disables IntelAccelerator name fix for Sandy

igfxgl=1 Disables Metal support on IGPU.

to force enable Metal support on Intel for offline

igfxpavp=1 to force enable PAVP output

Forces loading of Apple GuC firmware

-igfxvesa Disables IGPU acceleration.