error(3) Library Functions Manual error(3)
NOM
error, error_at_line, error_message_count, error_one_per_line, er-
ror_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 st-
dout 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 ca-
ractè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 initia-
lisé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 argu-
ments 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'uti-
lisateur) utilisées pour stocker le dernier nom de fichier affiché ain-
si que le numéro de ligne sont accédées et modifiées sans synchronisa-
tion ; la mise à jour n'est pas atomique et survient avant la désacti-
vation de l'annulation et peut donc être interrompue seulement après
qu'une des deux variables soit modifiée. Après cela, error_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 applications 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 Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Grégoire Scano <gre-
goire.scano@malloc.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 15 décembre 2022 error(3)
Generated by dwww version 1.15 on Sat Jun 29 01:39:42 CEST 2024.