Menu
In computing, pmset is a command line utility to manipulate power management settings under the Darwin and macOSoperating systems. It can assign sleep settings, schedule sleep and wake times, and display power information.
See fsusage in Minimize I/O or refer to the fsusage(1) Mac OS X Manual Page. Adjust system-wide power management settings, such as idle sleep timing, automatic restart on power loss, and more. It can also be used to put the device to sleep, and to determine whether any power assertions are in place. See pmset(1) Mac OS X Manual Page. In standby mode, the RAM is powered off. On these machines it only takes a few extra seconds to come out of hibernate compared to coming out of sleep. You can also run pmset -g to see whether standby is set and how long standbydelay is. If you don't see standby, your hardware doesn't support this feature. Sudo pmset -a standbydelay 1200 Change 1200 to the number of seconds you want it to wait in sleep mode before going to hibernate mode. If you need to set you laptop in sleep mode and turn on the standby mode (They should be on, as those are the default), enter these commands.
- 2Behavior
- See fsusage in Minimize I/O or refer to the fsusage(1) Mac OS X Manual Page. Adjust system-wide power management settings, such as idle sleep timing, automatic restart on power loss, and more. It can also be used to put the device to sleep, and to determine whether any power assertions are in place. See pmset(1) Mac OS X Manual Page.
- An A-Z Index of the Apple OS X command line (TERMINAL) The tcsh command shell of Darwin (the open source core of OSX) alias Create an alias alloc List used and free memory awk Find and Replace text within file(s) basename Convert a full pathname to just a folder path bash Bourne-Again SHell (Linux) bless Set volume bootability and startup disk.
History[edit]
The pmset utility first appeared in Darwin 6.0.1 and Mac OS X 10.2 'Jaguar'. It has been updated periodically since its introduction, and is still available as of Darwin 17.0 and macOS 10.13 'High Sierra'.
Behavior[edit]
The utility sets or lists power management settings. Some of the functionality provided by the utility is available through the GUI interface of the Energy Saver preference pane. However, pmset allows for greater flexibility and access to several options not available in the GUI.
The utility can set different power management settings depending on usage scenario. Different settings can be applied for when the machine is running off a charger, battery, UPS, or all three. The appropriate flags are as follows:
- -c (charger), adjust settings used while connected to a charger
- -b (battery), adjust settings used when running off a battery
- -u (UPS), adjust settings used when running off a UPS
- -a (all, default) adjust settings for all scenarios
Additional arguments be supplied when assigning any power management settings. Power management arguments are discussed in greater detail below. When invoking the command, only specified arguments modify power management options. Any arguments already set will be unmodified by pmset unless those arguments are specifically included.
The utility can schedule wake, sleep, power on or power off events. Events can be recurring based on arbitrary weekday and time combinations, or scheduled for future dates and times. The syntax for scheduling an event is as follows:
- pmset [repeat, schedule] [sleep, wake, poweron, shutdown, wakeorpoweron] [<MTWRFSU> <date/time>]
Previously stored events will be overwritten upon running this command. To schedule multiple events they must be entered in one command string. For example, to set a shutdown event every day of the week at 23:59 and a wake or power on event every day of the week at 7:00 enter the following:
- sudo pmset repeat shutdown MTWRFSU 23:59:00 wakeorpoweron MTWRFSU 7:00:00
The get flag displays information about the current power management configuration, or a log of recent activity. If no additional arguments are supplied the flag will only display current settings. Additional get arguments are discussed in greater detail below. The get flag is as follows:
- -g get, list current power management settings
To view the currently scheduled events type:
- pmset -g sched
The utility is also able to configure hibernation and safe sleep options, and change Energy Saver profiles.
Power management settings[edit]
The pmset utility recognizes the following arguments. Arguments can be passed in serial form in any order. Any bad syntax or unrecognized argument will cause the entire command to fail, resulting in an error message and brief help screen. Power management settings can only be changed by a privileged user.
- displaysleep – display sleep timer in minutes, 0 to disable display sleep
- disksleep – disk spin-down timer in minutes, 0 to disable disk sleep
- sleep – system sleep timer in minutes, 0 to disable sleep
- womp wake on 'magic' Ethernet packet, 1 to enable or 0 to disable
- hibernatemode change hibernation mode, 0 for RAM powered while sleeping; 1 for RAM contents written to disk and system totally unpowered; 3 for RAM both powered and written to disk; 5 is the same as mode 1, but for use with secure virtual memory; 7 is the same as mode 3, but for use with secure virtual memory; 25 for hibernation in Mac OS X 10.7, with RAM contents written to disk and system totally unpowered
- hibernatefile change hibernation image file location; image may only be located on the root volume
- ring wake on modem ring, 1 to enable or 0 to disable
- autorestart automatic restart after loss of power, 1 to enable or 0 to disable
- dps dynamically change processor speed based on load, 1 to enable or 0 to disable
- reduce permanently reduce processor speed, 1 to enable or 0 to disable
- powerbutton put the machine to sleep when the power button pressed instead of shutting it down, 1 to enable or 0 to disable
- lidwake (laptop only) wake the machine when the laptop lid is opened, 1 to enable or 0 to disable
- acwake (laptop only) wake the machine when the power source is changed, such as when AC power is removed and the machine switches to battery power, 1 to enable or 0 to disable
- lessbright (laptop only) slightly turn down display brightness when switching to a specified power source, 1 to enable or 0 to disable
- halfdim display sleep will use an intermediate half-brightness state between full brightness and fully off, 1 to enable or 0 to disable
- sms (supported laptops only) use Sudden Motion Sensor to park disk heads on sudden changes in G force, 1 to enable or 0 to disable
- haltlevel (UPS only) UPS charge in percentage, shut down the machine when UPS reaches a specified charge level
- haltafter (UPS only) UPS charge in minutes, shut down machine after drawing on UPS for specified number of minutes
- haltremain (UPS only) UPS charge in minutes, shut down machine when specified time remains on UPS
- ttyskeepawake prevent idle system sleep when any tty (such as a remote login session) is active; a tty is inactive only when its idle time exceeds the system sleep timer, 1 to enable or 0 to disable
- autopoweroff (AC power) Where supported, enabled per default as an implementation of Lot 6 to the European Energy-related Products Directive. After sleeping for autopoweroffdelay minutes, 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. The system will not auto power off if any external devices are connected, if the system is on battery power, or if the system is bound to a network and wake for network access is enabled.
- autopoweroffdelay (AC power) delay before entering autopoweroff mode. (Value = integer, in seconds)
- networkoversleep This setting affects how macOS 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). Since it is essential that the system fully powered down, you also need to set `hibernatemode` to 25 (suspend to disk).
Settings may be adjusted independently for circumstances where the machine is attached to a charger, when running off a battery (in the case of a laptop), or when running off a UPS (if available). Settings can also be adjusted for all four scenarios simultaneously; this is the default option, for when no usage flag is specified. Power management options can be specified for different profiles by appending -c (charger), -b (battery), -u (UPS) or -a (all) flags. The following example will set the machine to sleep after 10 minutes and sleep the display after five minutes, but only when powered by the battery.
- pmset -b sleep 10 displaysleep 5
The following command will assign slightly different power management settings for circumstances where the machine is powered by the charger. Here, the machine is set to sleep after 30 minutes and the display is set to never sleep, but only when set by the charger. Issuing both commands will not interfere with each other.
- pmset -c sleep 30 displaysleep 0
Arguments can be entered in serial form to set or modify several power management parameters with one command. The following command will set the machine to never sleep (sleep 0), enable the Sudden Motion Sensor (sms 1), set the display to sleep after 20 minutes (displaysleep 20), disable processor speed reduction (reduce 0), enable intermediate display dimness (halfdim 1), enable the machine to wake when the lid is opened (lidwake 1), prevent the system from sleeping when a tty session (such as SSH) is active (ttyskeepawake 1), disable waking the machine when the AC adapter is inserted (acwake 0), disable an automatic restart after power is removed and restored (autorestart 0), enable dynamic change of processor speed based on system load (dps 1), enable wake on modem ring (ring 1), enable wake on receipt of 'magic' Ethernet packet (womp 1), and disable hard disk sleep (disksleep 0):
- pmset sleep 0 sms 1 displaysleep 20 reduce 0 halfdim 1 lidwake 1 ttyskeepawake 1 acwake 0 autorestart 0 dps 1 ring 1 womp 1 disksleep 0
Because the above example did not include a usage flag, the settings specified will apply to all usage scenarios. Subsequent commands that do specify a usage flag will only affect settings for that usage scenario. For instance, pmset -b sleep 10 will cause the machine to sleep after 10 minutes, but only when the battery is attached. All other settings will apply when the battery is attached, and all settings in the above example will apply when a charger or UPS is attached.
At least as of Darwin 9.4 and OS X 10.5.4 'Leopard', all changes made through pmset are saved in a persistent preferences file at /Library/Preferences/SystemConfiguration/com.apple.PowerManagement.plist. This file can be modified manually using the defaults command, but those changes will not be taken up immediately by the power management system. Manual edits of com.apple.PowerManagement.plist also stand the risk of being overwritten. The command pmset touch will reread existing settings from disk and apply them to the system.
With autopoweroff enabled the machine will got into hibernate mode even if hibernatemode is 0. The value of autopoweroffdelay may be in seconds despite the man page (for Mavericks, Nov 9, 2012) documenting it as minutes.
Schedule Settings[edit]
The pmset command is able to schedule system sleep, shutdown, wakeup or power on events. The schedule argument is for setting up one-time power events, and repeat is for setting up daily or weekly events. Scheduling of events can only be done by a privileged user.
The schedule argument recognizes the following additional arguments:
- type; one of sleep, wake, poweron, shutdown or wakeorpoweron
- date and time (schedule only); in the format 'MM/dd/yy HH:mm:ss'; must be in 24-hour format, must be in quotes
- time (repeat only); in the format HH:mm:ss; must be in 24 format, but does not have to be in quotes
- weekdays; a subset of MTWRFSU such as M or MTWRF are valid, as are strings weekdays, weekends, and everyday
- owner; a string describing the person or program who is scheduling the power event (optional)
The utility can be very unforgiving of improper syntax. Any errors in syntax will cause the command to fail and will display a brief help message. The syntax for a scheduled event is as follows:
- pmset schedule [sleep, wake, poweron, shutdown, wakeorpoweron] 'MM/dd/yy HH:mm:ss'
Only one type of event (sleep, wake, et cetera) can be specified, and the date chosen must be in the future. The utility expects to be able to store this information in the PMU, and so may not work reliably on non-Apple hardware. The date and time string must be enclosed in quotation marks.
The syntax for a repeating event is as follows:
- pmset repeat [sleep, wake, poweron, shutdown, wakeorpoweron] [MTWRFSU, weekdays, weekends, everyday] HH:mm:ss
Scheduled wake, sleep and power events are stored in a persistent preferences file in /Library/Preferences/SystemConfiguration/com.apple.AutoWake.plist. This file can be manually edited using the defaults command, but any changes so made stand a serious risk of being overwritten. Also, such edits will not be immediately taken up by the system.
List Options[edit]
The list flag, -g, displays information about the current power configuration. The flag alone, with no additional arguments, will display current power management settings. Additional arguments will display more specific information. The get functions of pmset do not require privileged access. The utility recognizes the following arguments:
- live like the default option, displays the settings currently in use
- custom will display custom settings for all power sources, although these settings may not currently be in use
- cap capabilities, display which power management features the machine supports
- sched schedule, display scheduled startup, wake, shutdown and sleep events
- ups will display UPS emergency thresholds
- ps power source, display status of connected batteries and UPSs
- pslog display an ongoing log of power source state
- rawlog display an ongoing log of power source state as read directly from battery
- profiles
Only one get argument can be passed to pmset, and it must be preceded by the get flag. For instance, to display scheduled events, type pmset -g sched. The utility will not return an error if more than one get argument is provided, but all other than the first will be ignored.
The sleep and displaysleep can show an imposed value of 0 (disabled) together with a list of process IDs that impose this value. These are processes such as backup programs which need the machine to stay awake, for example until the backup is finished.
Sample usage[edit]
The following examples demonstrate the output of the pmset command on an Apple PowerBook G4 running Mac OS X 10.5.4 'Leopard'.
. 33000 lumens – excellent light quality with a flat and uniform field. Mac viper wash dx manual. 1:5 zoom - 13.5 to 59° continuous and fast zoom. The fixture has adopted the compact form, impressive speed, superior light quality and beautiful colors that the MAC Viper Profile is renowned for and uses the same 1000-watt lamp.
The following example will put the relevant computer to sleep immediately:
The following example will apply only to laptops when powered by the battery. It will set the machine to sleep after 5 minutes of inactivity, put the display to sleep after 2 minutes, and spin down the hard disk after 3 minutes. Only privileged users can issue this command. If the command is issued successfully and is without syntax errors, pmset will exit silently with an exit code of 0. To verify that the system took the new configuration, issue the command pmset -g.
The following example will apply only to machines being powered by a UPS. It will set the machine to perform an emergency shutdown when 5 percent battery remains on the UPS, or 5 minutes estimated draw time remains, whichever comes first. Only privileged users can issue this command. If the command is issued successfully and is without syntax errors, pmset will exit silently with an exit code of 0. To verify that the system took the new configuration, issue the command pmset -g.
The following example will apply for all usage scenarios. It will set the machine to wake on receipt of a 'magic' Ethernet packet, wake if the modem detects a ring, and prevent the system from sleeping if a tty session is active. Only privileged users can issue this command. If the command is issued successfully and is without syntax errors, pmset will exit silently with an exit code of 0. To verify that the system took the new configuration, issue the command pmset -g.
The following example sets a one-time scheduled power event. The machine will be set to shut down 01/10/2009 at 10:00 PM (10 January 2009 – Note the US centric MM/DD/YYY time syntax). Only privileged users can issue this command. If the command is issued successfully and is without syntax errors, pmset will exit silently with an exit code of 0. To verify that the system took the new configuration, issue the command pmset -g sched.
The following example sets a repeating power event. The machine will wake or power on every weekday at 8:00 AM. Only privileged users can issue this command. If the command is issued successfully and is without syntax errors, pmset will exit silently with an exit code of 0. To verify that the system took the new configuration, issue the command pmset -g sched.
Here, example output from pmset -g. At the time, the machine was being powered by the charger, while simultaneously charging the battery. The command prints the current configuration.
Mac Pmset Manual Software
Here, example output from pmset -g sched. In this example, the machine has already been configured for a repeating event to start or wake up every weekday at 8:00 AM. The command prints the repeating event; note that the next such occurrence appears as a scheduled power event.
Here, example output from pmset -g. At the time, the machine was being backed up. The output shows the PID for the backup program.
See also[edit]
References[edit]
- pmset(1) manual page at Apple Developer Connection
- Power Management and Scheduling via Command Line at uMac, University of Utah
External links[edit]
- pmset source code at Apple Developer Connection)
Retrieved from 'https://en.wikipedia.org/w/index.php?title=Pmset&oldid=861500047'
Active1 year, 7 months ago
I recently got my first Mac computer, a late 2009 Macbook Pro model. I used to put my previous notebook (running windows 7) to hibernate directly in order to save battery but I can't do the same in Mac Os.
From what I can tell Mac Os only hibernate a notebook when battery dies after a long sleeping period.
Is that a way to manually put a Macbook to hibernate?
squircle5,85555 gold badges3131 silver badges5959 bronze badges
holiveiraholiveira58633 gold badges88 silver badges1515 bronze badges
4 Answers
When a MacBook hibernates, it isn't actually hibernation in the Windows sense. Apple calls it Safe Sleep. The restoration from Safe Sleep isn't meant to be a regularly-occurring event; it's there for emergencies only. From my experience, my Late 2007 MacBook Pro uses such a miniscule amount of power while sleeping (normally) that I have left it sleeping for weeks (while on vacation), opened it up and still had a significant amount of batter power remaining. I'm sure with the new 7+ hour batteries, you could leave it sleeping for months.
To put it quite simply, there's no easy way to save the system state on OS X, besides sleeping the computer and popping the ba-.. oh, wait, no more removable batteries.
If you're really adamant about getting this functionality, you can try the Deep Sleep widget. Best of luck to you.
squirclesquircle5,85555 gold badges3131 silver badges5959 bronze badges
Switching the hibernation mode to 25 will make make a MacBook hibernate instead of sleep (see discussion below as to whether it's a good idea).
To revert it back to the default for MacBooks do (which powers the ram and writes image to disk)
If you want to sleep/hibernate your machine from the command line do
Is it a good idea to hibernate your MacBook?
If your machine supports
standby
mode, then there isn't much point in changing the hibernate mode, because by default it is in standby after 1.15hrs. In standby mode, the RAM is powered off. On these machines it only takes a few extra seconds to come out of hibernate compared to coming out of sleep. However, standby isn't exactly the same as hibernate, for more details see http://support.apple.com/kb/HT4392You can also run
pmset -g
to see whether standby
is set and how long standbydelay
is. If you don't see standby
, your hardware doesn't support this feature.If your hardware doesn't support the standby feature, then hibernation is an (as mentioned in older posts) 'emergency' state, so it's probably best to leave this setting as is. That being said, I hibernate my MacBook before I go away and haven't run into any problems.'
Lots more discussion here Does Mac OS X support hibernation?
Mac Pmset Manual Free
Community♦
Peter RigbyPeter Rigby
There's also a preference pane app called SmartSleep (http://www.jinx.de/SmartSleep.html): you have to pay for the current version, but you can find older versions around the Internet.
Also I've used this tutorial, I copied pasted the contents, and have some notes in the bottom:http://www.geeked.info/make-my-macbook-pro-hibernate/
I don’t like to waste battery life, especially when traveling. I love the Hibernate feature in Windows, and have all of my laptops set to hibernate when the lid is closed. The few extra seconds it takes to wake up is worth the saved battery life in my eyes. For those that don’t know here are the different states of the MacBook Pro:
- On – Computer is awake, screen is on, battery is being consumed based on your power settings
- Off – Computer is using no power from the battery
- Sleep – Computer has turned off the screen and has suspended the operating system to RAM (volatile memory).
- Hibernation – Computer has turned off most hardware and has suspended the operating system to the hard drive.
Usually when you close the lid of your MBP, it will be put to sleep, waking quite quickly when you open the lid again. While sleeping, it’s still consuming battery power, albeit a small amount compared to normal usage. When the battery reaches a certain low level, the MBP will automatically switch to hibernation mode: basically shutting off so you don’t lose any work.
Sleep is great for when you’re actively using your computer, but when you want to stretch out battery life for as long as possible, you'll want it to hibernate. Also note that apparently the newer MacBook Pros also write information to the hard drive when sleeping so that when the battery drops to dangerous levels it can jump instantly into hibernation. Apple calls this “Safe Sleep”. (More info on all the technical stuff here)
A few examples of why you would want to use hibernation with your laptop:
- You’re about to head to the airport on an international flight and you want to use your machine during the flight but still leave enough juice to be able to pull up a map/email/info when you get to your destination.
- You toss your laptop in a bag and may or may not use it on a weekend trip but don’t want to worry about charging it.
- You want to conserve every little bit of power you can.
And when you would want to stick with sleep:
- Your laptop isn’t running off battery power
- You will be opening and closing your lid quite often
- You’re running around but actively using your laptop (conferences, meetings, etc.)
Basically you sacrifice the speed of restoring your machine to gain a little bit of battery power or vice versa. Personally I like to get every last bit of electricity that I can.
After some searching I came across a post that explained how to basically force your MBP into hibernation when the lid is closed. It requires a quick bit of work in a console, but is painfully simple.
In a console, type this command to determine your current sleep mode:
pmset -g | grep hibernate
This should return one of the following:
- 0 –
Legacy sleep mode
. It will save everything to RAM upon sleeping but does not support Safe Sleep. Very fast sleep. - 1 –
Legacy Safe Sleep
. This is the Safe Sleep. Everything your laptop goes into sleep, it will save everything to hard disk. It takes some time to go into sleep, and is slow to startup. Slow on Sleep and Startup. - 3 –
Default
. As described above, when sleeping, contents are saved to RAM. When battery runs out, hibernate occurs. - 5 – Behaves as 1 but applicable only for a modern Mac that uses 'Secure virtual memory'.
- 7 – Behaves as 3 but applicable only for a modern Mac that uses 'Secure virtual memory'.
Now edit and save your
/Users/username/.bash_profile
file with the following lines:Note that
hibernateon
and hibernateoff
can be any text you want: you just need to remember what you used.Now execute the following:
source .bash_profile
Now you have a handy little command that will let you enable and disable instant hibernation on a whim. Whenever you want your machine to hibernate when you close the lid, just drop to a terminal window and type
hibernateon
. When you’d prefer your laptop to just sleep, type hibernateoff
..bash_profile
Call apple big mac manual. (notice the period) is a 'hidden' file in your home directory. Try this command:
pico ~/.bash_profile
and then add the two alias lines.
user76897user76897
Mac Pmset Manual Pdf
Usually when you close the lid of your MBP, it will be put to sleep, waking quite quickly when you open the lid again. While sleeping, it's still consuming battery power, albeit a small amount compared to normal usage. When the battery reaches a certain low level, the MBP will automatically switch to hibernation mode
Mac Pmset Manual 2017
tronyxonlinetronyxonline