\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{ven. nov. 11 08:11:44 CET 2011}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={acpid},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Notifier les programmes utilisateurs des évènements ACPI},
CreationDate={D:20111111081144},
ModDate={D:20111111081144},
Keywords={Linux}
}}
\begin{document}
 
\begin{center}
{\Huge acpid }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Notifier les programmes utilisateurs des évènements ACPI}
 
\vspace{10mm}
 
\hspace{1mm}  \textbf{acpid} est conçus pour notifier les programmes utilisateurs des évènements ACPI. \textbf{acpid} devrait être démarré durant le boot. Il va ouvrir le fichier d'event (\textbf{/proc/acpi/event}) et tenter de lire toutes les lignes qui représentent les events ACPI. S'il n'existe pas, acpid tente de se connecter au kernel linux via la couche d'entrée et netlink. Quand un event ACPI est reçu d'une de ces sources, acpid examine une liste de règles, et exécute les règles qui matchent l'event. Il ignore tous les events ACPI entrant si un fichier \textbf{/var/lock/acpid} existe.
\vspace{5mm} \\
 
 
\hspace{1mm}  Les règles sont définies par de simples fichiers de configuration (dans \textbf{/etc/acpi/events} par défaut), et parcoure tous les fichiers réguliers. Les lignes blanches, ou commençant par un '\#' sont ignorés. Chaque ligne a 3 tokens: la clé, un signe '=' et la valeur. La clé peut avoir 63 caractères, et est sensible à la casse. La valeur d'event est une expression régulière.
\vspace{5mm} \\
 
 
\hspace{1mm}  La valeur de l'action est une ligne de commande, qui sera invoqué via \textbf{/bin/sh} quand un event match la règle. La ligne de commande peut contenir des caractères spéciaux et seront préservés. Le seul caractère spécial dans la valeur action est '\%'. La chaîne \%e remplace le texte de l'event. \%\% sera remplacé par \%.
\vspace{5mm} \\
 
 
\hspace{1mm}  Cette fonctionnalité permet à plusieurs règles d'être définies pour le même event. Pour forcer acpid à recharger les règles de configuration, lui envoyer un SIGHUP.
\vspace{5mm} \\
 
 
\hspace{1mm}  En plus des fichiers de règles, acpid accepte également des connections sur un socket UNIX (\textbf{/var/run/acpid.socket} par défaut). Une fois connecté, acpid envoie le texte de tous les events ACPI au client. acpid ne ferme pas le socket client excepté dans le cas d'un SIGHUP ou quand acpid se termine.
\vspace{5mm} \\
 
 
\hspace{1mm}  acpid log toutes ses activités dans sysylog.
\vspace{5mm} \\
 
 
\vspace{1cm}{\huge OPTIONS }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -c, --confdir]{Répertoire contenant les fichiers de règle. (défaut /etc/acpi/events)}
\item[\hspace{1mm} -C, --clientmax]{Nombre max de connections socket non-root (défaut 256)}
\item[\hspace{1mm} -d, --debug]{Mode debug}
\item[\hspace{1mm} -e, --eventfile]{Fichier d'event lu par acpid (défaut /proc/acpi/event)}
\item[\hspace{1mm} -n, --netlink]{force acpid à utiliser l'interface netlink du kernel pour les events ACPI}
\item[\hspace{1mm} -f, --foreground]{Ne se daemonise pas}
\item[\hspace{1mm} -l, --logevents]{log les informations de tous les events et actions}
\item[\hspace{1mm} -L, --lockfile]{Fichier lock (défaut : /var/lock/acpid)}
\item[\hspace{1mm} -g, --socketgroup]{Change le groupe propriétaire du socket où acpid publie les events}
\item[\hspace{1mm} -m, --socketmode]{change les permissions du socket UNIX (défaut 0666)}
\item[\hspace{1mm} -s, --socketfile]{Nom du socket à utiliser (défaut : /var/run/acpid.socket)}
\item[\hspace{1mm} -S, --nosoket]{N'ouvre pas de socket UNIX}
\item[\hspace{1mm} -p, --pidfile]{Fichier pid (défaut /var/run/acpid.pid)}
\end{description}
 
\vspace{1cm}{\huge Exemples }
 
\
 
\hspace{1mm} Éteindre le système si vous appuyez sur le bouton power: \\
\hspace{1mm} \textbf{event=button/power} \\
\hspace{1mm} \textbf{action=/etc/acpi/power.sh "\%e"} \\
\hspace{1mm} ce script contenant: \\
\hspace{1mm} \textbf{/sbin/shutdown -h now "Power button pressed"} \\
\end{flushleft}
\end{document}
