oracular (1) annotate-output.1.gz

Provided by: devscripts_2.24.1_all bug

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.