.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-NOTIFY 1 "" "systemd 260.2" systemd\-notify
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH NOM
systemd\-notify – Gestionnaire de service de notifications sur le déroulement
de l’amorçage et d’autres modifications d’état de démon
.SH SYNOPSIS
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP [\fIOPTIONS...\fP] [\fIVARIABLE=VALEUR...\fP]
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP \fB\-\-exec\fP [\fIOPTIONS...\fP] [\fIVARIABLE=VALUE...\fP] ;\ \-\-
{\fILIGNE_COMMANDE...\fP}
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP \fB\-\-fork\fP [\fIOPTIONS...\fP] \-\- {\fILIGNE_COMMANDE...\fP}
.SH DESCRIPTION
.PP
\fBsystemd\-notify\fP peut être appelé par des scripts de service pour notifier
le gestionnaire de service appelant de modifications d’état\&. Il peut être
utilisé pour envoyer des informations arbitraires, encodées dans une liste
de chaines de type bloc d’environnement\&. Plus important, il peut être
utilisé pour des notifications de l’avancement de l’amorçage\&.
.PP
C’est en grande partie une enveloppe de \fBsd_notify()\fP et procure cette
fonctionnalité aux scripts d’interpréteur de commandes\&. Pour plus de
détails, consulter \fBsd_notify\fP(3)\&.
.PP
La ligne de commande peut comporter une liste de variables d’environnement à
envoyer comme composante de la mise à jour d’états\&.
.PP
Notez que systemd refuse la réception de mises à jour de cette commande à
moins que \fBNotifyAccess=\fP ne soit réglé de façon appropriée pour l’unité de
service à partir de laquelle la commande est appelée\&. Consulter
\fBsystemd.service\fP(5) pour plus de détails\&.
.PP
Notez que les notifications \fBsd_notify()\fP ne peuvent être attribuées
correctement aux unités que si le processus émetteur est toujours présent au
moment où le gestionnaire de service traite le message ou si le processus
émetteur fait explicitement l'objet d'un suivi d'exécution par le
gestionnaire de service\&. Ce dernier cas est celui où le gestionnaire de
service fourche initialement le processus, c’est\-à\-dire pour tous les
processus qui correspondent à \fINotifyAccess=\fP\fBmain\fP ou
\fINotifyAccess=\fP\fBexec\fP\&. Inversement, si un programme auxiliaire de
l’unité envoie un message \fBsd_notify()\fP et quitte immédiatement, le
gestionnaire de service peut ne pas pouvoir attribuer correctement le
message à l’unité et, par conséquent, l’ignorer même si
\fINotifyAccess=\fP\fBall\fP est réglé pour elle\&. Pour corriger cela,
\fBsystemd\-notify\fP attend jusqu’à ce que le message de notification soit
traité par le gestionnaire de service\&. Lorsque l’option \fB\-\-no\-block\fP est
utilisée, cette synchronisation pour la réception de notification est
désactivée, et ainsi la situation de compétition susmentionnée peut se
produire si le processus appelant n’est pas le gestionnaire de service ou
n’est pas engendré par le gestionnaire de service\&.
.PP
\fBsystemd\-notify\fP essaie d’abord d’invoquer \fBsd_notify()\fP en prétendant
détenir le PID du processus parent de \fBsystemd\-notify\fP (c’est\-à\-dire le
processus appelant)\&. Cela ne fonctionne que si cela est invoqué avec les
privilèges suffisants\&. En cas d’échec, il se rabat sur une invocation sous
son propre PID\&. Ce comportement est utile afin que, lorsque l’outil est
invoqué par un script d’interpréteur de commandes, ce processus
d’interpréteur \(em et pas le processus \fBsystemd\-notify\fP \(em apparaisse
comme l’émetteur du message, ce qui est ensuite utile si le processus
d’interpréteur est le processus principal d’un service, à cause des
limitations de \fINotifyAccess=\fP\fBall\fP\&. Utilisez le commutateur \fB\-\-pid=\fP
pour ajuster ce comportement\&.
.SH OPTIONS
.PP
Les options suivantes sont comprises :
.PP
\fB\-\-ready\fP
.RS 4
Informer le gestionnaire de service appelant du démarrage du service ou de
l’achèvement du rechargement de configuration\&. Cela est équivalent à
\fBsystemd\-notify READY=1\fP\&. Pour plus de détails sur la sémantique de cette
option, consulter \fBsd_notify\fP(3)\&.
.RE
.PP
\fB\-\-reloading\fP
.RS 4
Informer le gestionnaire de service appelant du début du cycle de
rechargement de configuration\&. Cela est équivalent à \fBsystemd\-notify RELOADING=1\fP (mais implicitement définit le champ \fIMONOTONIC_USEC=\fP de la
manière requise pour les services \fIType=notify\-reload\fP, consulter
\fBsystemd.service\fP(5) pour plus de détails)\&. Pour plus de détails sur la
sémantique de cette option, consulter \fBsd_notify\fP(3)\&.
.sp
Ajouté dans la version 253\&.
.RE
.PP
\fB\-\-stopping\fP
.RS 4
Informer le gestionnaire de service appelant du début de la phase
d’extinction du service\&. Cela est équivalent à \fBsystemd\-notify STOPPING=1\fP\&. Pour plus de détails sur la sémantique de cette option,
consulter \fBsd_notify\fP(3)\&.
.sp
Ajouté dans la version 253\&.
.RE
.PP
\fB\-\-pid=\fP
.RS 4
Informer le gestionnaire de service sur le PID principal du service\&. Cette
option prend un PID comme argument\&. Si l’argument indiqué est «\ auto\ »
ou s’il est omis, le PID du processus invoquant \fBsystemd\-notify\fP est
utilisé, sauf si c’est le gestionnaire de service\&. Si l’argument indiqué
est «\ self\ », le PID de la commande \fBsystemd\-notify\fP elle\-même est
utilisé et si «\ parent\ » est indiqué, le PID du processus appelant est
utilisé \(em même si c’est le gestionnaire de service\&. \fB\-\-pid=auto\fP est
équivalent à \fBsystemd\-notify \-\-pid=$PID\fP\&. Pour plus de détails sur la
sémantique de cette option, consulter \fBsd_notify\fP(3)\&.
.sp
\fBsystemd\-notify\fP essaie d’abord d’invoquer \fBsd_notify()\fP en prétendant
détenir le PID indiqué avec l’option \fB\-\-pid=\fP\&. Cela ne fonctionne que si
cela est invoqué avec les privilèges suffisants\&. En cas d’échec, il se
rabat sur une invocation sous son propre PID\&. En réalité, cela signifie
qu’une invocation avec privilèges de \fBsystemd\-notify \-\-pid=\fP peut
contourner les restrictions \fINotifyAccess=main\fP ou \fINotifyAccess=exec\fP
appliquées à un service\&.
.sp
Si cette option est utilisée par une invocation sans privilèges de
\fBsystemd\-notify\fP par un processus qui devient le nouveau processus
principal d’un service \(em et qui n’est pas le processus fourché par le
gestionnaire de service (ou le processus principal actuel) \(em, alors il
est essentiel de régler \fINotifyAccess=all\fP dans le fichier d’unité de
service, sinon la notification est ignorée pour des raisons de
sécurité\&. Consulter \fBsystemd.service\fP(5) pour plus de détails\&.
.RE
.PP
\fB\-\-uid=\fP\fIUTILISATEUR\fP
.RS 4
Définir l’ID d’utilisateur à partir duquel envoyer une
notification\&. L’argument est un nom d’utilisateur UNIX ou un UID
numérique\&. Si cette option est indiquée, le message de notification est
envoyé avec l’UID spécifié comme expéditeur à la place de l’utilisateur sous
lequel la commande a été invoquée\&. Cette option nécessite des privilèges
suffisants pour pouvoir manipuler l’identité d’utilisateur du processus\&.
.sp
Ajouté dans la version 237\&.
.RE
.PP
\fB\-\-status=\fP
.RS 4
Envoyer une chaine de forme libre et humainement lisible à partir du démon à
destination du gestionnaire de service\&. Cette option prend une chaine
comme argument\&. C’est équivalent à \fBsystemd\-notify STATUS=\&...\fP\&. Pour
plus de détails sur la sémantique de cette option, consulter
\fBsd_notify\fP(3)\&. Cette information est affichée dans la sortie \fBstatus\fP
de \fBsystemctl\fP(1), entre autres endroits\&.
.RE
.PP
\fB\-\-booted\fP
.RS 4
Renvoyer \fB0\fP si le système a été amorcé avec systemd, une valeur différente
de zéro autrement\&. Si cette option est passée, aucun message n’est
envoyé\&. Cette option ne concerne donc pas les autres options\&. Pour plus
de détails sur la sémantique de cette option, consulter
\fBsd_booted\fP(3)\&. Une autre façon de vérifier cet état est d’appeler
\fBsystemctl\fP(1) avec la commande \fBis\-system\-running\fP\&. Elle affiche «\ offline\ » si le système n’a pas été amorcé avec systemd, bien que la valeur
de retour ait une signification différente\&.
.RE
.PP
\fB\-\-no\-block\fP
.RS 4
Ne pas attendre de manière synchrone la fin de l’opération
demandée\&. L’utilisation de cette option n’est recommandée seulement que
lorsque \fBsystemd\-notify\fP est engendré par le gestionnaire de service ou
quand le processus invoquant est engendré directement par le gestionnaire de
service et possède suffisamment de privilèges pour permettre à
\fBsystemd\-notify\fP d’envoyer la notification à son nom\&. L’envoi de
notifications avec cette option peut provoquer des situations de compétition
dans tous les autres cas\&.
.sp
Ajouté dans la version 246\&.
.RE
.PP
\fB\-\-exec\fP
.RS 4
Si cette option est indiquée, \fBsystemd\-notify\fP exécute une autre ligne de
commande après avoir terminé son opération, en remplaçant son propre
processus\&. Si utilisée, la liste des affectations à inclure dans le
message envoyé doit être suivie par un caractère «\ ;\ » (comme élément de
séparation), suivi de la ligne de commande à exécuter\&. Cela permet le «\ chainage\ » de commandes, c’est\-à\-dire lancer une opération suivie
immédiatement par une autre sans changer les PID\&.
.sp
Remarquez que de nombreux interpréteurs de commandes interprètent «\ ;\ »
comme leur propre séparateur de ligne de commande, par conséquent, quand
\fBsystemd\-notify\fP est invoqué à partir d’un interpréteur, le point\-virgule
doit être protégé par «\ \e;\ »\&.
.sp
Ajouté dans la version 254\&.
.RE
.PP
\fB\-\-fd=\fP
.RS 4
Envoyer un descripteur de fichier avec le message de notification\&. Cela
est utile lors d’une invocation dans des services qui ont le réglage
\fIFileDescriptorStoreMax=\fP activé\ ; consulter \fBsystemd.service\fP(5) pour
plus de détails\&. Le descripteur de fichier spécifié doit être passé à
\fBsystemd\-notify\fP lors de l’invocation\&. Cette option peut être utilisée
plusieurs fois pour passer plusieurs descripteurs de fichier dans un seul
message de notification\&.
.sp
Pour se servir de cette fonctionnalité dans un interpréteur \fBbash\fP(1),
utilisez une expression telle que la suivante\ :
.sp
.if  n \{\
.RS 4
.\}
.nf
systemd\-notify \-\-fd=4 \-\-fd=5 4</un/fichier 5</un/autre/fichier
.fi
.if  n \{\
.RE
.\}
.sp
Ajouté dans la version 254\&.
.RE
.PP
\fB\-\-fdname=\fP
.RS 4
Définir un nom à affecter aux descripteurs de fichier passés à l’aide de
l’option \fB\-\-fd=\fP (voir ci\-dessus)\&. Cette option contrôle le champ «\ FDNAME=\ »\&. Ce réglage peut être spécifié une seule fois et s’applique à
tous les descripteurs de fichier passés\&. Invoquez cet outil plusieurs fois
dans le cas où plusieurs descripteurs de fichier ayant des noms différents
doivent être passés\&.
.sp
Ajouté dans la version 254\&.
.RE
.PP
\fB\-\-fork\fP
.RS 4
Au lieu d’envoyer un message de notification, fourcher une ligne de commande
et attendre qu’un message «\ READY=1\ » soit reçu d’elle\&. En d’autres
termes\ : cela fait de \fBsystemd\-notify\fP le récepteur d’un message de
notification à la place de l’émetteur, échangeant ainsi les rôles\&. Cela
est utile pour fourcher rapidement un processus qui met en œuvre un
protocole \fBsd_notify()\fP à partir d’un script d’interpréteur de
commandes\&. La ligne de commande invoquée aura l’entrée standard et la
sortie standard connectées à \fI/dev/null\fP, mais la sortie standard d’erreur
sera héritée du processus invoqué\&. L’ID numérique de processus est écrit
sur la sortie standard par \fBsystemd\-notify\fP (à moins que l’option
\fB\-\-quiet\fP ne soit spécifiée) et peut être utilisé pour terminer plus tard
le processus fourché\&.
.sp
Remarquez que les processus fourchés continueront probablement à s'exécuter
après l’arrêt de \fBsystemd\-notify\fP, ce qui aboutira à ce qu’ils soient
réapparentés au processus moissonneur le plus proche, c'est\-à\-dire
généralement le gestionnaire de service propre à l’utilisateur ou du
système.
.sp
Remarquez que cette option ne doit pas être utilisée pour lancer des
services complets ponctuellement\ ; utilisez plutôt \fBsystemd\-run\fP(1) dans
ce cas\&.
.sp
Remarquez aussi qu’invoqué avec cette option, \fBsystemd\-notify\fP termine avec
succès sous deux conditions distinctes\ :
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\fBsystemd\-notify\fP a reçu une notification «\ READY=1\ » d’un processus
enfant qu’il vient de fourcher\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Le processus enfant s’est terminé proprement (avec comme code de retour
zéro) avant d’envoyer un «\ READY=1\ »\&.
.RE
.sp
Exemple d’utilisation\ :
.sp
.if  n \{\
.RS 4
.\}
.nf
# PID=$(systemd\-notify \-\-fork \-\- ma_commande)
\&...
kill "$PID"
unset PID
.fi
.if  n \{\
.RE
.\}
.sp
Ajouté dans la version 258\&.
.RE
.PP
\fB\-\-quiet\fP, \fB\-q\fP
.RS 4
Ne pas indiquer l’ID numérique de processus quand l’option \fB\-\-fork\fP est
utilisée\&.
.sp
Ajouté dans la version 258\&.
.RE
.PP
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher un aide\-mémoire succinct et quitter\&.
.RE
.PP
\fB\-\-version\fP
.RS 4
Afficher une information de version courte et quitter\&.
.RE
.SH "CODE DE RETOUR"
.PP
En cas de succès, \fB0\fP est renvoyé, autrement, un code d'échec différent de
zéro est renvoyé\&.
.SH EXEMPLE
.PP
\fBExemple\ \&1.\ \&Notification d’amorçage et mises à jour d’état\fP
.PP
Simple démon d’interpréteur de commandes envoyant des notifications
d’amorçage après avoir configurer son canal de communication\&. Pendant
l’exécution, envoi de mises à jour d’état au système init\ :
.sp
.if  n \{\
.RS 4
.\}
.nf
#!/bin/sh

mkfifo /tmp/téléopérateur
systemd\-notify \-\-ready \-\-status="Attente de données\&..."

while : ; do
        read \-r a < /tmp/téléopérateur
        systemd\-notify \-\-status="Traitement de $a"

        # Faire quelque chose avec $a \&...

        systemd\-notify \-\-status="Attente de données\&..."
done
.fi
.if  n \{\
.RE
.\}
.SH "VOIR AUSSI"
.PP
\fBsystemd\fP(1), \fBsystemctl\fP(1), \fBsystemd.unit\fP(5), \fBsystemd.service\fP(5),
\fBsd_notify\fP(3), \fBsd_booted\fP(3)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .