Linux Certif

Toute la documentation sur la certification Linux LPI

start-stop-daemon

NOM

start-stop-daemon - lance ou arr�te des d�mons-syst�mes

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 contr�ler la cr�ation ou l'arr�t de processus-syst�mes. On peut configurer start-stop-daemon avec les options --exec, --pidfile, --user, et --name, pour trouver les exemplaires pr�sents d'un processus en fonctionnement.

Avec l'action --start, start-stop-daemon v�rifie l'existence 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 pr�cis�). Quand un tel processus n'existe pas, un exemplaire de l'ex�cutable est lanc� avec --exec, (ou, si c'est pr�cis�, avec --startas). Tout argument donn� apr�s -- sur la ligne de commande est pass� tel quel au programme qui doit �tre lanc�. Si --retry est indiqu�, start-stop-daemon v�rifie que le (ou les) processus s'est termin�.

Avec l'action --stop, start-stop-daemon v�rifie aussi l'existence d'un processus particulier. Quand un tel processus existe start-stop-daemon lui envoie le signal pr�cis� 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 pr�cis�).

OPTIONS

-x|--exec executable

Cherche les processus qui sont des exemplaires de cet ex�cutable (selon /proc/pid/exe).

-p|--pidfile pid-file

Cherche les processus dont les identifiants sont pr�cis�s dans pid-file.

-u|--user nom-d-utilisateur|uid

Cherche les processus qui appartiennent � l'utilisateur d�fini par nom-d-utilisateur ou uid.

-n|--name nom-de-processus

Cherche les processus dont le nom est nom-de-processus (selon /proc/pid/stat).

-s|--signal signal

Avec l'action --stop, on d�finit le signal � envoyer au processus qui doit �tre arr�t� (par d�faut : signal 15).

-R|--retry dur�e|action-pr�vue

Avec l'action --stop, start-stop-daemon doit v�rifier que les processus se sont termin�s. 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 d�termin�es par l'action-pr�vue.

Si dur�e est indiqu� plut�t que action-pr�vue, l'action-pr�vue signal/dur�e/KILL/dur�e est utilis�, o� signal est le signal indiqu� par --signal.

action-pr�vue est une liste d'au moins deux items s�par�s 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 dur�e, ce qui demande d'attendre tant de secondes avant de terminer les processus, ou bien de la forme forever, ce qui demande de r�p�ter constamment le reste de action-pr�vue, si n�cessaire.

Quand la fin de l'action-pr�vue est atteinte et que forever n'a pa �t� pr�cis�, start-stop-daemon se termine avec un code d'erreur �gal � 2. Quand une action-pr�vue est indiqu�e, tout signal donn� par --signal est ignor�.

-a | --startas chemin/nom

Avec l'action --start , lance le processus sp�cifi� par chemin/nom. Si rien n'est pr�cis�, c'est par d�faut l'argument donn� � --exec.

-t | --test

Affiche les actions qui seraient entreprises et d�termine 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 pr�ciser un groupe an ajoutant un � : �, puis le groupe ou un identifiant de la m�me fa�on qu'avec la commande � chown � (utilisateur:groupe). Quand on utilise cette option, on doit s'apercevoir que les groupes primaires ainsi que les groupes suppl�mentaires sont aussi d�termin�s, m�me si l'option � group � n'est pas sp�cifi�e. L'option � group � sert seulement pour les groupes dont l'utilisateur n'est pas un membre r�gulier (c'est comme rendre membres d'un groupe-processus des utilisateurs g�n�riques comme � nobody �).

-r | --chroot root

Change de r�pertoire racine pour root avant de lancer le processus. Remarquez que le � pidfile � est aussi �crit apr�s le changement de racine.

-b | --background

est utilis� de mani�re classique pour les programmes qui ne � se d�tachent � pas d'eux-m�mes. Cette option oblige start-stop-daemon � se dupliquer (fork) avant de lancer le processus, et l'oblige � passer en arri�re-plan. AVERTISSEMENT : start-stop-daemon ne peut pas v�rifier le code de sortie quand, pour une raison ou une autre, le processus �choue. C'est un exp�dient 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 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 cr�e pas son propre fichier identificateur. Cette option dit � start-stop-daemon de cr�er le fichier r�f�renc� par --pidfile et place le � pid � dans ce fichier juste avant d'ex�cuter le processus. Il faut remarquer que ce fichier n'est pas supprim� quand le programme s'arr�te. NOTE : il se peut que cette caract�ristique ne marche pas dans tous les cas. Et notamment quand le programme qui est ex�cut� se duplique. � cause de cela, cette option n'est habituellement utile que combin�e avec l'option --background.

-v | --verbose

Affiche des messages prolixes de renseignements.

-H | --help

Affiche une aide et se termine.

-V | --version

Affiche le num�ro 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.