Suivant: , Précédent: , Monter: Services   [Table des matières][Index]


11.10.28 Services de gestion de l’énergie

Power Profiles Daemon

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 like tlp. Using both together is not recommended.

Variable :power-profiles-daemon-service-type

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 :power-profiles-daemon-configuration

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.

Démon TLP

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.

Variable :tlp-service-type

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 :

paramètre de tlp-configuration :package tlp

Le paquet TLP.

paramètre de tlp-configuration :boolean tlp-enable?

Indiquez vrai si vous souhaitez activer TLP.

La valeur par défaut est ‘#t’.

paramètre de 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"’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de tlp-configuration :boolean sched-powersave-on-bat?

Comme sched-powersave-on-ac? mais en mode batterie.

La valeur par défaut est ‘#t’.

paramètre de tlp-configuration :boolean nmi-watchdog?

Active le chien de garde NMI du noyau Linux.

La valeur par défaut est ‘#f’.

paramètre de 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’.

paramètre de 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"’.

paramètre de tlp-configuration :string energy-perf-policy-on-bat

Comme energy-perf-policy-ac mais en mode batterie.

La valeur par défaut est ‘"powersave"’.

paramètre de tlp-configuration :space-separated-string-list disks-devices

Périphériques de disque dur.

paramètre de tlp-configuration :space-separated-string-list disk-apm-level-on-ac

Niveau de gestion de l’énergie avancé des disques durs.

paramètre de tlp-configuration :space-separated-string-list disk-apm-level-on-bat

Comme disk-apm-bat mais en mode batterie.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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"’.

paramètre de tlp-configuration :string sata-linkpwr-on-bat

Comme sata-linkpwr-ac mais en mode batterie.

La valeur par défaut est ‘"min_power"’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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"’.

paramètre de tlp-configuration :string pcie-aspm-on-bat

Comme pcie-aspm-ac mais en mode batterie.

La valeur par défaut est ‘"powersave"’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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"’.

paramètre de tlp-configuration :string radeon-power-profile-on-bat

Comme radeon-power-ac mais en mode batterie.

La valeur par défaut est ‘"low"’.

paramètre de 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"’.

paramètre de tlp-configuration :string radeon-dpm-state-on-bat

Comme radeon-dpm-state-ac mais en mode batterie.

La valeur par défaut est ‘"battery"’.

paramètre de 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"’.

paramètre de 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"’.

paramètre de tlp-configuration :on-off-boolean wifi-pwr-on-ac?

Mode de gestion de l’énergie wifi.

La valeur par défaut est ‘#f’.

paramètre de tlp-configuration :on-off-boolean wifi-pwr-on-bat?

Comme wifi-power-ac? mais en mode batterie.

La valeur par défaut est ‘#t’.

paramètre de tlp-configuration :y-n-boolean wol-disable?

Désactive wake on LAN.

La valeur par défaut est ‘#t’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de tlp-configuration :string bay-device

Nom du périphérique optique à éteindre.

La valeur par défaut est ‘"sr0"’.

paramètre de 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"’.

paramètre de tlp-configuration :string runtime-pm-on-bat

Comme runtime-pm-ac mais en mode batterie.

La valeur par défaut est ‘"auto"’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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.

paramètre de tlp-configuration :boolean usb-autosuspend?

Active la fonctionnalité de mise en veille automatique de l’USB.

La valeur par défaut est ‘#t’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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’.

paramètre de 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.

Démon Thermald

Le module (gnu services pm) fournit une interface pour thermald, un service de gestion de l’horloge CPU qui aide à éviter la surchauffe.

Variable :thermald-service-type

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 :thermald-configuration

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.

PowerTOP

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.

Variable :powertop-service-type

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.

Variable :apcupsd-service-type

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.

Data Type :apcupsd-configuration

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, and timeout 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, and timeout 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, and timeout 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.

Data Type :apcupsd-event-handlers

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]