NOM
start-stop-daemon - lance ou arrte des dmons systme
SYNOPSIS
start-stop-daemon [options] commande
On se sert de start-stop-daemon pour contrler la cration ou l'arrt de
processus systme. En utilisant les options correspondantes,
start-stop-daemon peut tre configur pour trouver les exemplaires
prsents d'un processus en fonctionnement.
Veuillez noter qu' 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 indiqu). Toute correspondance
empchera --start de dmarrer le dmon. Tous les processus qui
correspondent recevront le signal TERM (ou le signal indiqu par
--signal or --retry). Pour les dmons avec des processus enfant qui
doivent survivre
un --stop, il est ncessaired'indiquer un fichier pid ( pidfile ).
COMMANDES
-S, --start [--] paramtres
Vrifier 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 gal 1 (0 si --oknodo est prcis). Quand un
tel processus n'existe pas, un exemplaire de l'excutable est
lanc, en utilisant le paramtre de --exec ou, celui de --startas
si cette option est prcise. Tout argument donn aprs -- sur la
ligne de commande est pass tel quel au programme qui doit tre
lanc.
-K, --stop
Vrifier aussi l'existence d'un processus particulier. Quand un
tel processus 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). Si
--retry est indique, start-stop-daemon recherche si le processus
ou les processus se sont bien termins.
-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 prciss dans
pid-file.
-x, --exec excutable
Cherche les processus qui sont des exemplaires de cet excutable
(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 l'utilisateur dfini par
nomdutilisateur ou uid.
OPTIONS
-g, --group group|gid
Modifie le group ou le gid au dbut du processus.
-s, --signal signal
L'action --stop, dfinit le signal envoyer au processus qui doit
tre arrt (par dfaut : TERM).
-R, --retry dure|action-prvue
Avec l'action --stop, start-stop-daemon doit vrifier que les
processus se sont termins. Il le fait pour tous les processus
correspondants qui tournent, 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 utilise, 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 signal ; 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
pas t prcis, start-stop-daemon se termine 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 utilisateur|uid
Change pour cet utilisateur ou uid avant de lancer le
processus. On peut aussi prciser un groupe en ajoutant un :,
puis le groupe ou un gid de la mme faon qu'avec la commande
chown (utilisateur:groupe). Lorsque un utilisateur est indiqu
mais pas de groupe alors le groupe primaire de celui-ci est
utilis. Quand on utilise cette option, on doit veiller ce que
les groupes primaires ainsi que les groupes secondaires existent
bien, mme si l'option --group n'est pas spcifie. 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 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.
-d, --chdir path
Change de rpertoire pour chemin avant de commencer le processus.
Cela est fait aprs le changement de rpertoire racine si l'option
-r|--chroot est demande. Si rien n'est demand, start-stop-daemon
changera de rpertoire racine avant de commencer le processus.
-b, --background
Utilis gnralement 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 programmes dont la duplication n'a pas de
sens ou bien des programmes dont le code n'est pas adaptable
pour leur ajouter cette fonctionnalit.
-N, --nicelevel int
Cela modifie la priorit du processus avant qu'il ne soit lanc.
-P, --procsched politique:priorit
Modifie la politique du programmateur de processus ( process
scheduler policy ) et la priorit du processus avant de le
dmarrer. La priorit peut tre indique de manire facultative avec
: suivi de la valeur souhaite. La priorit par dfaut est 0. Les
valeurs de politiques actuellement gres sont other, fifo et rr.
-I, --iosched classe:priorit
Modifie la classe du programmateur d'entre/sortie ( IO
scheduler ) et la priorit du processus avant de le dmarrer. La
priorit peut tre indique de manire facultative avec : suivi de
la valeur souhaite. La priorit par dfaut est 4, sauf si classe
est idle, auquel cas priorit sera toujours gale 7. Les valeurs
de classe actuellement gres sont idle, best-effort et real-time.
-k, --umask mask
Cela modifie le masque utilisateur du processus avant qu'il ne
soit lanc.
-m, --make-pidfile
Utilis lors du lancement d'un programme qui ne cre pas son
propre fichier identificateur pid . Cette option indique
start-stop-daemon de crer le fichier rfrenc par --pidfile et
placer 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. 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 en renseignements.
CODE DE SORTIE
start-stop-daemon renvoie 0 si l'action demande a t effectue, ou si
--oknodo est spcifi et aussi si --start a t spcifi et qu'un processus
de comparaison est dj en cours d'excution, ou si --stop a t spcifi et
qu'il n'y avait pas de processus correspondant. Si --oknodo n'a pas t
spcifi et rien n'a t fait, alors 1 est retourn. Si --stop et --retry
ont t prciss, mais que l'ordonnanceur a atteint la fin du calendrier en
ayant toujours le processus en cours d'excution, la valeur d'erreur est
2. Pour toutes les autres erreurs, l'tat est 3.
EXEMPLE
Dmarre le dmon food, moins qu'il soit dj en cours d'excution (un
processus nomm 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 food et attend durant 5 secondes son arrt :
start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
Dmonstration d'un ordonnanceur personnalis pour l'arrt 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> partir d'une
version faite par Ian Jackson <ian@chiark.greenend.org.uk>.
Page de manuel par Klee Dienes <klee@mit.edu>, partiellement reformatte
par Ian Jackson.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Franois, 2006. Veuillez signaler toute erreur
<debian-l10n-french@lists.debian.org>.