NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <error.h>

       void error(int statut, int numerr, const char *format, ...);
       void error_at_line(int statut, int numerr, const char *nomfichier,
                          unsigned int numligne, 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 numerr est différent de zéro, un second caractère deux-points, une  espace  suivie
       du  contenu  de strerror(numerr). 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  statut possède une valeur non nulle, alors error() appelle exit(3) afin de terminer le programme avec
       la valeur de retour donnée. Sinon il renvoie après avoir affiché le message d'erreur.

       La fonction error_at_line() est identique à error() excepté les arguments supplémentaires  nomfichier  et
       numligne.  L'affichage produit est similaire à celui de error() excepté qu'après le nom du programme sont
       écrits « : », la valeur de nomfichier, « : » et  la  valeur  de  numligne.  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 d’entrée.

       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 nomfichier et numligne 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 afficher une chaîne adaptée sur stderr.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌─────────────────┬──────────────────────┬──────────────────────────────────────────────────────────────┐
       │ Interface       │ Attribut             │ Valeur                                                       │
       ├─────────────────┼──────────────────────┼──────────────────────────────────────────────────────────────┤
       │ error()         │ Sécurité des threads │ MT-Safe locale                                               │
       ├─────────────────┼──────────────────────┼──────────────────────────────────────────────────────────────┤
       │ error_at_line() │ Sécurité des threads │ MT-Unsafe race: error_at_line/error_one_per_line locale      │
       └─────────────────┴──────────────────────┴──────────────────────────────────────────────────────────────┘

       La variable interne error_one_per_line est accédée (sans aucune forme de  synchronisation  mais,  puisque
       c'est  un  int  qui n'est utilisé qu'une seule fois, de façon plutôt sûre) et si error_one_per_line n'est
       pas défini à zéro, les variables internes statiques (pas exposées à l'utilisateur) utilisées pour stocker
       le dernier nom de fichier affiché ainsi que le numéro de ligne sont accédées et modifiées sans synchroni‐
       sation ; la mise à jour n'est pas atomique et survient avant la désactivation  de  l'annulation  et  peut
       donc  être  interrompue  seulement  après  qu'une  des  deux  variables  soit  modifiée.  Après cela, er‐
       ror_at_line() est très similaire à error().

STANDARDS

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

VOIR AUSSI

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

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry Vignaud <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
       Denis  Barbier  <barbier@debian.org>,  David  Prévot <david@tilapin.org> et Grégoire Scano <gregoire.sca‐
       no@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous  reporter  à  la  GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                   15 décembre 2022                                        error(3)