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 execute program avec args 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 séparateur et d'un space.
The stream indicators are I for information from annotate-output as well as O for STDOUT and E for STDERR from program.

OPTIONS¶

+FORMAT

A format string that may use the conversion specifiers from the date(1)-utility. The printed string is separated from the following stream indicator by a single space. May be overridden by later options that specify the format string.
Valeur par défaut "%H:%M:%S".

--raw-date-format FORMAT

A format string that may use the conversion specifiers from the date(1)-utility. There is no separator between the printed string and the following stream indicator. May be overridden by later options that specify the format string.

--

Ends option parsing (unless it is itself an argument to an option).

-h, --help

Afficher un message d'aide.

VALEURS DE RETOUR¶

If program is invoked, the exit status of annotate-output shall be the exit status of program; otherwise, annotate-output shall exit with one of the following values:

0

-h or --help a été indiqué.

125

Une erreur est survenue dans annotate-output.

126

program was found but could not be invoked.

127

program could not be found or was not specified.

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 sortie 1
21:43:19 E: make: *** [all] Erreur 1
21:43:19 I: terminé avec un code de sortie 2

CAVEATS AND BUGS¶

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 à nice une (bien) plus grande priorité par rapport au programme exécuté pourrait cependant éviter que ce comportement n'arrive trop fréquemment.

annotate-output expects program to output (text) lines (as specified by POSIX) to STDOUT and STDERR.
In particular, it leads to undefined behaviour when lines are printed that contain NUL bytes. It further may lead to undefined behaviour when lines are printed that contain bytes that do not form valid characters in the current locale.

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 is implemented as a script in the Shell Command Language. Shells typically set various (shell) variables when started and may set the `export` attribute on some of them. They further initialise (shell) variables from their own environment (as set by the caller of the shell respectively the caller of annotate-output) and set the `export` attribute on them.
It follows from this, that when the caller of annotate-output wants to set the environment (variables) of program, they may get overridden or additional ones may get added by the shell.
Further, environment variables are in principle allowed to have names (for example `.`) that are not valid shell variable names. POSIX does not specify whether or not such environment variables are exported to programs invoked from the shell. No assumptions can thus be made on whether such environment variables will be exported correctly or at all to program.

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.

Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux et David Prévot ont réalisé cette traduction.

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.