Provided by: dpkg_1.16.0.3ubuntu5_i386 bug

NOM

       start-stop-daemon - lance ou arrete des demons systeme

SYNOPSIS

       start-stop-daemon [options] commande

DESCRIPTION

       On  se  sert de start-stop-daemon pour controler la creation ou l'arret
       de  processus  systeme.  En  utilisant  les  options   correspondantes,
       start-stop-daemon  peut  etre  configure  pour  trouver les exemplaires
       presents d'un processus en fonctionnement.

       Veuillez  noter  qu'a  moins   d'utiliser   --pidfile,   le   programme
       start-stop-daemon   se  comporte  comme  killall(1).  start-stop-daemon
       recherche dans le tableau des processus tout processus  qui  correspond
       au  nom,  uid et/ou gid du processus (si indique). Toute correspondance
       empechera  --start  de  demarrer  le  demon.  Tous  les  processus  qui
       correspondent  recevront  le  signal  TERM  (ou  le  signal indique par
       --signal or --retry). Pour les demons avec  des  processus  enfant  qui
       doivent  survivre  a  un --stop, il est necessaired'indiquer un fichier
       pid (<< pidfile >>).

COMMANDES

       -S, --start [--] param`etres
              Verifier l'existence d'un processus particulier. Quand il existe
              un  tel  processus, start-stop-daemon ne fait rien et se termine
              avec un code d'erreur egal a 1  (0  si  --oknodo  est  precise).
              Quand   un   tel   processus  n'existe  pas,  un  exemplaire  de
              l'executable est lance, en utilisant le parametre de --exec  ou,
              celui  de  --startas si cette option est precisee. Tout argument
              donne apres -- sur la ligne de commande est passe  tel  quel  au
              programme qui doit etre lance.

       -K, --stop
              Verifier  aussi l'existence d'un processus particulier. Quand un
              tel processus existe  start-stop-daemon  lui  envoie  le  signal
              precise avec --signal et se termine avec un code d'erreur egal a
              0. Quand un tel  processus  n'existe  pas  start-stop-daemon  se
              termine  avec  un  code  d'erreur  egal  a  1 (0 if --oknodo est
              precise). Si --retry est indiquee,  start-stop-daemon  recherche
              si le processus ou les processus se sont bien termines.

       -H, --help
              Affiche un message d'aide, puis quitte.

       -V, --version
              Affiche la version du programme et le copyright, puis quitte.

OPTIONS DE CORRESPONDANCE

       -p, --pidfile pid-file
              Cherche  les  processus dont les identifiants sont precises dans
              pid-file.

       -x, --exec ex'ecutable
              Cherche les processus qui sont des exemplaires de cet executable
              (selon /proc/pid/exe).

       -n, --name nomdeprocessus
              Cherche  les  processus  dont  le  nom est nomdeprocessus (selon
              /proc/pid/stat).

       -u, --user nomdutilisateur|uid
              Cherche les processus qui appartiennent a  l'utilisateur  defini
              par nomdutilisateur ou uid.

OPTIONS

       -g, --group group|gid
              Modifie le group ou le gid au debut du processus.

       -s, --signal signal
              L'action  --stop,  definit  le signal a envoyer au processus qui
              doit etre arrete (par defaut : TERM).

       -R, --retry dur'ee|action-pr'evue
              Avec l'action --stop, start-stop-daemon doit  verifier  que  les
              processus  se  sont termines. Il le fait pour tous les processus
              correspondants qui tournent, jusqu'a ce qu'il n'y en  ait  plus.
              Quand  le processus ne se termine pas, il prend d'autres mesures
              determinees par l'action-prevue.

              Si dur'ee est indique plutot que  action-pr'evue,  l'action-prevue
              signal/dur'ee/KILL/dur'ee  est  utilisee,  ou signal est le signal
              indique par --signal.

              action-pr'evue est une liste d'au moins deux  items  separes  par
              des  barres  obliques  (/) ;  chaque  item peut etre de la forme
              -signal-number ou de la forme  [-]signal-name,  ce  qui  demande
              d'envoyer  ce signal ; ou bien de la forme dur'ee, ce qui demande
              d'attendre tant de secondes avant de terminer les processus,  ou
              bien  de la forme forever, ce qui demande de repeter constamment
              le reste de action-prevue, si necessaire.

              Quand la fin de l'action-prevue est atteinte et que forever  n'a
              pas  ete  precise,  start-stop-daemon  se  termine  avec un code
              d'erreur egal a 2. Quand une action-prevue  est  indiquee,  tout
              signal donne par --signal est ignore.

       -a, --startas chemin/nom
              Avec   l'action   --start,   lance  le  processus  specifie  par
              chemin/nom. Si rien n'est precise, c'est par  defaut  l'argument
              donne a --exec.

       -t, --test
              Affiche  les  actions  qui  seraient entreprises et determine la
              bonne valeur de retour, mais ne fait rien.

       -o, --oknodo
              Retourne un code de sortie egal a 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 utilisateur|uid
              Change pour cet utilisateur ou  << uid >>  avant  de  lancer  le
              processus.  On  peut  aussi preciser un groupe en ajoutant un :,
              puis le groupe ou un << gid >>  de  la  meme  facon  qu'avec  la
              commande    << chown >>    (utilisateur:groupe).    Lorsque   un
              utilisateur est indique mais  pas  de  groupe  alors  le  groupe
              primaire de celui-ci est utilise. Quand on utilise cette option,
              on doit veiller a ce que les groupes  primaires  ainsi  que  les
              groupes  secondaires  existent  bien,  meme  si l'option --group
              n'est pas specifiee. L'option --group >> sert seulement pour les
              groupes  dont l'utilisateur n'est pas membre (c'est comme rendre
              membre d'un groupe-pour-processus  des  utilisateurs  generiques
              comme nobody).

       -r, --chroot root
              Change  de  repertoire  racine  pour  root  avant  de  lancer le
              processus. Remarquez que le << pidfile >> est aussi ecrit  apres
              le changement de racine.

       -d, --chdir path
              Change   de   repertoire  pour  chemin  avant  de  commencer  le
              processus. Cela est  fait  apres  le  changement  de  repertoire
              racine  si  l'option  -r|--chroot  est  demandee.  Si rien n'est
              demande, start-stop-daemon changera de repertoire  racine  avant
              de commencer le processus.

       -b, --background
              Utilise   generalement   pour   les   programmes  qui  ne  << se
              detachent >>    pas    d'eux-memes.    Cette    option    oblige
              start-stop-daemon  a  se  dupliquer  (fork)  avant  de lancer le
              processus, et l'oblige a passer en arriere-plan. AVERTISSEMENT :
              start-stop-daemon  ne peut pas verifier le code de sortie quand,
              pour une raison ou une autre,  le  processus  echoue.  C'est  un
              expedient  dont on se servira seulement pour des programmes dont
              la duplication n'a pas de sens ou bien des  programmes  dont  le
              code n'est pas adaptable pour leur ajouter cette fonctionnalite.

       -N, --nicelevel int
              Cela modifie la priorite du processus avant qu'il ne soit lance.

       -P, --procsched politique:priorit'e
              Modifie  la  politique du programmateur de processus (<< process
              scheduler policy >>) et la priorite du  processus  avant  de  le
              demarrer.  La priorite peut etre indiquee de maniere facultative
              avec : suivi de la valeur souhaitee. La priorit'e par defaut  est
              0.  Les  valeurs  de  politiques actuellement gerees sont other,
              fifo et rr.

       -I, --iosched classe:priorit'e
              Modifie  la  classe  du  programmateur  d'entree/sortie   (<< IO
              scheduler >>)  et la priorite du processus avant de le demarrer.
              La priorite peut etre indiquee de  maniere  facultative  avec  :
              suivi de la valeur souhaitee. La priorit'e par defaut est 4, sauf
              si classe est idle, auquel cas priorit'e sera toujours egale a 7.
              Les valeurs de classe actuellement gerees sont idle, best-effort
              et real-time.

       -k, --umask mask
              Cela modifie le masque utilisateur du processus avant  qu'il  ne
              soit lance.

       -m, --make-pidfile
              Utilise  lors  du  lancement  d'un programme qui ne cree pas son
              propre fichier identificateur << pid >>. Cette option indique  a
              start-stop-daemon de creer le fichier reference par --pidfile et
              placer le << pid >> dans ce fichier juste  avant  d'executer  le
              processus.  Il  faut remarquer que ce fichier n'est pas supprime
              quand le  programme  s'arrete.  NOTE :  il  se  peut  que  cette
              caracteristique ne marche pas dans tous les cas. Notamment quand
              le programme qui est execute se duplique. A cause de cela, cette
              option  n'est  habituellement  utile  que combinee avec l'option
              --background.

       -v, --verbose
              Affiche des messages prolixes en renseignements.

CODE DE SORTIE

       start-stop-daemon renvoie 0 si l'action demandee a ete effectuee, ou si
       --oknodo  est  specifie  et  aussi  si  --start a ete specifie et qu'un
       processus de comparaison est deja en cours d'execution, ou si --stop  a
       ete  specifie  et  qu'il  n'y  avait pas de processus correspondant. Si
       --oknodo n'a pas ete specifie  et  rien  n'a  ete  fait,  alors  1  est
       retourne.   Si   --stop   et   --retry   ont  ete  precises,  mais  que
       l'ordonnanceur a atteint la fin du  calendrier  en  ayant  toujours  le
       processus  en  cours d'execution, la valeur d'erreur est 2. Pour toutes
       les autres erreurs, l'etat est 3.

EXEMPLE

       Demarre le demon food, a moins qu'il soit deja en cours d'execution (un
       processus  nomme food, tournant sous le nom d'utilisateur food, avec un
       pid dans food.pid) :

              start-stop-daemon --start --oknodo --user food --name food --pidfile /var/run/food.pid --startas /usr/sbin/food --chuid food -- --daemon

       Envoie le signal SIGTERM a food et attend durant 5 secondes son arret :

              start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5

       Demonstration d'un ordonnanceur personnalise pour l'arret de food :

              start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry=TERM/30/KILL/5

AUTEURS

       Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> a partir  d'une
       version faite par Ian Jackson <ian@chiark.greenend.org.uk>.

       Page   de   manuel   par   Klee  Dienes  <klee@mit.edu>,  partiellement
       reformattee par Ian Jackson.

TRADUCTION

       Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.  Philippe Batailler, 2006.
       Nicolas   Francois,   2006.    Veuillez   signaler   toute   erreur   a
       <debian-l10n-french@lists.debian.org>.