acpid |
Processus ACPI |
|---|---|
| Linux | Externe |
Syntaxe
| acpid [options] |
Paramètres
| Nom | Description |
|---|---|
| -C number | Ce paramètre permet de modifier le nombre maximum de connexions socket non root pouvant être effectuées sur le socket acpid. La valeur par défaut est 256. |
| -c directory | Ce paramètre permet de modifier le répertoire dans lequel acpid recherche les fichiers de configuration de règles. La valeur par défaut est /etc/acpi/events. |
| --confdir directory | Ce paramètre permet de modifier le répertoire dans lequel acpid recherche les fichiers de configuration de règles. La valeur par défaut est /etc/acpi/events. |
| --clientmax number | Ce paramètre permet de modifier le nombre maximum de connexions socket non root pouvant être effectuées sur le socket acpid. La valeur par défaut est 256. |
| -d | Ce paramètre permet d'augmenter le niveau de débogage acpid d'une unité. Si le niveau de débogage est différent de zéro, la commande acpid s'exécutera au premier plan et se connectera à stderr, en plus du syslog normal. |
| --debug | Ce paramètre permet d'augmenter le niveau de débogage acpid d'une unité. Si le niveau de débogage est différent de zéro, la commande acpid s'exécutera au premier plan et se connectera à stderr, en plus du syslog normal. |
| --dropaction action | Ce paramètre permet de définir la pseudo-action indiquant à acpid d'abandonner tout traitement d'un événement, y compris les avertissements client. La valeur par défaut est drop. |
| -e filename | Ce paramètre permet de modifier le fichier d'événements à partir duquel acpid lit les événements. La valeur par défaut est /proc/acpi/event. |
| --eventfile filename | Ce paramètre permet de modifier le fichier d'événements à partir duquel acpid lit les événements. La valeur par défaut est /proc/acpi/event. |
| -f | Ce paramètre permet de garder l'acpid au premier plan en ne forçant pas au démarrage. |
| --foreground | Ce paramètre permet de garder l'acpid au premier plan en ne forçant pas au démarrage. |
| -g groupname | Ce paramètre permet de modifier la propriété du groupe du socket de domaine UNIX sur lequel acpid publie les événements. |
| -h | Ce paramètre permet d'afficher l'aide sur cette commande et de quitter immédiatement. |
| --help | Ce paramètre permet d'afficher l'aide sur cette commande et de quitter immédiatement. |
| -L filename | Ce paramètre permet de modifier le fichier de verrouillage utilisé pour arrêter le traitement des événements. La valeur par défaut est /var/lock/acpid. |
| -l | Ce paramètre permet d'indiquer à acpid de consigner les informations sur tous les événements et actions. |
| --logevents | Ce paramètre permet d'indiquer à acpid de consigner les informations sur tous les événements et actions. |
| --lockfile filename | Ce paramètre permet de modifier le fichier de verrouillage utilisé pour arrêter le traitement des événements. La valeur par défaut est /var/lock/acpid. |
| -m mode | Ce paramètre permet de modifier les autorisations du socket de domaine UNIX sur lequel acpid publie les événements. La valeur par défaut est 0666. |
| -n | Ce paramètre permet de forcer acpid à utiliser la couche d'entrée du noyau Linux et l'interface netlink pour les événements ACPI. |
| --netlink | Ce paramètre permet de forcer acpid à utiliser la couche d'entrée du noyau Linux et l'interface netlink pour les événements ACPI. |
| --nosocket filename | Ce paramètre permet d'indiquer à acpid de ne pas ouvrir de socket de domaine UNIX. Cela remplace l'option -s et annule toutes les autres options de socket. |
| --pidfile filename | Ce paramètre permet d'indiquer à acpid d'utiliser le fichier spécifié comme fichier pid. Si le fichier existe, il sera supprimé et écrasé. La valeur par défaut est /var/run/acpid.pid. |
| -S filename | Ce paramètre permet d'indiquer à acpid de ne pas ouvrir de socket de domaine UNIX. Cela remplace l'option -s et annule toutes les autres options de socket. |
| -s filename | Ce paramètre permet de modifier le nom du socket de domaine UNIX qu'acpid ouvre. La valeur par défaut est /var/run/acpid.socket. |
| --socketmode mode | Ce paramètre permet de modifier les autorisations du socket de domaine UNIX sur lequel acpid publie les événements. La valeur par défaut est 0666. |
| --socketfile filename | Ce paramètre permet de modifier le nom du socket de domaine UNIX qu'acpid ouvre. La valeur par défaut est /var/run/acpid.socket. |
| -r action | Ce paramètre permet de définir la pseudo-action indiquant à acpid d'abandonner tout traitement d'un événement, y compris les avertissements client. La valeur par défaut est drop. |
| --socketgroup groupname | Ce paramètre permet de modifier la propriété du groupe du socket de domaine UNIX sur lequel acpid publie les événements. |
| -t | Ce paramètre permet une gestion spéciale du bouton de sourdine pour certains modèles ThinkPad avec des voyants de sourdine se désynchronisant avec l'état de sourdine lorsque le bouton de sourdine est maintenu enfoncé. Avec cette option, le bouton mute va générer les événements suivants en synchronisation avec le nombre d'appuis (et, par extension, l'état de la LED) : touche/mute MUTE (touche enfoncée) K bouton/mute MUTE (touche relâchée) K |
| --tpmutefix | Ce paramètre permet une gestion spéciale du bouton de sourdine pour certains modèles ThinkPad avec des voyants de sourdine se désynchronisant avec l'état de sourdine lorsque le bouton de sourdine est maintenu enfoncé. Avec cette option, le bouton mute va générer les événements suivants en synchronisation avec le nombre d'appuis (et, par extension, l'état de la LED) : touche/mute MUTE (touche enfoncée) K bouton/mute MUTE (touche relâchée) K |
| -v | Ce paramètre permet d'afficher la version de cette commande et de quitter immédiatement. |
| --version | Ce paramètre permet d'afficher la version de cette commande et de quitter immédiatement. |
Description
Cette commande permet d'effectuer la gestion du service informant l'espace utilisateur des programmes sur les événements de l'ACPI (Advanced Configuration and Power Interface), conçercant les avertissements de batterie, le changement de boitier d'alimentation et la fermeture d'écran de portable.
Remarques
- La commande acpid est conçu pour avertir les programmes de l'espace utilisateur des événements ACPI. La commande acpid doit être démarré pendant le démarrage du système et s'exécutera en arrière-plan par défaut. Il ouvrira un fichier d'événements (/proc/acpi/event par défaut) et tentera de lire des lignes entières représentant des événements ACPI. Si le fichier d'événements n'existe pas, la commande acpid tentera de se connecter au noyau Linux via la couche d'entrée et netlink. Lorsqu'un événement ACPI est reçu de l'une de ces sources, acpid examine une liste de règles et exécute les règles qui correspondent à l'événement. La commande acpid ignorera tous les événements ACPI entrants si un fichier de verrouillage existe (/var/lock/acpid par défaut).
- Les règles sont définies par de simples fichiers de configuration. La commande acpid recherchera dans un répertoire de configuration (/etc/acpi/events par défaut) et analysera tous les fichiers normaux avec des noms entièrement composés de lettres majuscules et minuscules, de chiffres, de traits de soulignement et de traits d'union (similaire à run-parts). Chaque fichier doit définir deux choses : un événement et une action. Toutes les lignes vides ou les lignes où le premier caractère est un dièse ("#") sont ignorées. Les lignes superflues sont signalées comme des avertissements, mais ne sont pas fatales. Chaque ligne a trois jetons : la clef, un signe égal littéral et la valeur. La clef peut contenir jusqu'à 63 caractères et est insensible à la casse (mais les espaces blancs sont importants). La valeur peut contenir jusqu'à 511 caractères et est sensible à la casse et aux espaces.
- La valeur de l'événement est une expression régulière (voir regcomp), à laquelle les événements sont comparés.
- La valeur de l'action est une ligne de commande, étant invoquée via /bin/sh chaque fois qu'un événement correspondant à la règle en question se produit. La ligne de commande peut inclure des caractères spéciaux de l'interpréteur de commande, et ils seront conservés. Les seuls caractères spéciaux dans une valeur d'action sont "%" échappés. La chaîne de caractères "%e" sera remplacée par le texte littéral de l'événement pour lequel l'action a été invoquée. Cette chaîne de caractères peut contenir des espaces, la ligne de commande doit donc prendre soin de citer le "%e" si elle veut un seul jeton. La chaîne de caractères "%%" sera remplacée par un littéral "%". Tous les autres échappements "%" sont réservés et empêcheront le chargement d'une règle.
- Cette fonctionnalité permet de définir plusieurs règles pour le même événement (bien qu'aucun ordre ne soit garanti), ainsi qu'une règle à définir pour plusieurs événements. Pour forcer acpid à recharger la configuration de la règle, envoyez-lui un SIGHUP.
- La pseudo-action drop provoque la suppression complète de l'événement et aucun autre traitement n'est entrepris ; les clients se connectant via le socket de domaine UNIX ne seront pas notifiés de l'événement. Cela peut être utile sur certaines machines, telles que certains ordinateurs portables générant des événements de batterie parasites à intervalles fréquents. Le nom de cette pseudo-action peut être redéfini avec une option de ligne de commande.
- En plus des fichiers de règles, acpid accepte également les connexions sur un socket de domaine UNIX (/var/run/acpid.socket par défaut). Toute application peut se connecter à ce socket. Une fois connecté, acpid enverra le texte de tous les événements ACPI au client. Le client a la responsabilité de filtrer les messages dont il se soucie. Le acpid ne fermera pas le socket client sauf en cas de sortie SIGHUP ou acpid.
- Pour un démarrage plus rapide, ce socket peut être transmis en tant que stdin afin qu'acpid n'ait pas besoin de créer le socket. De plus, si un socket est passé en tant que stdin, acpid ne sera pas un service. Il se déroulera au premier plan. Ce comportement est fourni pour prendre en charge systemd.
- La commande acpid enregistrera toutes ses activités, ainsi que la sortie standard (stdout) et la sortie d'erreur standard (stderr) de toutes les actions, dans syslog.
- Tous les fichiers et répertoires par défaut peuvent être modifiés avec les options de la ligne de commande.
Dernière mise à jour : Mercredi, le 14 janvier 2015