Bsdadmin.ru

Записки администратора FreeBSD

Путь на сайте

Домашняя Mans FreeBSD по-русски apmd - демон мониторинга расширенного управления питанием

apmd - демон мониторинга расширенного управления питанием

НАЗВАНИЕ
apmd - демон мониторинга расширенного управления питанием (Advanced Power Management)

СИНТАКСИС
apmd [-d] [-f файл] [-v]

ОПИСАНИЕ
Демон apmd следит за наступлением заданных событий подсистемы расширенного управления питанием (Advanced Power Management - APM) и, при наступлении одного из этих событий, выполняет соответствующую последовательность команд. Демон apmd обрабатывает только события, указанные в файле конфигурации; все остальные события игнорируются. Для каждого события, о котором уведомляет подсистема APM BIOS, демон apmd вызывает заданную в конфигурационном файле последовательность команд. Когда демон apmd контролирует запросы остановки/режима ожидания (suspend/standby requests), ядро эти запросы обрабатывать не будет. Поэтому, если необходимо выполнять действие при наступлении этих событий, надо явно задать соответствующие команды или вызовы встроенных функций в конфигурационном файле.  Демон apmd распознает следующие опции:

-d
Запуск в режиме отладки. В результате, демон apmd запускается в приоритетном режиме, а не в фоновом.
-f
файл Задает другой конфигурационный файл, файл, для использования вместо стандартного, /etc/apmd.conf.
-v
Многословный режим работы.

При запуске демон apmd читает конфигурационый файл (по умолчанию - /etc/apmd.conf ) и передает набор событий, которые надо контролировать, драйверу устройства APM. При завершении работы демона драйвер устройства APM автоматически прекращает контроль событий.

Если процесс apmd получает сигнал SIGHUP, он перечитывает свой конфигурационный файл и уведомляет драйвер устройства APM о любых изменениях в конфигурации.

Демон apmd использует устройство /dev/apmctl для выполнения запросов ioctl(2) для контроля событий и управления подсистемой APM. Этот специальный файл устройства открывается в режиме исключительного доступа, поэтому в каждый момент времени может работать только один процесс apmd.

Когда демон apmd получает уведомление о событии от подсистемы APM, он запускает порожденный процесс для выполнения команд, указанных в конфигурационном файле, а затем продолжает работу в ожидании других событий. Порожденный процесс выполняет команды последовательно, в указанном порядке.

Пока демон apmd обрабатывает список команд для запросов SUSPEND/STANDBY, драйвер устройства APM ядра выдает уведомления подсистеме APM BIOS раз в секунду, так что BIOS знает, что есть еще не выполненные команды, и что запрос еще нельзя считать обработанным.

Демон apmd создает файл /var/run/apmd.pid , в котором записывает свой идентификатор процесса. Этот идентификатор можно использовать для остановки или переконфигурирования процесса apmd.

КОНФИГУРАЦИОННЫЙ ФАЙЛ
Структура конфигурационного файла демона apmd весьма проста. Например, конструкция:

apm_event SUSPENDREQ {
    exec "sync && sync && sync";
    exec "sleep 1";
    exec "zzz";
}

вызовет получение демоном apmd события APM "SUSPENDREQ" (которое может инициироваться закрытием ноутбука), при обработке которого трижды выполняется команда "sync", затем демон ожидает 1 секунду и выполняет команду zzz (apm-z) для перевода системы в состояние останова.

Итак, конфигурационный файл содержит одну или более подобных конструкций со следующими компонентами:

Ключевое слово apm_event
apm_event - это ключевое слово, свидетельствующее о начале конструкции, задающей обработку событий.


События APM
Если необходимо выполнять одни и те же команды для разных событий, имена событий перечисляются через запятую. Поддерживаются следующие имена событий:
 
События, игнорируемые ядром, если работает демон apmd:
STANDBYREQ   
USERSTANDBYREQ   
SUSPENDREQ в списке команд должна быть sync
USERSUSPENDREQ в списке команд должна быть sync
BATTERYLOW в списке команд должна быть только zzz

События, передаваемые демону apmd после обработки ядром:
NORMRESUME  
CRITRESUME  
STANDBYRESUME  
POWERSTATECHANGE  
UPDATETIME  
CAPABILITIESCHANGE
  

Уведомления о других событиях демону apmd не посылаются.

Команды
В представленном выше примере три строки, начинающиеся с "exec" - это команды обработки события. Каждая строка должна заканчиваться точкой с запятой. Список команд обработки события надо брать в фигурные скобки, "{" и "}". Для выполнения команд демон apmd вызывает командный интерпретатор /bin/sh, точно так же, как и системный вызов system(3). Команды выполняются последовательно, пока не будет достигнут конец списка или пока очередная команда не вернет ненулевой статус выхода. Демон apmd сообщает о статусе выхода любой не сработавшей команды через системный вызов syslog(3), а затем отвергает запрос, посланный APM BIOS.

Встроенные функции
Вместо команд можно также вызывать встроенные функции apmd. После имени встроенной функции надо указывать точку с запятой, так же, как и в конце строки команды. В настоящее время поддерживаются следующие встроенные функции:
reject:
Отвергает последний запрос, выполненный подсистемой APM BIOS. Эту функцию можно использовать, чтобы отказаться от обработки запроса останова (SUSPEND) при закрытии ноутбука и перевода системы вместо этого в состояние ожидания (STANDBY).
ПРИМЕРЫ
Типичные команды в конфигурационном файле:

apm_event SUSPENDREQ {
    exec "/etc/rc.suspend";
}

apm_event USERSUSPENDREQ {
    exec "sync && sync && sync";
    exec "sleep 1";
    exec "apm -z";
}

apm_event NORMRESUME, STANDBYRESUME {
    exec "/etc/rc.resume";
}

# Обработка события resume для мыши на последовательном порту:
# переинициализация демона moused(8), подключенного к этому порту.
#
#apm_event NORMRESUME {
#      exec "kill -HUP `cat /var/run/moused.pid`";
#}
#
# Обработка события suspend для пользователей жестких дисков ATA:
# выполняем standby вместо suspend.
#
#apm_event SUSPENDREQ {
#      reject;
#      exec "sync && sync && sync";
#      exec "sleep 1";
#      exec "apm -Z";
#}

ФАЙЛЫ
/etc/apmd.conf
/dev/apmctl
/var/run/apmd.pid

ССЫЛКИ
apm(4), apm(8)

Домашняя Mans FreeBSD по-русски apmd - демон мониторинга расширенного управления питанием