Provided by: devscripts_2.25.19ubuntu2_all 
NOM
annotate-output - Annoter la sortie d’un programme avec la date et les flux
SYNOPSIS
annotate-output [options] [--] programme [paramètres ...]
DESCRIPTION
annotate-output exécute le programme avec paramètres comme arguments et préfixe les lignes affichées avec
une chaîne formatée suivie d’un indicateur pour le flux dans lequel la ligne a été écrite, suivi d’un
deux-points et d’une seule espace.
Les indicateurs de flux sont I pour les informations émises par annotate-output ainsi que O pour STDOUT
et E pour STDERR du programme.
OPTIONS
+FORMAT
Une chaîne de formatage qui peut utiliser les séquences de conversion de l’utilitaire date(1). La
chaîne générée est séparée de l’indicateur de flux qui suit par une seule espace. Ce formatage
peut être remplacé à l’aide d’options subséquentes spécifiant la chaîne de formatage.
Valeur par défaut "%H:%M:%S".
--raw-date-format FORMAT
Une chaîne de formatage qui peut utiliser les séquences de conversion de l’utilitaire date(1). Il
n’y a pas de séparateur entre la chaîne générée et l’indicateur de flux qui suit. Ce formatage
peut être remplacé à l’aide d’options subséquentes spécifiant la chaîne de formatage.
-- Met fin à l’analyse des options (sauf en tant qu’argument d’une option).
-h, --help
Afficher un message d’aide.
VALEURS DE RETOUR
Si le programme est invoqué, le code de retour d’annotate-output est celui du programme ; sinon
annotate-output se termine en renvoyant l’une des valeurs suivantes :
0 -h or --help a été indiqué.
125 Une erreur est survenue dans annotate-output.
126 Le programme a été trouvé mais n’a pas pu être exécuté.
127 Le programme n’a pas été trouvé ou n’a pas été spécifié.
EXEMPLE
$ annotate-output make
21:41:21 I: make démarré
21:41:21 O: gcc -Wall programme.c
21:43:18 E: programme.c: n’a pas compilé et durée de diagnostic dépassée
21:43:19 E: collect2: ld a retourné un code de retour 1
21:43:19 E: make: *** [all] Erreur 1
21:43:19 I: terminé avec un code de retour 2
MISES EN GARDE ET BOGUES
Puisque STDOUT et STDERR sont traités en parallèle, il peut arriver que quelques lignes reçues sur STDOUT
soient affichées avant des lignes de STDERR (et inversement).
C’est malheureusement très difficile à corriger avec la stratégie d’annotation choisie. Une solution
serait de passer à un suivi par PTRACE. Donner avec la valeur nice une (bien) plus grande priorité au
programme exécuté pourrait cependant faire que ce comportement arrive moins fréquemment.
annotate-output nécessite que le programme produise des lignes de texte (telles que spécifiées par POSIX)
sur STDOUT et STDERR.
En particulier, le comportement est indéterminé quand les lignes produites contiennent des octets NUL. Le
comportement peut aussi être indéterminé si les lignes produites contiennent des octets qui ne forment
pas des caractères valables dans la localisation actuelle.
Lorsqu’un programme interactif demande une entrée, la question peut ne pas être affichée tant que vous
n’avez pas répondu. Cela peut donner l’impression que le programme ainsi lancé a gelé, alors que ce n’est
pas le cas.
annotate-output est implémenté en tant que script en langage de commandes du shell. Les shells
définissent généralement des variables (shell) au démarrage et peuvent placer l’attribut « export » sur
certaines d’entre elles. De plus ils initialisent des variables (shell) depuis leur propre environnement
(tel que paramétré par l’invocateur du shell, soit celui d’annotate-output) et placent l’attribut
« export » sur celles-ci.
Il en résulte que quand l’invocateur de annotate-output souhaite définir une variable d’environnement du
programme, celle-ci peut être remplacée ou d’autres variables peuvent être ajoutées par le shell.
Par ailleurs, il n’est en principe pas permis de définir des variables d’environnement (par exemple
« . ») qui ne sont pas des noms valables de variables shell. POSIX ne spécifie pas si de telles variables
d’environnement sont exportées vers les programmes lancés depuis le shell. Aucune présomption ne peut
donc être faite quant à l’exportation correcte ou même incorrecte de telles variables vers le programme.
VOIR AUSSI
date(1)
AIDE
Ce programme est maintenu par la communauté (comprendre : vous allez devoir le corriger vous-même). Les
patches sont toutefois appréciés, ainsi que toute sorte de retour (positif ou non).
AUTEUR
Cette page de manuel a été écrite par Jeroen van Wolffelaar <jeroen@wolffelaar.nl> et peut être
redistribuée sous les termes de la licence GPL version 2. Le script annotate-output lui-même a été
réécrit par Johannes Schauer Marin Rodrigues <josch@debian.org> et peut être redistribué sous les termes
de la licence Expat.
TRADUCTION
Ce document est une traduction, maintenue à lʼaide de lʼoutil po4a <https://po4a.org/> par lʼéquipe de
traduction francophone du projet Debian.
Plusieurs traducteurs dont Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux, David
Prévot et Xavier Guimard ont contribué aux traductions.
Lʼéquipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. Veuillez
signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport
de bogue sur le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours consultable en ajoutant lʼoption « -L C »
à la commande man.
DEBIAN Utilitaires Debian ANNOTATE-OUTPUT(1)