Adding upstream version 1.19.8.upstream/1.19.8upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 357 insertions, 0 deletions

diff --git a/man/fr/start-stop-daemon.man b/man/fr/start-stop-daemon.man
new file mode 100644
index 0000000..70546b7
--- /dev/null
+++ b/man/fr/start-stop-daemon.man
@@ -0,0 +1,357 @@
+.\" dpkg manual page - start-stop-daemon(8)
+.\"
+.\" Copyright © 1999 Klee Dienes <klee@mit.edu>
+.\" Copyright © 1999 Ben Collins <bcollins@debian.org>
+.\" Copyright © 2000-2001 Wichert Akkerman <wakkerma@debian.org>
+.\" Copyright © 2002-2003 Adam Heath <doogie@debian.org>
+.\" Copyright © 2004 Scott James Remnant <keybuk@debian.org>
+.\" Copyright © 2008-2016, 2018 Guillem Jover <guillem@debian.org>
+.\"
+.\" This is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" This is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
+.
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH start\-stop\-daemon 8 %RELEASE_DATE% %VERSION% "suite dpkg"
+.nh
+.SH NOM
+start\-stop\-daemon \- Lance ou arrête des démons système
+.
+.SH SYNOPSIS
+\fBstart\-stop\-daemon\fP [\fIoption\fP...] \fIcommande\fP
+.
+.SH DESCRIPTION
+On se sert de \fBstart\-stop\-daemon\fP pour contrôler la création ou l'arrêt de
+processus système. En utilisant les options correspondantes,
+\fBstart\-stop\-daemon\fP peut être configuré pour trouver les exemplaires
+présents d'un processus en fonctionnement.
+.PP
+Veuillez noter qu'à moins d'utiliser \fB\-\-pid\fP ou \fB\-\-pidfile\fP, le programme
+\fBstart\-stop\-daemon\fP se comporte comme \fBkillall\fP(1). \fBstart\-stop\-daemon\fP
+recherche dans le tableau des processus tout processus qui correspond au
+nom, pid parent, uid et/ou gid du processus (si indiqué). Toute
+correspondance empêchera \fB\-\-start\fP de démarrer le démon. Tous les processus
+qui correspondent recevront le signal TERM (ou le signal indiqué par
+\fB\-\-signal\fP ou \fB\-\-retry\fP) si \fB\-\-stop\fP est indiqué. Pour les démons avec
+des processus enfant qui doivent survivre à un \fB\-\-stop\fP, il est nécessaire
+d'indiquer un fichier pid («\ pidfile\ »).
+.
+.SH COMMANDES
+.TP 
+\fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIparamètres\fP
+Vérifier l'existence d'un processus particulier. Quand il existe un tel
+processus, \fBstart\-stop\-daemon\fP ne fait rien et se termine avec un code
+d'erreur égal à \fB1\fP (\fB0\fP si \fB\-\-oknodo\fP est précisé). Quand un tel
+processus n'existe pas, un exemplaire de l'exécutable est lancé, en
+utilisant le paramètre de \fB\-\-exec\fP ou celui de \fB\-\-startas\fP si cette option
+est précisée. Tout argument donné après \fB\-\-\fP sur la ligne de commande est
+passé tel quel au programme qui doit être lancé.
+.TP 
+\fB\-K\fP, \fB\-\-stop\fP
+Vérifier aussi l'existence d'un processus particulier. Quand un tel
+processus existe, \fBstart\-stop\-daemon\fP lui envoie le signal précisé avec
+\fB\-\-signal\fP et se termine avec un code d'erreur égal à \fB0\fP. Quand un tel
+processus n'existe pas, \fBstart\-stop\-daemon\fP se termine avec un code
+d'erreur égal à \fB1\fP (\fB0\fP si \fB\-\-oknodo\fP est précisé). Si \fB\-\-retry\fP est
+indiquée, \fBstart\-stop\-daemon\fP recherche si le processus ou les processus se
+sont bien terminés.
+.TP 
+\fB\-T\fP, \fB\-\-status\fP
+Contrôle l'existence du processus indiqué et sort avec un code de sortie
+défini par les actions des scripts d'initialisation de la LSB («\ LSB Init
+Script Actions\ » –\ depuis la version\ 1.16.1).
+.TP 
+\fB\-H\fP, \fB\-\-help\fP
+Affiche un message d'aide, puis quitte.
+.TP 
+\fB\-V\fP, \fB\-\-version\fP
+Affiche la version du programme, puis quitte.
+.
+.SH OPTIONS
+.SS "Options de correspondance"
+.TP 
+[\fB\-\-pid\fP] \fIpid\fP
+Vérifie l'existence d'un processus avec le \fIpid\fP spécifié (depuis la
+version\ 1.17.6). Le \fIpid\fP doit avoir un numéro supérieur à\ 0.
+.TP 
+[\fB\-\-ppid\fP] \fIpid parent\fP
+Vérifie l'existence d'un processus avec le pid parent \fIpid\-parent\fP spécifié
+(depuis la version\ 1.17.7). Le \fIpid\-parent\fP doit avoir un numéro supérieur
+à\ 0.
+.TP 
+\fB\-p\fP, \fB\-\-pidfile\fP \fIfichier\-pid\fP
+Cherche les processus dont les identifiants sont précisés dans
+\fIfichier\-pid\fP.
+.IP
+Note\ : l'utilisation de l'option de correspondance seule peut provoquer des
+actions sur des processus non prévus, si l'ancien processus s'est terminé
+sans savoir retiré le \fIfichier\-pid\fP.
+.IP
+\fBAttention\fP\ : L'utilisation de cette option de correspondance avec un
+fichier pid accessible à tous en écriture ou seule avec un démon qui écrit
+le fichier pid comme utilisateur non privilégié (pas root) sera refusée avec
+une erreur (depuis la version\ 1.19.3) car c'est un risque de sécurité, parce
+que, si le démon se trouve compromis, le contenu du fichier pid ne peut plus
+être sûr, et ainsi, un exécutant privilégié (comme un script init exécuté en
+tant que root) pourrait en fin de compte agir sur n'importe quel processus
+du système. L'utilisation de \fI/dev/null\fP est exclue de ces vérifications.
+.TP 
+\fB\-x\fP, \fB\-\-exec\fP \fIexécutable\fP
+Contrôle l'existence de processus qui soient des exemplaires de cet
+\fIexécutable\fP. Le paramètre \fIexécutable\fP doit être un chemin absolu. Note\ :
+cela peut ne pas fonctionner avec des scripts interprétés, car l'exécutable
+sera alors l'interpréteur. Des processus en exécution au sein d'un
+environnement fermé d'exécution («\ chroot\ ») seront également trouvés et il
+peut donc être nécessaire d'ajouter d'autres restrictions de correspondance.
+.TP 
+\fB\-n\fP, \fB\-\-name\fP \fInom\-de\-processus\fP
+Contrôle l'existence de processus avec \fInom\-de\-processus\fP comme nom. Le
+\fInom\-de\-processus\fP est en général le nom du fichier du processus, mais peut
+avoir été modifié par le processus lui\-même. Note\ : sur la plupart des
+systèmes, cette information est récupérée par le nom de communication du
+noyau, ce qui induit une limite de longueur assez courte (la portabilité
+impose de ne pas supposer plus de 15\ caractères).
+.TP 
+\fB\-u\fP, \fB\-\-user\fP \fIidentifiant\fP|\fIuid\fP
+Contrôle l'existence de processus dont le propriétaire est \fIidentifiant\fP ou
+\fIuid\fP. Note\ : si cette option est utilisée seule, tous les processus de cet
+utilisateur seront concernés par l'action.
+.
+.SS "Options génériques"
+.TP 
+\fB\-g\fP, \fB\-\-group\fP \fIgroupe\fP|\fIgid\fP
+Modifie le \fIgroupe\fP ou le \fIgid\fP au début du processus.
+.TP 
+\fB\-s\fP, \fB\-\-signal\fP \fIsignal\fP
+L'action \fB\-\-stop\fP définit le signal à envoyer au processus qui doit être
+arrêté (par défaut\ : TERM).
+.TP 
+\fB\-R\fP, \fB\-\-retry\fP \fIdurée\fP|\fIaction\-prévue\fP
+Avec l'action \fB\-\-stop\fP, \fBstart\-stop\-daemon\fP 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'\fIaction\-prévue\fP.
+
+Si \fIdurée\fP est indiquée plutôt que \fIaction\-prévue\fP, l'action\-prévue
+\fIsignal\fP\fB/\fP\fIdurée\fP\fB/KILL/\fP\fIdurée\fP est utilisée, où \fIsignal\fP est le
+signal indiqué par \fB\-\-signal\fP.
+
+\fIaction\-prévue\fP est une liste d'au moins deux items séparés par des barres
+obliques (\fB/\fP)\ ; chaque item peut être de la forme \fB\-\fP\fInuméro\-signal\fP ou
+de la forme [\fB\-\fP]\fInom\-signal\fP, ce qui demande d'envoyer ce signal\ ; ou
+bien de la forme \fIdurée,\fP ce qui demande d'attendre tant de secondes avant
+de terminer les processus, ou bien de la forme \fBforever\fP, 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 \fBforever\fP n'a pas été
+précisé, \fBstart\-stop\-daemon\fP se termine avec un code d'erreur égal à
+\fB2\fP. Quand une action\-prévue est indiquée, tout signal donné par
+\fB\-\-signal\fP est ignoré.
+.TP 
+\fI\-a\fP, \fB\-\-startas\fP \fInom\-de\-chemin\fP
+Avec l'action \fB\-\-start\fP, lance le processus spécifié par
+\fInom\-de\-chemin\fP. Si rien n'est précisé, c'est par défaut l'argument donné à
+\fB\-\-exec\fP.
+.TP 
+\fB\-t\fP, \fB\-\-test\fP
+Affiche les actions qui seraient entreprises et détermine la bonne valeur de
+retour, mais ne fait rien.
+.TP 
+\fB\-o\fP, \fB\-\-oknodo\fP
+Retourne un code de sortie égal à \fB0\fP au lieu de \fB1\fP si rien n'est ou ne
+sera fait.
+.TP 
+\fB\-q\fP, \fB\-\-quiet\fP
+N'affiche pas de messages d'information\ ; affiche seulement les messages
+d'erreur.
+.TP 
+\fB\-c\fP, \fB\-\-chuid\fP \fIidentifiant\fP|\fIuid\fP[\fB:\fP\fIgroupe\fP|\fIgid\fP]
+Change pour cet utilisateur ou «\ uid\ » avant de lancer le processus. On peut
+aussi préciser un groupe en ajoutant un \fB:\fP, puis le groupe ou un «\ gid\ »
+de la même façon qu'avec la commande \fBchown\fP(1)
+(\fIutilisateur\fP\fB:\fP\fIgroupe\fP). Lorsqu'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, même si l'option \fB\-\-group\fP n'est pas
+spécifiée. L'option \fB\-\-group\fP sert seulement pour les groupes dont
+l'utilisateur n'est pas membre (c'est comme rendre membre d'un
+groupe\-pour\-processus des utilisateurs génériques comme \fBnobody\fP).
+.TP 
+\fB\-r\fP, \fB\-\-chroot\fP \fIroot\fP
+Change de répertoire racine pour \fBroot\fP avant de lancer le
+processus. Remarquez que le «\ pidfile\ » est aussi écrit après le changement
+de racine.
+.TP 
+\fB\-d\fP, \fB\-\-chdir\fP \fIchemin\fP
+Change de répertoire pour \fIchemin\fP avant de commencer le processus. Cela
+est fait après le changement de répertoire racine si l'option
+\fB\-r\fP|\fB\-\-chroot\fP est demandée. Si rien n'est demandé, \fBstart\-stop\-daemon\fP
+changera de répertoire pour le répertoire racine avant de commencer le
+processus.
+.TP 
+\fB\-b\fP, \fB\-\-background\fP
+Utilisé généralement pour les programmes qui ne «\ se détachent\ » pas
+d'eux\-mêmes. Cette option oblige \fBstart\-stop\-daemon\fP à se dupliquer (fork)
+avant de lancer le processus, et l'oblige à passer en
+arrière\-plan. \fBAVERTISSEMENT\ : start\-stop\-daemon\fP ne peut pas vérifier le
+code de sortie quand, pour \fBune raison ou une autre\fP, 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 adaptable pour leur ajouter cette fonctionnalité.
+.TP 
+\fB\-\-notify\-await\fP
+Attend que le processus en arrière\-plan envoie une notification de
+disponibilité avant de considérer que le service est démarré (depuis la
+version\ 1.19.3). Cela met en œuvre des éléments du protocole de
+disponibilité de systemd, comme spécifié dans la page de manuel de
+\fBsd_notify\fP(3). Les variables suivantes sont prises en charge\ :
+.RS
+.TP 
+\fBREADY=1\fP
+Le programme est prêt à offrir son service, il est possible de quitter sans
+risque.
+.TP 
+\fBEXTEND_TIMEOUT_USEC=\fP\fInombre\fP
+Le programme demande l'extension de la durée de \fInombre\fP
+microsecondes. Cela fixera la durée en cours à la valeur spécifiée.
+.TP 
+\fBERRNO=\fP \fInombre\fP
+Le programme s'est terminé avec une erreur. Fait la même chose et affiche
+une chaîne conviviale pour la valeur de \fBerrno\fP.
+.RE
+.
+.TP 
+\fB\-\-notify\-timeout\fP\fIdurée\fP
+Définit une durée pour l'option \fB\-\-notify\-await\fP (depuis la
+version\ 1.19.3). Quand la durée est atteinte, \fBstart\-stop\-daemon\fP s'arrête
+avec un code d'erreur et aucune notification de disponibilité n'est
+attendue. La durée par défaut est de \fB60\fP\ secondes.
+.TP 
+\fB\-C\fP, \fB\-\-no\-close\fP
+Ne fermer aucun descripteur de fichiers en forçant le démon à s'exécuter en
+arrière\-plan (depuis la version\ 1.16.5). Utilisé à des fins de débogage afin
+de voir ce qu'affiche le processus ou pour rediriger les descripteurs de
+fichiers pour journaliser l'affichage du processus. N'est pertinent que lors
+de l'utilisation de \fB\-\-background\fP.
+.TP 
+\fB\-N\fP, \fB\-\-nicelevel\fP \fIint\fP
+Cela modifie la priorité du processus avant qu'il ne soit lancé.
+.TP 
+\fB\-P\fP, \fB\-\-procsched\fP \fIpolitique\fP\fB:\fP\fIpriorité\fP
+Modifie la politique du programmateur de processus («\ process scheduler
+policy\ ») et la priorité du processus avant de le démarrer (depuis la
+version\ 1.15.0). La priorité peut être indiquée de manière facultative avec
+\fB:\fP suivi de la valeur souhaitée. La \fIpriorité\fP par défaut est\ 0. Les
+valeurs de politiques actuellement gérées sont \fBother\fP, \fBfifo\fP et \fBrr\fP.
+.TP 
+\fB\-I\fP, \fB\-\-iosched\fP \fIclasse\fP\fB:\fP\fIpriorité\fP
+Modifie la classe du programmateur d'entrée/sortie («\ IO scheduler\ ») et la
+priorité du processus avant de le démarrer (depuis la version\ 1.15.0). La
+priorité peut être indiquée de manière facultative avec \fB:\fP suivi de la
+valeur souhaitée. La \fIpriorité\fP par défaut est\ 4, sauf si \fIclasse\fP est
+\fBidle\fP, auquel cas \fIpriorité\fP sera toujours égale à\ 7. Les valeurs de
+\fIclasse\fP actuellement gérées sont \fBidle\fP, \fBbest\-effort\fP et \fBreal\-time\fP.
+.TP 
+\fB\-k\fP, \fB\-\-umask\fP \fImasque\fP
+Cela modifie le masque utilisateur du processus avant qu'il ne soit lancé
+(depuis la version\ 1.13.22).
+.TP 
+\fB\-m\fP, \fB\-\-make\-pidfile\fP
+Utilisé lors du lancement d'un programme qui ne crée pas son propre fichier
+identificateur «\ pid\ ». Cette option indique à \fBstart\-stop\-daemon\fP de créer
+le fichier référencé par \fB\-\-pidfile\fP et placer le «\ pid\ » dans ce fichier
+juste avant d'exécuter le processus. Il faut remarquer que ce fichier ne
+sera supprimé quand le programme s'arrête que si \fB\-\-remove\-pidfile\fP est
+utilisé. \fBNOTE\ :\fP il se peut que cette caractéristique ne marche pas dans
+tous les cas. 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 \fB\-\-background\fP.
+.TP 
+\fB\-\-remove\-pidfile\fP
+Utilisé lors de l'arrêt d'un programme qui ne supprime pas lui\-même son
+fichier identificateur «\ pid\ » (depuis la version\ 1.17.19). Cette option
+indique à \fBstart\-stop\-daemon\fP de supprimer le fichier référencé par
+\fB\-\-pid\-file\fP après l'arrêt du processus.
+.TP 
+\fB\-v\fP, \fB\-\-verbose\fP
+Affiche des messages prolixes en renseignements.
+.
+.SH "CODE DE SORTIE"
+.TP 
+\fB0\fP
+L'action demandée a été effectuée. Si \fB\-\-oknodo\fP était indiqué, il est
+également possible que rien ne se soit passé. Cela peut se produire si
+\fB\-\-start\fP était indiqué et qu'un processus correspondant était déjà en
+train de s'exécuter ou si \fB\-\-stop\fP était indiqué et qu'aucun processus ne
+correspondait.
+.TP 
+\fB1\fP
+Si \fB\-\-oknodo\fP n'était pas indiqué et que rien ne s'est passé.
+.TP 
+\fB2\fP
+Si \fB\-\-stop\fP et \fB\-\-retry\fP étaient indiqués mais que la fin de la
+planification a été atteinte et que les processus étaient toujours en cours
+d'exécution.
+.TP 
+\fB3\fP
+Toute autre erreur.
+.PP
+Lorsque la commande \fB\-\-status\fP est utilisée, les codes d'état suivants sont
+renvoyés\ :
+.TP 
+\fB0\fP
+Le programme est en cours d'exécution.
+.TP 
+\fB1\fP
+Le programme n'est pas en cours d'exécution et le fichier PID existe.
+.TP 
+\fB3\fP
+Le programme n'est pas en cours d'exécution.
+.TP 
+\fB4\fP
+Impossible de déterminer l'état du programme.
+.
+.SH EXEMPLE
+Démarre le démon \fBfood\fP, à moins qu'il soit déjà en cours d'exécution (un
+processus nommé \fBfood\fP, tournant sous le nom d'utilisateur \fBfood\fP, avec un
+pid dans food.pid)\ :
+.IP
+.nf
+start\-stop\-daemon \-\-start \-\-oknodo \-\-user food \-\-name food \e
+	\-\-pidfile /run/food.pid \-\-startas /usr/sbin/food \e
+	\-\-chuid food \-\- \-\-daemon
+.fi
+.PP
+Envoie le signal \fBSIGTERM\fP à \fBfood\fP et attend durant 5\ secondes son
+arrêt\ :
+.IP
+.nf
+start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e
+	\-\-pidfile /run/food.pid \-\-retry 5
+.fi
+.PP
+Démonstration d'un ordonnanceur personnalisé pour l'arrêt de \fBfood\fP\ :
+.IP
+.nf
+start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e
+	\-\-pidfile /run/food.pid \-\-retry=TERM/30/KILL/5
+.fi
+.SH TRADUCTION
+Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.
+Philippe Batailler, 2006.
+Nicolas François, 2006.
+Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>.