NOM

       error,  error_at_line,  error_message_count,  error_one_per_line,  error_print_progname  -  Fonctions  de
       compte-rendu d'erreurs de la glibc

SYNOPSIS

       #include <error.h>

       void error(int status, int errnum, const char *format, ...);

       void error_at_line(int status, int errnum, const char *filename,
                          unsigned int linenum, const char *format, ...);

       extern unsigned int error_message_count;

       extern int error_one_per_line;

       extern void (*error_print_progname) (void);

DESCRIPTION

       error() est une fonction générique de rapport d'erreurs. Elle vide stdout, et affiche sur stderr, le  nom
       du  programme,  un  caractère  deux-points,  une espace, le message spécifié par la chaîne format dans le
       format printf(3) et si errnum est différent de zéro, un second caractère deux-points, une  espace  suivie
       du  contenu  de strerror(errnum). Tout argument de format doit suivre format dans la liste des arguments.
       L'affichage se termine par un retour à la ligne.

       Le nom du programme affiché par error() est la valeur de la variable globale  program_invocation_name(3).
       program_invocation_name est initialisée à la même valeur que l'argument argv[0] de la fonction main(). La
       valeur de cette variable peut être modifiée pour changer l'affichage de error().

       Si  status possède une valeur non nulle, alors error() appelle exit(3) afin de terminer le programme avec
       la valeur de retour donnée.

       La fonction error_at_line() est identique à error(), excepté les arguments  supplémentaires  filename  et
       linenum.  L'affichage produit est similaire à celui de error(), excepté qu'après le nom du programme sont
       écrits « : », la valeur de filename, « : » et la valeur de linenum. Les paramètres __LINE__  et  __FILE__
       du  préprocesseur  peuvent  être  utiles  lors de l'utilisation de error_at_line(), mais d'autres valeurs
       peuvent aussi être utilisées. Par exemple, ces arguments peuvent faire référence à l'emplacement dans  un
       fichier.

       Si  la  variable  globale  error_one_per_line est définie à une valeur non nulle, une séquence d'appels à
       error_at_line() avec les mêmes valeurs de filename et linenum ne produira qu'un seul  message  de  sortie
       (le premier).

       La variable globale error_message_count compte le nombre de messages qui ont été affichés avec error() et
       error_at_line().

       Si  la  variable  globale  error_print_progname  est  assignée  à l'adresse d'une fonction (c'est-à-dire,
       différent de NULL), alors cette fonction est appelée au lieu de  préfixer  le  message  avec  le  nom  du
       programme et « : ». La fonction doit affiché une chaîne de caractère sur stderr.

CONFORMITÉ

       Ces  fonctions  et  ces  variables  sont  des  extensions  GNU  et ne doivent pas être utilisées pour des
       applications portables.

VOIR AUSSI

       err(3), errno(3), exit(3), perror(3), program_invocation_name(3), strerror(3)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

GNU                                               29 août 2010                                          ERROR(3)