Suivant: Services audio, Précédent: Intégration continue, Monter: Services [Table des matières][Index]
The (gnu services pm)
module provides a Guix service definition for
the Linux Power Profiles Daemon, which makes power profiles handling
available over D-Bus.
The available profiles consist of the default ‘balanced’ mode, a ‘power-saver’ mode and on supported systems a ‘performance’ mode.
Important : The
power-profiles-daemon
conflicts with other power management tools liketlp
. Using both together is not recommended.
This is the service type for the
Power
Profiles Daemon. The value for this service is a
power-profiles-daemon-configuration
.
To enable the Power Profiles Daemon with default configuration add this line to your services:
Data type representing the configuration of
power-profiles-daemon-service-type
.
power-profiles-daemon
(default: power-profiles-daemon
) (type: file-like)Package object of power-profiles-daemon.
Le module (gnu services pm)
fournit une définition de service Guix
pour l’outil de gestion d’énergie Linux TLP.
TLP active plusieurs modes un espace utilisateur et dans le noyau.
Contrairement à upower-service
, ce n’est pas un outil passif de
surveillance, puisqu’il applique des paramètres personnalisés à chaque fois
qu’il détecte une nouvelle source d’énergie. Vous pouvez trouver plus
d’informations sur la page
d’accueil de TLP.
Le type de service pour l’outil TLP. Les paramètres par défaut sont
optimisés pour la durée de la batterie sur la plupart des systèmes, mais
vous pouvez les modifier comme vous voulez en ajoutant un
tlp-configuration
valide :
(service tlp-service-type
(tlp-configuration
(cpu-scaling-governor-on-ac (list "performance"))
(sched-powersave-on-bat? #t)))
Chaque définition de paramètre est précédée par son type ; par exemple,
‘booléen toto’ indique que le paramètre toto
doit être spécifié
comme un booléen. Les types qui commencent par peut-être-
dénotent
des paramètres qui n’apparaîtront pas dans la configuration de TLP lorsque
leur valeur est non spécifiée, ou est explicitement initialisée à la valeur
%unset-value
.
Les champs de tlp-configuration
disponibles sont :
tlp-configuration
:package tlp ¶Le paquet TLP.
tlp-configuration
:boolean tlp-enable? ¶Indiquez vrai si vous souhaitez activer TLP.
La valeur par défaut est ‘#t’.
tlp-configuration
:string tlp-default-mode ¶Mode par défaut lorsqu’aucune source d’énergie ne peut être détectée. Les possibilités sont AC et BAT.
La valeur par défaut est ‘"AC"’.
tlp-configuration
:entier-non-négatif disk-idle-secs-on-ac ¶Nombre de secondes que le noyau Linux doit attendre après que les disques s’arrêtent pour se synchroniser quand il est sur secteur.
La valeur par défaut est ‘0’.
tlp-configuration
:entier-non-négatif disk-idle-secs-on-bat ¶Comme disk-idle-ac
mais en mode batterie.
La valeur par défaut est ‘2’.
tlp-configuration
:entier-non-négatif max-lost-work-secs-on-ac ¶Périodicité du nettoyage des pages invalidées, en secondes.
La valeur par défaut est ‘15’.
tlp-configuration
:entier-non-négatif max-lost-work-secs-on-bat ¶Comme max-lost-work-secs-on-ac
mais en mode batterie.
La valeur par défaut est ‘60’.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces cpu-scaling-governor-on-ac ¶Gouverneur de fréquence d’horloge sur secteur. Avec le pilote intel_pstate, les possibilités sont powersave et performance. Avec le pilote acpi-cpufreq, les possibilités sont ondemand, powersave, performance et conservative.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces cpu-scaling-governor-on-bat ¶Comme cpu-scaling-governor-on-ac
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-scaling-min-freq-on-ac ¶Indique la fréquence d’horloge minimale pour le gouverneur sur secteur.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-scaling-max-freq-on-ac ¶Indique la fréquence d’horloge maximale pour le gouverneur sur secteur.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-scaling-min-freq-on-bat ¶Indique la fréquence d’horloge minimale pour le gouverneur sur batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-scaling-max-freq-on-bat ¶Indique la fréquence d’horloge maximale pour le gouverneur sur batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-min-perf-on-ac ¶Limite le P-état minimum pour contrôler la dissipation de puissance dans le CPU, sur secteur. Les valeurs sont indiqués comme un pourcentage des performances disponibles.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-max-perf-on-ac ¶Limite le P-état maximum pour contrôler la dissipation de puissance dans le CPU, sur secteur. Les valeurs sont indiqués comme un pourcentage des performances disponibles.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-min-perf-on-bat ¶Comme cpu-min-perf-on-ac
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif cpu-max-perf-on-bat ¶Comme cpu-max-perf-on-ac
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-booléen cpu-boost-on-ac? ¶Active la fonctionnalité turbo boost du CPU sur secteur.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-booléen cpu-boost-on-bat? ¶Comme cpu-boost-on-ac?
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:boolean sched-powersave-on-ac? ¶Permet au noyau Linux de minimiser le nombre de cœurs/hyper-threads CPU utilisés lorsque la charge est faible.
La valeur par défaut est ‘#f’.
tlp-configuration
:boolean sched-powersave-on-bat? ¶Comme sched-powersave-on-ac?
mais en mode batterie.
La valeur par défaut est ‘#t’.
tlp-configuration
:boolean nmi-watchdog? ¶Active le chien de garde NMI du noyau Linux.
La valeur par défaut est ‘#f’.
tlp-configuration
:peut-être-chaine phc-controls ¶Pour les noyaux Linux avec le correctif PHC, change le voltage du CPU. Une valeur serait par exemple ‘"F:V F:V F:V F:V"’.
La valeur par défaut est ‘disabled’.
tlp-configuration
:string energy-perf-policy-on-ac ¶Indique le niveau de performance du CPU par rapport à la politique de gestion de l’énergie sur secteur. Les possibilités sont performance, normal et powersave.
La valeur par défaut est ‘"performance"’.
tlp-configuration
:string energy-perf-policy-on-bat ¶Comme energy-perf-policy-ac
mais en mode batterie.
La valeur par défaut est ‘"powersave"’.
tlp-configuration
:space-separated-string-list disks-devices ¶Périphériques de disque dur.
tlp-configuration
:space-separated-string-list disk-apm-level-on-ac ¶Niveau de gestion de l’énergie avancé des disques durs.
tlp-configuration
:space-separated-string-list disk-apm-level-on-bat ¶Comme disk-apm-bat
mais en mode batterie.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces disk-spindown-timeout-on-ac ¶Délai d’attente pour arrêter de faire tourner les disques. Une valeur doit être spécifiée pour chaque disque dur déclaré.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces disk-spindown-timeout-on-bat ¶Comme disk-spindown-timeout-on-ac
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces disk-iosched ¶Sélectionne l’ordonnanceur d’entrées-sorties pour le disque. Une valeur doit être spécifiée pour chaque disque déclaré. Les possibilités sont par exemple cfq, deadline et noop.
La valeur par défaut est ‘disabled’.
tlp-configuration
:string sata-linkpwr-on-ac ¶Niveau de gestion de l’énergie des lien SATA aggressive (ALPM). Les possibilités sont min_power, medium_power et max_performance.
La valeur par défaut est ‘"max_performance"’.
tlp-configuration
:string sata-linkpwr-on-bat ¶Comme sata-linkpwr-ac
mais en mode batterie.
La valeur par défaut est ‘"min_power"’.
tlp-configuration
:peut-être-chaine sata-linkpwr-blacklist ¶Exclu les périphériques SATA spécifiés de la gestion de l’énergie des liens.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-booléen-on-off ahci-runtime-pm-on-ac? ¶Active la gestion de l’énergie à l’exécution pour les contrôleurs AHCI et les disques, sur secteur.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-booléen-on-off ahci-runtime-pm-on-bat? ¶Comme ahci-runtime-pm-on-ac
mais en mode batterie.
La valeur par défaut est ‘disabled’.
tlp-configuration
:entier-non-négatif ahci-runtime-pm-timeout ¶Secondes d’inactivités avant de suspendre les disques.
La valeur par défaut est ‘15’.
tlp-configuration
:string pcie-aspm-on-ac ¶Niveau de gestion de l’énergie des états actifs de PCI Express. Les possibilités sont default, performance et powersave.
La valeur par défaut est ‘"performance"’.
tlp-configuration
:string pcie-aspm-on-bat ¶Comme pcie-aspm-ac
mais en mode batterie.
La valeur par défaut est ‘"powersave"’.
tlp-configuration
:peut-être-entier-non-négatif start-charge-thresh-bat0 ¶Pourcentage à partir duquel la batterie 0 doit commencer à charger. Seulement pris en charge sur les ordinateurs portables.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif stop-charge-thresh-bat0 ¶Pourcentage à partir duquel la batterie 0 devrait arrêter de charger. Seulement pris en charge sur les ordinateurs portables.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif start-charge-thresh-bat1 ¶Pourcentage à partir duquel la batterie 1 devrait commencer à charger. Seulement pris en charge sur les ordinateurs portables.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-entier-non-négatif stop-charge-thresh-bat1 ¶Pourcentage à partir duquel la batterie 1 devrait arrêter de charger. Seulement pris en charge sur les ordinateurs portables.
La valeur par défaut est ‘disabled’.
tlp-configuration
:string radeon-power-profile-on-ac ¶Niveau de vitesse de l’horloge des cartes graphiques Radeon. Les possibilités sont low, mid, high, auto et default.
La valeur par défaut est ‘"high"’.
tlp-configuration
:string radeon-power-profile-on-bat ¶Comme radeon-power-ac
mais en mode batterie.
La valeur par défaut est ‘"low"’.
tlp-configuration
:string radeon-dpm-state-on-ac ¶Méthode de gestion de l’énergie dynamique de Radeon (DPM). Les possibilités sont battery et performance.
La valeur par défaut est ‘"performance"’.
tlp-configuration
:string radeon-dpm-state-on-bat ¶Comme radeon-dpm-state-ac
mais en mode batterie.
La valeur par défaut est ‘"battery"’.
tlp-configuration
:string radeon-dpm-perf-level-on-ac ¶Niveau de performance de DPM. Les possibilités sont auto, low et high.
La valeur par défaut est ‘"auto"’.
tlp-configuration
:string radeon-dpm-perf-level-on-bat ¶Comme radeon-dpm-perf-ac
mais en mode batterie.
La valeur par défaut est ‘"auto"’.
tlp-configuration
:on-off-boolean wifi-pwr-on-ac? ¶Mode de gestion de l’énergie wifi.
La valeur par défaut est ‘#f’.
tlp-configuration
:on-off-boolean wifi-pwr-on-bat? ¶Comme wifi-power-ac?
mais en mode batterie.
La valeur par défaut est ‘#t’.
tlp-configuration
:y-n-boolean wol-disable? ¶Désactive wake on LAN.
La valeur par défaut est ‘#t’.
tlp-configuration
:entier-non-négatif sound-power-save-on-ac ¶Durée d’attente en secondes avant d’activer la gestion de l’énergie audio sur les périphériques Intel HDA et AC97. La valeur 0 désactive la gestion de l’énergie.
La valeur par défaut est ‘0’.
tlp-configuration
:entier-non-négatif sound-power-save-on-bat ¶Comme sound-powersave-ac
mais en mode batterie.
La valeur par défaut est ‘1’.
tlp-configuration
:y-n-boolean sound-power-save-controller? ¶Désactive le contrôleur en mode de gestion de l’énergie sur les périphériques Intel HDA.
La valeur par défaut est ‘#t’.
tlp-configuration
:boolean bay-poweroff-on-bat? ¶Active le périphérique optique AltraBay/MediaBay en mode batterie. Le périphérique peut être de nouveau alimenté en lâchant (et en réinsérant) le levier d’éjection ou en appuyant sur le bouton d’éjection sur les modèles plus récents.
La valeur par défaut est ‘#f’.
tlp-configuration
:string bay-device ¶Nom du périphérique optique à éteindre.
La valeur par défaut est ‘"sr0"’.
tlp-configuration
:string runtime-pm-on-ac ¶Gestion de l’énergie à l’exécution sur les bus PCI(e). Les possibilités sont on et auto.
La valeur par défaut est ‘"on"’.
tlp-configuration
:string runtime-pm-on-bat ¶Comme runtime-pm-ac
mais en mode batterie.
La valeur par défaut est ‘"auto"’.
tlp-configuration
:boolean runtime-pm-all? ¶Gestion de l’énergie à l’exécution pour tous les bus PCI(e), sauf ceux en liste noire.
La valeur par défaut est ‘#t’.
tlp-configuration
:peut-être-liste-de-chaines-séparées-par-des-espaces runtime-pm-blacklist ¶Exclue les adresses des périphériques PCI(e) spécifiés de la gestion de l’énergie à l’exécution.
La valeur par défaut est ‘disabled’.
tlp-configuration
:space-separated-string-list runtime-pm-driver-blacklist ¶Exclue les périphériques PCI(e) assignés aux pilotes spécifiés de la gestion de l’énergie à l’exécution.
tlp-configuration
:boolean usb-autosuspend? ¶Active la fonctionnalité de mise en veille automatique de l’USB.
La valeur par défaut est ‘#t’.
tlp-configuration
:peut-être-chaine usb-blacklist ¶Exclue les périphériques spécifiés de la mise en veille automatique de l’USB.
La valeur par défaut est ‘disabled’.
tlp-configuration
:boolean usb-blacklist-wwan? ¶Exclue les périphériques WWAN de la mise en veille automatique de l’USB.
La valeur par défaut est ‘#t’.
tlp-configuration
:peut-être-chaine usb-whitelist ¶Inclue les périphériques spécifiés dans la mise en veille automatique de
l’USB, même s’ils sont déjà exclus par le pilote ou via
usb-blacklist-wwan?
.
La valeur par défaut est ‘disabled’.
tlp-configuration
:peut-être-booléen usb-autosuspend-disable-on-shutdown? ¶Active la mise en veille de l’USB avant l’arrêt.
La valeur par défaut est ‘disabled’.
tlp-configuration
:boolean restore-device-state-on-startup? ¶Restaure l’état des périphériques radio (bluetooth, wifi, wwan) du dernier arrêt au démarrage du système.
La valeur par défaut est ‘#f’.
tlp-configuration
parameter :string cpu-energy-perf-policy-on-ac ¶Set CPU energy/performance policy when on AC mode. Possible values, in order of increasing power saving, are performance, balance_performance, default, balance_power and power.
tlp-configuration
parameter :string cpu-energy-perf-policy-on-bat ¶Set CPU energy/performance policy when on BAT mode. Possible values, in order of increasing power saving, are performance, balance_performance, default, balance_power and power.
Le module (gnu services pm)
fournit une interface pour thermald, un
service de gestion de l’horloge CPU qui aide à éviter la surchauffe.
C’est le type de service pour thermald, le démon de température de Linux, responsable du contrôle de l’état thermique des processeurs et d’éviter la surchauffe.
Type de données représentant la configuration de
thermald-service-type
.
adptative?
(par défaut : #f
)Utilise les tables adaptatives DPTF (Dynamic Power and Thermal Framework) si elles sont présentes.
ignore-cpuid-check?
(par défaut : #f
)Ignore la vérification des modèles CPU supportés avec cpuid.
thermald
(par défaut : thermald)Objet du paquet de thermald.
The (gnu services pm)
module also provides a service definition for
PowerTOP, a power consumption analysis and
tuning tool. When started, it tunes Linux kernel settings to reduce power
consumption.
The service type for PowerTOP. No configuration is necessary. When the
service starts, it executes powertop --auto-tune
.
Available powertop-configuration
fields are:
powertop-configuration
parameter :package powertop ¶The PowerTOP package. Defaults to powertop
in the (gnu
packages linux)
module
The (gnu services power)
module provides a service definition for
apcupsd, a utility to interact with
APC (APC by Schneider Electric or formerly American Power
Conversion Corporation) UPS (Uninterruptible Power Supply)
devices. Apcupsd also works with some OEM (Original Equipment
Manufacturer)-branded products manufactured by APC.
The service type for apcupsd. For USB UPSes no configuration is necessary,
however tweaking some fields to better suit your needs might be desirable.
The defaults are taken from the upstream configuration and they are not very
conservative (for example, the default battery-level
of 5% may be
considered too low by some).
The default event handlers do send emails, read more in apcupsd-event-handlers.
Available apcupsd-configuration
fields are:
apcupsd
(default: apcupsd
) (type: package)The apcupsd
package to use.
shepherd-service-name
(default: apcupsd
) (type: symbol)The name of the shepherd service. You can add the service multiple times with different names to manage multiple UPSes.
auto-start?
(default: #t
) (type: boolean)Should the shepherd service auto-start?
pid-file
(default: "/var/run/apcupsd.pid"
) (type: string)The file name of the pid file.
debug-level
(default: 0
) (type: integer)The logging verbosity. Bigger number means more logs. The source code uses
up to 300
as debug level value, so a value of 999
seems
reasonable to enable all the logs.
run-dir
(default: "/var/run/apcupsd"
) (type: string)The directory containing runtime information. You need to change this if you desire to run multiple instances of the daemon.
name
(type: maybe-string)Use this to give your UPS a name in log files and such. This is particularly useful if you have multiple UPSes. This does not set the EEPROM. It should be 8 characters or less.
cable
(default: usb
) (type: enum-cable)The type of a cable connecting the UPS to your computer. Possible generic
choices are 'simple
, 'smart
, 'ether
and 'usb
.
Alternatively, a specific cable model number may be used: '940-0119A
,
'940-0127A
, '940-0128A
, '940-0020B
, '940-0020C
,
'940-0023A
, '940-0024B
, '940-0024C
, '940-1524C
,
'940-0024G
, '940-0095A
, '940-0095B
, '940-0095C
,
'940-0625A
, 'M-04-02-2000
.
type
(default: usb
) (type: enum-type)The type of the UPS you have.
apcsmart
Newer serial character device, appropriate for SmartUPS models using a serial cable (not an USB).
usb
Most new UPSes are an USB.
net
Network link to a master apcupsd through apcupsd’s Network Information Server. This is used if the UPS powering your computer is connected to a different computer for monitoring.
snmp
SNMP network link to an SNMP-enabled UPS device.
netsnmp
Same as the SNMP above but requires use of the net-snmp library. Unless you
have a specific need for this old driver, you should use the 'snmp
instead.
dumb
An old serial character device for use with simple-signaling UPSes.
pcnet
A PowerChute Network Shutdown protocol which can be used as an alternative to an SNMP with the AP9617 family of smart slot cards.
modbus
A serial device for use with newest SmartUPS models supporting the MODBUS protocol.
device
(default: ""
) (type: string)For USB UPSes, usually you want to set this to an empty string (the default). For other UPS types, you must specify an appropriate port or address.
apcsmart
Set to the appropriate /dev/tty** device.
usb
A null string setting enables auto-detection, which is the best choice for most installations.
net
Set to hostname:port
.
snmp
Set to hostname:port:vendor:community
. The
hostname is the ip address or hostname of the UPS on the network. The
vendor can be can be "APC" or "APC_NOTRAP". "APC_NOTRAP" will disable
SNMP trap catching; you usually want "APC". The port is usually 161.
The community is usually "private".
netsnmp
Same as the 'snmp
.
dumb
Set to the appropriate /dev/tty** device.
pcnet
Set to ipaddr:username:passphrase:port
. The
ipaddr is the IP address of the UPS management card. The
username and the passphrase are the credentials for which the
card has been configured. The port is the port number on which to
listen for messages from the UPS, normally 3052. If this parameter is empty
or missing, the default of 3052 will be used.
modbus
Set to the appropriate /dev/tty** device. You can also leave it empty for MODBUS over USB or set to the serial number of the UPS.
poll-time
(default: 60
) (type: integer)The interval (in seconds) at which apcupsd polls the UPS for status. This setting applies both to directly-attached UPSes (apcsmart, usb, dumb) and networked UPSes (net, snmp). Lowering this setting will improve the apcupsd’s responsiveness to certain events at the cost of higher CPU utilization.
on-batery-delay
(default: 6
) (type: integer)The time in seconds from when a power failure is detected until we react to
it with an onbattery event. The 'powerout
event will be triggered
immediately when a power failure is detected. However, the
'onbattery
event will be trigger only after this delay.
battery-level
(default: 5
) (type: integer)If during a power failure, the remaining battery percentage (as reported by the UPS) is below or equal to this value, the apcupsd will initiate a system shutdown.
Remarque :
battery-level
,remaining-minutes
, andtimeout
work in a conjunction, so the first that occurs will cause the initation of a shutdown.
remaining-minutes
(default: 3
) (type: integer)If during a power failure, the remaining runtime in minutes (as calculated internally by the UPS) is below or equal to this value, apcupsd will initiate a system shutdown.
Remarque :
battery-level
,remaining-minutes
, andtimeout
work in a conjunction, so the first that occurs will cause the initation of a shutdown.
timeout
(default: 0
) (type: integer)If during a power failure, the UPS has run on batteries for this many seconds or longer, apcupsd will initiate a system shutdown. The value of 0 disables this timer.
Remarque :
battery-level
,remaining-minutes
, andtimeout
work in a conjunction, so the first that occurs will cause the initation of a shutdown.
annoy-interval
(default: 300
) (type: integer)The time in seconds between annoying users (via the 'annoyme
event)
to sign off prior to system shutdown. 0 disables.
annoy-delay
(default: 60
) (type: integer)The initial delay in seconds after a power failure before warning users to get off the system.
no-logon
(default: disable
) (type: enum-no-logon)The condition which determines when users are prevented from logging in during a power failure.
kill-delay
(default: 0
) (type: integer)If this is non-zero, the apcupsd will continue running after a shutdown has been requested, and after the specified time in seconds attempt to kill the power. This is for use on systems where apcupsd cannot regain control after a shutdown.
net-server
(default: #f
) (type: boolean)If enabled, a network information server process will be started.
net-server-ip
(default: "127.0.0.1"
) (type: string)An IP address on which the NIS server will listen for incoming connections.
net-server-port
(default: 3551
) (type: integer)An IP port on which the NIS server will listen for incoming connections.
net-server-events-file
(type: maybe-string)If you want the last few EVENTS to be available over the network by the network information server, you must set this to a file name.
net-server-events-file-max-size
(default: 10
) (type: integer)The maximum size of the events file in kilobytes.
class
(default: standalone
) (type: enum-class)Normally standalone unless you share an UPS using an APC ShareUPS card.
mode
(default: disable
) (type: enum-mode)Normally disable unless you share an UPS using an APC ShareUPS card.
stat-time
(default: 0
) (type: integer)The time interval in seconds between writing the status file, 0 disables.
log-stats
(default: #f
) (type: boolean)Also write the stats as a logs. This generates a lot of output.
data-time
(default: 0
) (type: integer)The time interval in seconds between writing the data records to the log file, 0 disables.
facility
(type: maybe-string)The logging facility for the syslog.
event-handlers
(type: apcupsd-event-handlers)Handlers for events produced by apcupsd.
For a description of the events please refer to ‘man 8 apccontrol’.
Each handler shall be a gexp. It is spliced into the control script for the daemon. In addition to the standard Guile programming environment, the following procedures and variables are also available:
conf
Variable containing the file name of the configuration file.
powerfail-file
Variable containing the file name of the powerfail file.
cmd
The event currently being handled.
name
The name of the UPS as specified in the configuration file.
connected?
Is #t
if apcupsd
is connected to the UPS via a serial port
(or a USB port). In most configurations, this will be the case. In the
case of a Slave machine where apcupsd is not directly connected to the UPS,
this value will be #f
.
powered?
Is #t
if the computer on which apcupsd
is running is
powered by the UPS and #f
if not. At the moment, this value is
unimplemented and always #f
.
(err fmt args...)
Wrapper around format
outputting to (current-error-port)
.
(wall fmt args...)
Wrapper around format
outputting via wall
.
(apcupsd args...)
Call apcupsd
while passing the correct configuration file and all
the arguments.
(mail-to-root subject body)
Send an email to the local administrator. This procedure assumes the
sendmail
is located at /run/privileged/bin/sendmail
(as
would be the case with opensmtpd-service-type
).
Available apcupsd-event-handlers
fields are:
modules
(type: gexp)Additional modules to import into the generated handler script.
killpower
(type: gexp)The handler for the killpower event.
commfailure
(type: gexp)The handler for the commfailure event.
commok
(type: gexp)The handler for the commfailure event.
powerout
(type: gexp)The handler for the powerout event.
onbattery
(type: gexp)The handler for the onbattery event.
offbattery
(type: gexp)The handler for the offbattery event.
mainsback
(type: gexp)The handler for the mainsback event.
failing
(type: gexp)The handler for the failing event.
timeout
(type: gexp)The handler for the timeout event.
loadlimit
(type: gexp)The handler for the loadlimit event.
runlimit
(type: gexp)The handler for the runlimit event.
doreboot
(type: gexp)The handler for the doreboot event.
doshutdown
(type: gexp)The handler for the doshutdown event.
annoyme
(type: gexp)The handler for the annoyme event.
emergency
(type: gexp)The handler for the emergency event.
changeme
(type: gexp)The handler for the changeme event.
remotedown
(type: gexp)The handler for the remotedown event.
startselftest
(type: gexp)The handler for the startselftest event.
endselftest
(type: gexp)The handler for the endselftest event.
battdetach
(type: gexp)The handler for the battdetach event.
battattach
(type: gexp)The handler for the battattach event.
Suivant: Services audio, Précédent: Intégration continue, Monter: Services [Table des matières][Index]