START-STOP-DAEMON(N) Debian GNU/Linux START-STOP-DAEMON(N) NOM start-stop-daemon - lance ou arrte des dmons-systmes SYNOPSIS start-stop-daemon -S|--start options [--] arguments start-stop-daemon -K|--stop options start-stop-daemon -H|--help start-stop-daemon -V|--version DESCRIPTION On se sert de start-stop-daemon pour contrler la cration ou l'arrt de processus-systmes. On peut configurer start-stop-daemon avec les options --exec, --pidfile, --user, et --name, pour trouver les exemplaires prsents d'un processus en fonctionnement. Avec l'action --start, start-stop-daemon vrifie l'exis- tence d'un processus particulier. Quand existe un tel processus, start-stop-daemon ne fait rien et se termine avec un code d'erreur gal 1 (0 si --oknodo est prcis). Quand un tel processus n'existe pas, un exemplaire de l'excutable est lanc avec --exec, (ou, si c'est prcis, avec --startas). Tout argument donn aprs -- sur la ligne de commande est pass tel quel au programme qui doit tre lanc. Si --retry est indiqu, start-stop-daemon vrifie que le (ou les) processus s'est termin. Avec l'action --stop, start-stop-daemon vrifie aussi l'existence d'un processus particulier. Quand un tel pro- cessus existe start-stop-daemon lui envoie le signal prcis avec --signal, et se termine avec un code d'erreur gal 0. Quand un tel processus n'existe pas start-stop-daemon se termine avec un code d'erreur gal 1 (0 if --oknodo est prcis). OPTIONS -x|--exec executable Cherche les processus qui sont des exemplaires de cet excutable (selon /proc/pid/exe). -p|--pidfile pid-file Cherche les processus dont les identifiants sont prciss dans pid-file. -u|--user nom-d-utilisateur|uid Cherche les processus qui appartiennent l'utilisa- teur dfini par nom-d-utilisateur ou uid. -n|--name nom-de-processus Cherche les processus dont le nom est nom-de-pro- cessus (selon /proc/pid/stat). -s|--signal signal Avec l'action --stop, on dfinit le signal envoyer au processus qui doit tre arrt (par dfaut : signal 15). -R|--retry dure|action-prvue Avec l'action --stop, start-stop-daemon doit vri- fier que les processus se sont termins. Il le fait pour tous les processus correspondants qui tour- nent, jusqu' ce qu'il n'y en ait plus. Quand le processus ne se termine pas, il prend d'autres mesures dtermines par l'action-prvue. Si dure est indiqu plutt que action-prvue, l'action-prvue signal/dure/KILL/dure est utilis, o signal est le signal indiqu par --signal. action-prvue est une liste d'au moins deux items spars par des barres obliques (/) ; Chaque item peut tre de la forme -signal-number ou de la forme [-]signal-name, ce qui demande d'envoyer ce sig- nal ; ou bien de la forme dure, ce qui demande d'attendre tant de secondes avant de terminer les processus, ou bien de la forme forever, ce qui demande de rpter constamment le reste de action- prvue, si ncessaire. Quand la fin de l'action-prvue est atteinte et que forever n'a pa t prcis, start-stop-daemon se ter- mine avec un code d'erreur gal 2. Quand une action-prvue est indique, tout signal donn par --signal est ignor. -a | --startas chemin/nom Avec l'action --start , lance le processus spcifi par chemin/nom. Si rien n'est prcis, c'est par dfaut l'argument donn --exec. -t | --test Affiche les actions qui seraient entreprises et dtermine la bonne valeur de retour, mais ne fait rien. -o | --oknodo Retourne un code de sortie gal 0 au lieu de 1 si rien n'est ou ne sera fait. -q | --quiet N'affiche pas de messages d'information ; affiche seulement les messages d'erreur. -c | --chuid Change l'utilisateur ou l'identifiant avant de lancer le processus. On peut aussi prciser un groupe an ajoutant un : , puis le groupe ou un identifiant de la mme faon qu'avec la commande chown (utilisateur:groupe). Quand on utilise cette option, on doit s'apercevoir que les groupes pri- maires ainsi que les groupes supplmentaires sont aussi dtermins, mme si l'option group n'est pas spcifie. L'option group sert seulement pour les groupes dont l'utilisateur n'est pas un membre rgulier (c'est comme rendre membres d'un groupe- processus des utilisateurs gnriques comme nobody ). -r | --chroot root Change de rpertoire racine pour root avant de lancer le processus. Remarquez que le pidfile est aussi crit aprs le changement de racine. -b | --background est utilis de manire classique pour les programmes qui ne se dtachent pas d'eux-mmes. Cette option oblige start-stop-daemon se dupliquer (fork) avant de lancer le processus, et l'oblige passer en arrire-plan. AVERTISSEMENT : start-stop-daemon ne peut pas vrifier le code de sortie quand, pour une raison ou une autre, le processus choue. C'est un expdient dont on se servira seulement pour des pro- grammes dont la duplication n'a pas de sens ou bien des programmes dont le code n'est pas transformable pour leur ajouter cette fonctionnalit. -N|--nicelevel Cela modifie la priorit du processus avant qu'il ne soit lanc. -m | --make-pidfile Est utilis lors du lancement d'un programme qui ne cre pas son propre fichier identificateur. Cette option dit start-stop-daemon de crer le fichier rfrenc par --pidfile et place le pid dans ce fichier juste avant d'excuter le processus. Il faut remarquer que ce fichier n'est pas supprim quand le programme s'arrte. NOTE : il se peut que cette caractristique ne marche pas dans tous les cas. Et notamment quand le programme qui est excut se duplique. cause de cela, cette option n'est habituellement utile que combine avec l'option --background. -v | --verbose Affiche des messages prolixes de renseignements. -H | --help Affiche une aide et se termine. -V | --version Affiche le numro de version et se termine. AUTEURS Ian Jackson <ian@chiark.greenend.org.uk> Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> Page de manuel par Klee Dienes <klee@mit.edu>. TRADUCTION Philippe Batailler <pbatailler@teaser.fr>, Mai 2002. Debian Project 15th March 1997 START-STOP-DAEMON(N)