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.57 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> ».