displaysleep - display sleep timer; replaces 'dim' argument in 10.4 (value in minutes, or 0 to disable)
disksleep - disk spindown timer; replaces 'spindown' argument in 10.4 (value in minutes, or 0 to disable)
sleep - system sleep timer (value in minutes, or 0 to disable)
womp - wake on ethernet magic packet (value = 0/1). Same as "Wake for network access" in the Energy Saver preferences.
ring - wake on modem ring (value = 0/1)
powernap - enable/disable Power Nap on supported machines (value = 0/1)
autorestart - automatic restart on power loss (value = 0/1)
lidwake - wake the machine when the laptop lid (or clamshell) is opened (value = 0/1)
acwake - wake the machine when power source (AC/battery) is changed (value = 0/1)
lessbright - slightly turn down display brightness when switching to this power source (value = 0/1)
halfdim - display sleep will use an intermediate half-brightness state between full brightness and fully off (value =
sms - use Sudden Motion Sensor to park disk heads on sudden changes in G force (value = 0/1)
hibernatemode - change hibernation mode. Please use caution. (value = integer)
hibernatefile - change hibernation image file location. Image may only be located on the root volume. Please use caution.
(value = path)
ttyskeepawake - prevent idle system sleep when any tty (e.g. remote login session) is 'active'. A tty is 'inactive' only
when its idle time exceeds the system sleep timer. (value = 0/1)
networkoversleep - this setting affects how OS X networking presents shared network services during system sleep. This
setting is not used by all platforms; changing its value is unsupported.
destroyfvkeyonstandby - Destroy File Vault Key when going to standby mode. By default File vault keys are retained even
when system goes to standby. If the keys are destroyed, user will be prompted to enter the password while coming out of
standby mode.(value: 1 - Destroy, 0 - Retain)
-g (with no argument) will display the settings currently in use.
-g live displays the settings currently in use.
-g custom displays custom settings for all power sources.
-g cap displays which power management features the machine supports.
-g sched displays scheduled startup/wake and shutdown/sleep events.
-g ups displays UPS emergency thresholds.
-g ps / batt displays status of batteries and UPSs.
-g pslog displays an ongoing log of power source (battery and UPS) state.
-g rawlog displays an ongoing log of battery state as read directly from battery.
-g therm shows thermal conditions that affect CPU speed. Not available on all platforms.
-g thermlog shows a log of thermal notifications that affect CPU speed. Not available on all platforms.
-g assertions displays a summary of power assertions. Assertions may prevent system sleep or display sleep. Available
10.6 and later.
-g assertionslog shows a log of assertion creations and releases. Available 10.6 and later.
-g sysload displays the "system load advisory" - a summary of system activity available from the IOGetSystemLoadAdvisory
API. Available 10.6 and later.
-g sysloadlog displays an ongoing log of lives changes to the system load advisory. Available 10.6 and later.
-g ac / adapter will display details about an attached AC power adapter. Only supported for MacBook and MacBook Pro.
-g log displays a history of sleeps, wakes, and other power management events. This log is for admin & debugging pur-
-g uuid displays the currently active sleep/wake UUID; used within OS X to correlate sleep/wake activity within one sleep
-g uuidlog displays the currently active sleep/wake UUID, and prints a new UUID as they're set by the system.
-g history is a debugging tool. Prints a timeline of system sleeplwake UUIDs, when enabled with boot-arg io=0x3000000.
-g historydetailed Prints driver-level timings for a sleep/wake. Pass a UUID as an argument.
-g powerstate [class names] Prints the current power states for I/O Kit drivers. Caller may provide one or more I/O Kit
class names (separated by spaces) as an argument. If no classes are provided, it will print all drivers' power states.
-g powerstatelog [-i interval] [class names] Periodically prints the power state residency times for some drivers. Caller
may provide one or more I/O Kit class names (separated by spaces). If no classes are provided, it will log the IOPower
plane's root registry entry. Caller may specify a polling interval, in seconds with -i ; otherwise it
defaults to 5 seconds.
-g stats Prints the counts for number sleeps and wakes system has gone thru since boot.
-g systemstate Prints the current power state of the system and available capabilites.
-g everything Prints output from every argument under the GETTING header. This is useful for quickly collecting all the
output that pmset provides. Available in 10.8.
SAFE SLEEP ARGUMENTS
hibernatemode supports values of 0, 3, or 25. Whether or not a hibernation image gets written is also dependent on the
values of standby and autopoweroff
For example, on desktops that support standby a hibernation image will be written after the specified standbydelay time.
To disable hibernation images completely, ensure hibernatemode standby and autopoweroff are all set to 0.
hibernatemode = 0 by default on desktops. The system will not back memory up to persistent storage. The system must wake
from the contents of memory; the system will lose context on power loss. This is, historically, plain old sleep.
hibernatemode = 3 by default on portables. The system will store a copy of memory to persistent storage (the disk), and
will power memory during sleep. The system will wake from memory, unless a power loss forces it to restore from hibernate
hibernatemode = 25 is only settable via pmset. The system will store a copy of memory to persistent storage (the disk),
and will remove power to memory. The system will restore from disk image. If you want "hibernation" - slower sleeps,
slower wakes, and better battery life, you should use this setting.
Please note that hibernatefile may only point to a file located on the root volume.
standby causes kernel power management to automatically hibernate a machine after it has slept for a specified time
period. This saves power while asleep. This setting defaults to ON for supported hardware. The setting standby will be
visible in pmset -g if the feature is supported on this machine.
standbydelay specifies the delay, in seconds, before writing the hibernation image to disk and powering off memory for
autopoweroff is enabled by default on supported platforms as an implementation of Lot 6 to the European Energy-related
Products Directive. After sleeping for seconds, the system will write a hibernation image and go into
a lower power chipset sleep. Wakeups from this state will take longer than wakeups from regular sleep.
autopoweroffdelay specifies the delay, in seconds, before entering autopoweroff mode.
UPS SPECIFIC ARGUMENTS
UPS-specific arguments are only valid following the -u option. UPS settings also have an on/off value. Use a -1 argument
instead of percent or minutes to turn any of these settings off. If multiple halt conditions are specified, the system
will halt on the first condition that occurs in a low power situation.
haltlevel - when draining UPS battery, battery level at which to trigger an emergency shutdown (value in %)
haltafter - when draining UPS battery, trigger emergency shutdown after this long running on UPS power (value in minutes,
or 0 to disable)
haltremain - when draining UPS battery, trigger emergency shutdown when this much time remaining on UPS power is esti-
mated (value in minutes, or 0 to disable)
Note: None of these settings are observed on a system with support for an internal battery, such as a laptop. UPS emer-
gency shutdown settings are for desktop and server only.
SCHEDULED EVENT ARGUMENTS
pmset allows you to schedule system sleep, shutdown, wakeup and/or power on. "schedule" is for setting up one-time power
events, and "repeat" is for setting up daily/weekly power on and power off events. Note that you may only have one pair
of repeating events scheduled - a "power on" event and a "power off" event. For sleep cycling applications, pmset can
schedule a "relative" wakeup or poweron to occur in seconds from the end of system sleep/shutdown, but this event cannot
be cancelled and is inherently imprecise.
type - one of sleep, wake, poweron, shutdown, wakeorpoweron
date/time - "MM/dd/yy HH:mm:ss" (in 24 hour format; must be in quotes)
time - HH:mm:ss
weekdays - a subset of MTWRFSU ("M" and "MTWRF" are valid strings)
owner - a string describing the person or program who is scheduling this one-time power event (optional)
POWER SOURCE ARGUMENTS
-g with a 'batt' or 'ps' argument will show the state of all attached power sources.
-g with a 'pslog' or 'rawlog' argument is normally used for debugging, such as isolating a problem with an aging battery.
boot - tell the kernel that system boot is complete (normally LoginWindow does this). May be useful to Darwin users.
touch - PM re-reads existing settings from disk.
noidle - pmset prevents idle sleep by creating a PM assertion to prevent idle sleep(while running; hit ctrl-c to cancel).
This argument is deprecated in favor of caffeinate(8). Please use caffeinate(8) instead.
sleepnow - causes an immediate system sleep.
restoredefaults - Restores Energy Saver settings to their default values. (Like clicking "Restore Defaults" in Energy
displaysleepnow - causes display to go to sleep immediately.
resetdisplayambientparams - resets the ambient light parameters for certain Apple displays.
dim - deprecated in 10.4 in favor of 'displaysleep'. 'dim' will continue to work.
spindown - deprecated in 10.4 in favor of 'disksleep'. 'spindown' will continue to work.