pmset

На компьютерах Apple pmset — это утилита командной строки для управления настройками управления питанием в Darwin и macOS операционных системах . Он может назначать настройки сна, планировать время сна и пробуждения, а также отображать информацию о питании.

История

The pmset Утилита впервые появилась в Darwin 6.0.1 и Mac OS X 10.2 «Jaguar» . Он периодически обновлялся с момента своего появления и по-прежнему доступен начиная с Darwin 21.2.0 и macOS Monterey .

Поведение

Утилита устанавливает или отображает параметры управления питанием . Некоторые функции, предоставляемые утилитой, доступны через графический интерфейс панели настроек энергосбережения . Однако, pmset обеспечивает большую гибкость и доступ к нескольким опциям, недоступным в графическом интерфейсе.

Утилита может устанавливать различные параметры управления питанием в зависимости от сценария использования. Различные настройки можно применять, когда машина работает от зарядного устройства, аккумулятора, ИБП или всех трех. Соответствующие флаги следующие:

-c (зарядное устройство), отрегулируйте настройки, используемые при подключении к зарядному устройству
-b (аккумулятор), отрегулируйте настройки, используемые при работе от аккумулятора
-u ( ИБП ), отрегулируйте настройки, используемые при работе от ИБП.
-a (все, по умолчанию) настроить параметры для всех сценариев

Дополнительные аргументы необходимо указывать при назначении любых параметров управления питанием. Аргументы управления питанием более подробно обсуждаются ниже. При вызове команды только указанные аргументы изменяют параметры управления питанием. Любые уже установленные аргументы не будут изменены pmset если эти аргументы специально не включены.

Утилита может планировать события пробуждения, сна, включения и выключения питания. События могут повторяться на основе произвольных комбинаций дней недели и времени или запланированы на будущие даты и время. Синтаксис планирования события следующий:

pmset [repeat, schedule] [sleep, wake, poweron, shutdown, wakeorpoweron] [<MTWRFSU> <date/time>]

Ранее сохраненные события будут перезаписаны при выполнении этой команды. Чтобы запланировать несколько событий, их необходимо ввести в одной командной строке. Например, чтобы установить событие выключения каждый день недели в 23:59 и событие пробуждения или включения питания каждый день недели в 7:00, введите следующее:

sudo pmset repeat shutdown MTWRFSU 23:59:00 wakeorpoweron MTWRFSU 7:00:00

Флаг get отображает информацию о текущей конфигурации управления питанием или журнал недавних действий. Если дополнительные аргументы не указаны, флаг будет отображать только текущие настройки. Дополнительные аргументы get обсуждаются более подробно ниже. Флаг получения выглядит следующим образом:

-g получить, вывести список текущих настроек управления питанием

Чтобы просмотреть тип запланированных на данный момент событий:

pmset -g sched

Утилита также способна настраивать параметры гибернации и безопасного сна, а также изменять профили энергосбережения.

Настройки управления питанием

The pmset Утилита распознает следующие аргументы. Аргументы можно передавать в последовательной форме в любом порядке. Любой неверный синтаксис или нераспознанный аргумент приведет к сбою всей команды, что приведет к появлению сообщения об ошибке и краткому экрану справки. Настройки управления питанием может изменить только привилегированный пользователь.

displaysleep — Таймер сна дисплея в минутах, 0, чтобы отключить сон дисплея
disksleep — таймер замедления вращения диска в минутах, 0, чтобы отключить спящий режим диска
sleep — таймер сна системы в минутах, 0 для отключения сна
womp - пробуждение по «волшебному» пакету Ethernet: 1 для включения или 0 для отключения. Обратите внимание, что этот параметр отображается только при запуске «pmset -g», если устройство подключено к источнику питания. В противном случае настройка wom НЕ будет отображаться при запуске «pmset -g».
hibernatemode изменить режим гибернации, 0 для питания оперативной памяти во время сна; 1 — содержимое ОЗУ записано на диск и система полностью обесточена; 3 для оперативной памяти, как с питанием, так и с записью на диск; 5 — то же, что и режим 1, но для использования с защищенной виртуальной памятью; 7 — то же, что и режим 3, но для использования с защищенной виртуальной памятью; 25 для спящего режима в Mac OS X 10.7 , при этом содержимое ОЗУ записывается на диск, а система полностью отключается от питания.
hibernatefile изменить местоположение файла образа гибернации; образ может находиться только в корневом томе
ring пробуждение по звонку модема, 1 для включения или 0 для отключения
autorestart автоматический перезапуск после потери питания, 1 для включения или 0 для отключения
dps динамически изменять скорость процессора в зависимости от нагрузки: 1 для включения или 0 для отключения
reduce навсегда снизить скорость процессора: 1, чтобы включить или 0, чтобы отключить
powerbutton переводить машину в спящий режим при нажатии кнопки питания, а не выключать ее: 1 для включения или 0 для отключения
powernap позволяет машине оставаться в курсе событий, даже когда она спит: 1 для включения или 0 для отключения
lidwake (только для ноутбуков) пробуждение машины при открытии крышки ноутбука: 1 для включения или 0 для отключения
acwake (только для ноутбука) пробуждает машину при смене источника питания, например, когда отключается питание переменного тока и машина переключается на питание от батареи: 1 для включения или 0 для отключения
lessbright (только для ноутбуков) слегка уменьшите яркость дисплея при переключении на указанный источник питания: 1, чтобы включить или 0, чтобы отключить
halfdim спящий режим дисплея будет использовать промежуточное состояние половинной яркости между полной яркостью и полным выключением: 1 для включения или 0 для отключения.
sms (только для поддерживаемых ноутбуков) используйте датчик внезапного движения для остановки головок диска при внезапных изменениях силы тяжести: 1 для включения или 0 для отключения
haltlevel (Только для ИБП) Заряд ИБП в процентах, выключение устройства, когда ИБП достигает заданного уровня заряда.
haltafter (Только для ИБП) Зарядка ИБП осуществляется в течение нескольких минут, выключение машины после подачи питания от ИБП в течение указанного количества минут.
haltremain (Только для ИБП) Зарядка ИБП осуществляется в течение нескольких минут, выключение машины по истечении заданного времени работы ИБП
ttyskeepawake предотвращать переход системы в режим ожидания, когда активен какой-либо терминал (например, сеанс удаленного входа в систему); терминал неактивен только тогда, когда время его простоя превышает таймер сна системы: 1 для включения или 0 для отключения.
autopoweroff (Питание переменного тока) Если поддерживается, включено по умолчанию в качестве реализации лота 6 Европейской директивы по энергетической продукции. После сна в течение нескольких минут autopoweroffdelay система запишет образ гибернации и перейдет в режим сна с пониженным энергопотреблением. Пробуждение из этого состояния займет больше времени, чем пробуждение из обычного сна. Система не будет автоматически отключаться, если подключены какие-либо внешние устройства, если система работает от аккумулятора или если система привязана к сети и включен режим пробуждения для доступа к сети.
autopoweroffdelay (питание переменного тока) задержка перед входом в режим автоматического выключения. (Значение = целое число в секундах)
standbydelaylow Задержка перед записью образа гибернации на диск и отключением памяти для режима ожидания. standbydelaylow используется, когда оставшаяся емкость аккумулятора низкая. (Значение = целое число в секундах)
standbydelayhigh Задержка перед записью образа гибернации на диск и отключением памяти для режима ожидания. standbydelayhigh используется, когда оставшаяся емкость аккумулятора высока. (Значение = целое число в секундах)
networkoversleep Этот параметр влияет на то, как сеть macOS представляет общие сетевые службы во время сна системы. Этот параметр используется не всеми платформами; изменение его значения не поддерживается.
destroyfvkeyonstandby Уничтожьте ключ хранилища файлов при переходе в режим ожидания. По умолчанию ключи хранилища файлов сохраняются, даже когда система переходит в режим ожидания. Если ключи уничтожены, пользователю будет предложено ввести пароль при выходе из режима ожидания. (значение: 1 – Уничтожить, 0 – Сохранить). Поскольку крайне важно, чтобы система была полностью выключена, вам также необходимо установить для параметра «hibernatemode» значение 25 (приостановить работу на диске).

Настройки можно регулировать независимо в зависимости от обстоятельств, когда машина подключена к зарядному устройству, при работе от аккумулятора (в случае ноутбука) или при работе от ИБП (если имеется). Настройки также можно настроить для всех четырех сценариев одновременно; это опция по умолчанию, если флаг использования не указан. Параметры управления питанием можно указать для разных профилей, добавив -c (зарядное устройство), -b (батарея), -u (ИБП) или -a (все) флаги. В следующем примере устройство перейдет в спящий режим через 10 минут, а дисплей перейдет в спящий режим через пять минут, но только при питании от аккумулятора.

pmset -b sleep 10 displaysleep 5

Следующая команда назначит немного другие настройки управления питанием для случаев, когда машина питается от зарядного устройства. Здесь машина переводится в спящий режим через 30 минут, а дисплей никогда не переходит в спящий режим, но только если это установлено зарядным устройством. Выдача обеих команд не будет мешать друг другу.

pmset -c sleep 30 displaysleep 0

Аргументы можно вводить в последовательной форме, чтобы установить или изменить несколько параметров управления питанием с помощью одной команды. Следующая команда переведет машину в режим сна ( sleep 0), включите датчик внезапного движения ( sms 1), переведите дисплей в спящий режим через 20 минут ( displaysleep 20), отключить снижение скорости процессора ( reduce 0), включить промежуточную яркость дисплея ( halfdim 1), включите пробуждение машины при открытии крышки ( lidwake 1), запретить системе переходить в спящий режим, когда активен сеанс tty (например, SSH) ( ttyskeepawake 1), отключите пробуждение аппарата при подключении адаптера переменного тока ( acwake 0), отключить автоматический перезапуск после отключения и восстановления питания ( autorestart 0), включить динамическое изменение скорости процессора в зависимости от загрузки системы ( dps 1), включить пробуждение по кольцу модема ( ring 1), включить пробуждение при получении «волшебного» Ethernet-пакета ( womp 1) и отключить спящий режим жесткого диска ( 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

Поскольку в приведенном выше примере не указан флаг использования, указанные настройки будут применяться ко всем сценариям использования. Последующие команды, в которых указан флаг использования, будут влиять только на настройки для этого сценария использования. Например, pmset -b sleep 10 через 10 минут машина перейдет в спящий режим, но только при подключенной батарее. Все остальные настройки будут применяться при подключении аккумулятора, а все настройки в приведенном выше примере будут применяться при подключении зарядного устройства или ИБП.

По крайней мере, начиная с Darwin 9.4 и OS X 10.5.4 «Leopard» , все изменения, внесенные через pmset сохраняются в постоянном файле настроек по адресу /Library/Preferences/SystemConfiguration/com.apple.PowerManagement.plist. Этот файл можно изменить вручную с помощью defaults команда, но эти изменения не будут немедленно приняты системой управления питанием. Ручное редактирование com.apple.PowerManagement.plist также существует риск перезаписи. Команда pmset touch перечитает существующие настройки с диска и применит их к системе.

С autopoweroff включено, машина перейдет в режим гибернации, даже если hibernatemode равно 0. Значение autopoweroffdelay может составлять секунды, несмотря на то, что на странице руководства (для Mavericks, 9 ноября 2012 г.) это указано в минутах.

Настройки расписания

The pmset Команда может планировать события сна, выключения, пробуждения или включения системы. schedule Аргументом является организация разовых энергетических мероприятий, и repeat предназначен для настройки ежедневных или еженедельных событий. Планирование событий может выполняться только привилегированным пользователем.

The schedule аргумент распознает следующие дополнительные аргументы:

тип; один из sleep, wake, poweron, shutdown или wakeorpoweron
дата и время (только расписание); в формате "MM/dd/yy HH:mm:ss"; должен быть в 24-часовом формате, должен быть в кавычках
время (только повтор); в формате HH:mm:ss; должно быть в формате 24, но не обязательно в кавычках
будние дни; подмножество MTWRFSU такой как M или MTWRF действительны, как и строки weekdays, weekends, и everyday
владелец; строка, описывающая человека или программу, планирующую событие питания (необязательно)

Утилита может быть очень непрощающей к неправильному синтаксису. Любые ошибки в синтаксисе приведут к сбою команды и отображению краткого справочного сообщения. Синтаксис запланированного события следующий:

pmset schedule [sleep, wake, poweron, shutdown, wakeorpoweron] "MM/dd/yy HH:mm:ss"

Можно указать только один тип события (сон, пробуждение и т. д.), а выбранная дата должна быть в будущем. Утилита предполагает возможность хранить эту информацию в PMU и поэтому может не работать надежно на оборудовании сторонних производителей. Строка даты и времени должна быть заключена в кавычки.

Синтаксис повторяющегося события следующий:

pmset repeat [sleep, wake, poweron, shutdown, wakeorpoweron] [MTWRFSU, weekdays, weekends, everyday] HH:mm:ss

Запланированные события пробуждения, сна и питания хранятся в постоянном файле настроек в /Library/Preferences/SystemConfiguration/com.apple.AutoWake.plist. Этот файл можно редактировать вручную с помощью defaults команда, но любые внесенные таким образом изменения подвергаются серьезному риску быть перезаписанными. Кроме того, такие изменения не будут немедленно приняты системой.

Список опций

Флаг списка, -g, отображает информацию о текущей конфигурации электропитания. Один только флаг, без дополнительных аргументов, будет отображать текущие настройки управления питанием. Дополнительные аргументы будут отображать более конкретную информацию. Функции получения pmset не требуют привилегированного доступа. Утилита распознает следующие аргументы (актуальный список можно получить с помощью недокументированной команды pmset -g getters команда, хотя она не показывает все *log варианты):

live нравиться -g без опции отображает настройки, используемые в данный момент
custom отобразит пользовательские настройки для всех источников питания, хотя эти настройки в настоящее время могут не использоваться
cap возможности, отображение функций управления питанием, которые поддерживает аппарат.
sched расписание, отображение запланированных событий запуска, пробуждения, выключения и сна
ups отобразит аварийные пороги ИБП
ac или adapter отобразит подробную информацию о подключенном адаптере переменного тока. Поддерживается только для MacBook и MacBook Pro.
ps или batt источник питания, отображение состояния подключенных аккумуляторов и ИБП
accps отобразит подробную информацию об источниках питания для аксессуаров
pslog отображать текущий журнал состояния источника питания
rawlog отображать текущий журнал состояния источника питания, считываемый непосредственно с батареи
rawbatt отображение состояния батареи
therm показывает температурный режим (не на всех платформах)
thermlog показывать постоянный журнал тепловых уведомлений (не на всех платформах)
assertions отображает сводку текущих утверждений мощности (10.6 и более поздние версии)
assertionslog отображает текущий журнал утверждений мощности (10.6 и более поздние версии)
sysload отображает рекомендации по загрузке системы (10.6 и более поздние версии)
useractivity показать текущий статус активности пользователя
useractivitylog показывать текущий журнал событий активности пользователя
log показать историю событий
history показать временную шкалу событий для отладки
historydetailed показать время на уровне драйвера для UUID исторического события
hidnull показать статус
userclients вывести список процессов, принимающих/отправляющих события
uuid отобразить текущий активный UUID сна/пробуждения
rtc отображать необработанные данные RTC
getters отобразить список допустимых опций для -g
powerstate отображать текущее состояние питания всех драйверов устройств
stats отображать статистику сна/бодрствования
systemstate отображать текущее состояние электропитания и возможности электропитания системы
everything показать все

В функцию можно передать только один аргумент get. pmset -g. Например, чтобы отобразить запланированные события, введите pmset -g sched. Утилита не вернет ошибку, если указано более одного аргумента get, но все, кроме первого, будут игнорироваться.

The sleep и displaysleep может отображать установленное значение 0 (отключено) вместе со списком идентификаторов процессов, которые налагают это значение. Это такие процессы, как программы резервного копирования, которым необходимо, чтобы машина не работала, например, до завершения резервного копирования.

Пример использования

Следующие примеры демонстрируют выходные данные pmset команда на Apple PowerBook G4 под управлением Mac OS X 10.5.4 «Leopard».

Следующий пример немедленно переводит соответствующий компьютер в спящий режим:

pmset sleepnow

Следующий пример применим только к ноутбукам с питанием от аккумулятора. Он переведет машину в спящий режим через 5 минут бездействия, переведет дисплей в спящий режим через 2 минуты и выключит жесткий диск через 3 минуты. Только привилегированные пользователи могут выполнить эту команду. Если команда выполнена успешно и без синтаксических ошибок, pmset завершится автоматически с кодом выхода 0. Чтобы убедиться, что система приняла новую конфигурацию, введите команду pmset -g.

pmset -b sleep 5 displaysleep 2 disksleep 3

Следующий пример применим только к машинам, питаемым от ИБП. Он настроит машину на аварийное отключение, когда в ИБП останется 5 процентов заряда батареи или останется расчетное время потребления энергии в течение 5 минут, в зависимости от того, что наступит раньше. Только привилегированные пользователи могут выполнить эту команду. Если команда выполнена успешно и без синтаксических ошибок, pmset завершится автоматически с кодом выхода 0. Чтобы убедиться, что система приняла новую конфигурацию, введите команду pmset -g.

pmset -u haltlevel 5 haltremain 5

Следующий пример применим ко всем сценариям использования. Он настроит машину на пробуждение при получении «волшебного» пакета Ethernet, пробуждение, если модем обнаружит звонок, и предотвращение перехода системы в спящий режим, если активен сеанс tty. Только привилегированные пользователи могут выполнить эту команду. Если команда выполнена успешно и без синтаксических ошибок, pmset завершится автоматически с кодом выхода 0. Чтобы убедиться, что система приняла новую конфигурацию, введите команду pmset -g.

pmset -a womp 1 ring 1 ttyskeepawake 1

В следующем примере задается однократное запланированное событие питания. Машина будет отключена 10 января 2009 г. в 22:00 (10 января 2009 г. – обратите внимание на синтаксис времени ММ/ДД/ГГГ, ориентированный на США). Только привилегированные пользователи могут выполнить эту команду. Если команда выполнена успешно и без синтаксических ошибок, pmset завершится автоматически с кодом выхода 0. Чтобы убедиться, что система приняла новую конфигурацию, введите команду pmset -g sched.

pmset schedule shutdown "01/10/2009 22:00:00"

В следующем примере задается повторяющееся событие питания. Машина будет выходить из режима сна или включаться каждый будний день в 8:00 утра. Только привилегированные пользователи могут выполнить эту команду. Если команда выполнена успешно и без синтаксических ошибок, pmset завершится автоматически с кодом выхода 0. Чтобы убедиться, что система приняла новую конфигурацию, введите команду pmset -g sched.

pmset repeat wakeorpoweron MTWRF 08:00:00

Здесь пример вывода из pmset -g. В то время машина питалась от зарядного устройства и одновременно заряжала аккумулятор. Команда печатает текущую конфигурацию.

$ pmset -g
Active Profiles:
Battery Power		-1
AC Power		-1*
Currently in use:
 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

Здесь пример вывода из pmset -g sched. В этом примере машина уже настроена на повторяющееся событие, которое начинается или просыпается каждый будний день в 8:00 утра. Команда печатает повторяющееся событие; Обратите внимание, что следующее такое событие отображается как запланированное событие питания.

$ pmset -g sched
Repeating power events:
  wakepoweron at 8:00AM weekdays only
Scheduled power events:
 [0]  wakeorpoweron at 08/04/08 08:00:00 by Repeating

Здесь пример вывода из pmset -g. В это время машина находилась в резервном копировании. В выходных данных показан PID программы резервного копирования.

$ pmset -g | grep sleep
 disksleep	10
 sleep		0 (imposed by 33927)
 displaysleep	5
$ ps -ef | grep 33927
    0 33927     1   0  9:22am ??        10:54.97 /System/Library/CoreServices/backupd

См. также

Ссылки

pmset(1) страница руководства на Apple Developer Connection
Управление питанием и планирование через командную строку в uMac, Университет Юты
Standbydelayhigh и StandbyDelay Low в обсуждениях Apple

Внешние ссылки

исходный код pmset на Apple Developer Connection)
pm-hibernate, pm-suspend для систем Linux
pm-pmu для систем Linux на оборудовании Mac
sys-suspend для систем Solaris
poweradm для систем Solaris