Jump to content

Available boot-args for darwin / OS X

1 post in this topic

Recommended Posts


Research before you apply!


Assorted boot arguments found on the web.


Available boot-args for darwin / OS X


In OS X you can set boot parameters with

nvram boot-args=[options]


General boot options:

    -v: Always boot the system in Verbose mode without needing to hold CMD-V at startup.
    -x: Always boot system into Safe Mode without needing to hold Shift at startup.
    f: Old Safe Mode.
    -s: Boot the system into Single User mode without needing to hold CMD-S at startup.
    -F - Ignore Boot File.

    iog (e.g. iog=0x0)

        This reverses the "Clamshell" mode for Apple's laptop systems, where when you close the display but connect the system to an external monitor and keyboard the system will stay awake. After running this command, when connecting an external monitor, the internal display will be disabled, which can be beneficial in some situations such as those where you are mirroring your desktop but wish to run the external display at a higher resolution than your laptop can run.



Changes how the system boots, either to the 32-bit (i386) or 64-bit (x86_64) kernel. Note that third-party kernel extensions might be 32-bit or 64-bit only.


Graphics Mode: VESA Graphics Mode Dimensions.
Text Mode: VGA Text Mode Dimensions.
Boot Graphics: Graphics or Text Mode.
Quiet Boot: Quiet Bootmode.
MKext Cache: Mkext cache file.
Kernel Cache: Kernel Cache file.
rd: Root Device.
boot-uuid: Boot UUID.
platform: Platform Expert {ACPI}.


config: Load alternate config plist (e.g. config=foobar will load /Library/Preferences/SystemConfiguration/foobar.plist instead of com.apple.Boot.plist)x86osx.



On OS X El Capitan 10.11 and later, this enables the performance mode to dedicate additional system resources for server applications.



dtrace_dof_mode: Set DTrace DOF modes {0/1/2/3}.
DisableFBT: Disable FBT {1}.
IgnoreFBTBlacklist: Ignore blacklist of certain critical modules {1}.



-b: Don't run /etc/rc.boot.
-l: Memory leaks logging (osfmk/kern/startup.c).
srv: Boot as server {1}.
ncl: Number of clusters.
nbuf: Number of buffers for BSD.
kmem: Kernel memory access {1}.
trace: Kernel trace buffer size.
msgbuf: Message Buffer.
rp: Root path.
mcache_flags: Memory cache flags.
mbuf_debug: MBuf Debug {1}.
initmcl: Init mbuf clusters.
socket_debug: Socket debug (net).
net_affinity: Net Affinity (net).
rte_debug: Route debug (net) {flags}.
-rwroot_hack: Mount root read/write.



mseg: Max segment.
dart: Remove mapper present.
io: IO Kit Debug.



keepsyms: Do not unload KLD/Address-symbol translation {1}.


debug: Kernel debug {flags} (e.g. debug=0x14e).

    Enables kernel debugging features that will show you extra information. E.g.
        0x01 - Stop at boot time and wait for the debugger to attach
        0x02 - Send kernel debugging output to the console
        0x04 - Drop into debugger on a nonmaskable interrupt
        0x08 - Send kernel debugging information to a serial port
        0x10 - Make ddb the default debugger
        0x20 - Output diagnostics information to the system log
        0x40 - Allow the debugger to ARP and route
        0x80 - Support old versions of gdb on newer systems
        0x100 - Disable the graphical panic dialog screen


nvram_paniclog: commit paniclog to NVRAM {1}.
pmsafe_debug: Put CPUs into "safe" power mode {1}.
preempt: Set default preemption rate.
unsafe: Max unsafe quanta.
poll: Max poll quanta.
yield: Schedule poll yield shift.
idlehalt: Halt idle thread to allow cpu into lowpower mode {1}.
panic_io_port: In a panic read from this I/O port {0x0 to 0xffff}.
_fpu: Limit boot-time cpu features {387/mmx/sse}.
disable high mem/2: prefer high mem}.
immediate_NMI: Force immediate NMI debugger {1}.
-legacy: Force legacy 32bit mode.
lcks: Lock statistics.
novmx: No altivec emulation in Rosetta {1}.
max_valid_dma_addr: Max valid DMA address.
maxbouncepool: Max bounce pool size.
maxloreserve: Max low reserve.
npvhash: Physical to virtual mapping hash.
wpkernel: Write protect kernel {1}.
-no_shared_cr3: Disable shared kernel address space for 64 bit users.
-pmap_trace: Enable kernel traces for pmap.
_panicd_ip: IP of panic server.
_router_ip: IP of router.
panicd_port: Port of panic server.
-zc: Free zone element checking.
mtxspin: Mutex spin (ppc).
vmmforce: VMM force (ppc).
fn: Force nap (ppc) (acpi) {0/1/2}.
pmsx: Experimental power management stepper mode (ppc) {1}.
ctrc: Set tracing to specific cpu (ppc).
tb: Non-default trace buffer size (ppc).
wcte: Write combine timer enable (ppc).
mcklog: Clear machine check flag (ppc).
mcksoft: Machine check software recovery (ppc).
ht_shift: Non-default hash table size (ppc) {1}.
zsize: Target zone size.
colors: Set VM colors.
fill: Fill pages.
serialbaud: Set serial baud rate.


Boot options from xnu/osfmk/i386/i386_init.c:

diag: Diagnostic output.

serial: Serial diagnostic console. Support for a serial keyboard and/or console.



Maximum memory to use. It limits the addressable memory to the specified amount (e.g. maxmem=32).



Limits the number of active processors in the system to the set level. This might help preserve power, not likely useful for much else unless you are testing and programming.



It is used to debug large physical memory configurations for over 4GB systems. Modes: 0 - all pages available, 1 - disable high mem, 2 - prefer high mem.



Debug support for over 4GB systems by forcing immediate NMI debugger.





bluetoothHostControllerSwitchBehavior (never/always)

Tell Bluetooth driver whether to switch to the dongle that you plugged in. To make the external dongle the default even after reboot, use always.


smbios: Verbose SMBIOS (AppleSMBIOS.kext) {1}
acpi: Debug AppleACPIPlatform {1-8}
acpi_level: ACPI Debug Level
acpi_layer: ACPI Debug Layer
acpi_sleep: ACPI Sleep
nvdebug: NVDAResman debug
nvrm: NVDAResman
ndrv_debug_level: NDRV Debug Level (NVDAResman)
pstep: Power Step Debug (ACPI_SMC)
hpet: AppleHPET
busratio (e.g. busratio=20): It used i7 cpu in 10.5.6, after 10.5.7 it does not needx86osx.


Source: xnu-1228 / Boot Arguments

For example when you're in Single Mode (CMD-S after the sound at startup), to run into safe mode and verbosely with extra kernel debugging output to the console, try:

sudo nvram boot-args="-x -v debug=0x14e"

To add the argument into existing (without overriding), try:

sudo nvram boot-args="-v $(nvram boot-args 2>/dev/null | cut -f 2-)"

To remove boot arguments, run:

sudo nvram boot-args=""
sudo nvram -d boot-args


Other non-official parameters can be found in kernel binary it-self, e.g.

$ strings /System/Library/Kernels/kernel | grep -C7 maxmem
Serial mode specified: %08X
version_variant = %s
version         = %s
himemory_mode: %d


check either in Apple source files or on GitHub by searching for PE_parse_boot_argn (which is used to parse the kernel boot arguments).


Googling for boot-args site:developer.apple.com gives some good resources. E.g.

    cpus=1 forces the system to only use a single CPU core.
    srv=1 is set on Xserves and machines that have Mac OS X Server installed, and supposedly changes some kernel tuning parameters for server-friendly operation.
    _panicd_ip=a.b.c.d Lets you specify the IP address of a panic debug server to write kernel core dumps to.

    debug=0xH (Where H is a 1-4 digit hexadecimal number) Lets you set kernel debugging flags from this list:

    DB_HALT   0x01 Halt at boot-time and wait for debugger attach (gdb).  
    DB_PRT    0x02 Send kernel debugging printf output to console.  
    DB_NMI    0x04 Drop into debugger on NMI (Command–Power, Command-Option-Control-Shift-Escape, or interrupt switch).  
    DB_KPRT   0x08 Send kernel debugging kprintf output to serial port.  
    DB_KDB    0x10 Make ddb (kdb) the default debugger (requires a custom kernel).  
    DB_SLOG   0x20 Output certain diagnostic info to the system log.  
    DB_ARP    0x40 Allow debugger to ARP and route (allows debugging across routers and removes the need for a permanent ARP entry, but is a potential security hole)—not available in all kernels.  
    DB_KDP_BP_DIS  0x80 Support old versions of gdb on newer systems.  
    DB_LOG_PI_SCRN 0x100 Disable graphical panic dialog.  
    DB_KERN_DUMP_ON_PANIC   0x0400  Causes the kernel to core dump when the system panics.  
    DB_KERN_DUMP_ON_NMI 0x0800  Causes the kernel to core dump when the user triggers an NMI.  
    DB_DBG_POST_CORE    0x1000  Controls the kernel's behavior after dumping core in response to an NMI (DB_KERN_DUMP_ON_NMI). If the user triggers an NMI and this flag is clear, the kernel will dump core and then continue. Conversely, if this flag is set the kernel will dump core and then wait for a debugger connection.  
    DB_PANICLOG_DUMP    0x2000  Controls whether the kernel dumps a full core (if the flag is clear) or simply a panic log (if the flag is set).  


Here are some more:

-f                            Force rebuild extensions cache
-v                            Verbose booting shows debug information
-s                            Boots into single user mode (means only terminal based mode)
-x                            Boots into safe mode
-legacy                       Boots into 32bit instead of 64bit mode
rd=disk0s1                    Force to boot a specific partition on a specific drive (BSD drive notation, means disk0 = physical disk 1). Here disk1 partition 1 is forced to be booted.
Graphics Mode=1024x768x32@75  Forces to boot with a resolution of 1024 x 768 with 32bit colors at 75Hz
Kernel=mach_kernel            Forces to load a specific kernel, helpful for testing of new kernels.
cpus=1                        Force using only 1 CPU core, may help addressing issues
idlehalt=0                    May solve stuttering and shuttering on dualcore CPUs
platform=X86PC                Forces to not use powermanagement (disables ACPI)
platform=ACPI                 Forces to use powermanagement (enables ACPI, but may crash your system)


You could also search for PE_parse_boot_arg, a function that, well, parses boot arguments.


  • Create New...