NOM¶
come_err - Fonction générique d'affichage d'erreurs
SYNOPSIS¶
#include <et/com_err.h>
void (* proc) (const char *, long, const char *, va_list);
void com_err (const char *whoami, long code, const char *format, ...);
proc = set_com_err_hook (proc);
proc = reset_com_err_hook ();
void initialize_XXXX_error_table ();
DESCRIPTION¶
com_err affiche un message d'erreur sur le flux d'erreur standard
stderr (voir
stdio(3)), contenant la chaîne
whoami, qui devrait indiquer le nom du programme ou une sous-partie,
suivie par un message d'erreur généré à partir de
la valeur de
code (dérivée de
compile_et(1)) et
d'une chaîne de
format suivie de paramètres, comme pour
fprintf(3).
Le comportement de
com_err peut être modifié en utilisant
set_com_err_hook, qui définit une procédure
appelée avec les paramètres de
com_err au lieu de la
procédure interne qui envoie le texte formaté à la sortie
d'erreur. De cette façon, les messages d'erreur d'un programme peuvent
facilement être déroutés vers une autre forme de
diagnostique, comme
syslog(3).
reset_com_err_hook peut
être utilisé pour restaurer le comportement de
com_err
dans sa forme d'origine. Les deux procédures renvoient la valeur
précédente du « hook ». Ces deux
procédures nécessitent la déclaration de
proc,
comme dans le synopsis ci-dessus.
La routine
initialize_XXXX_error_table est générée
automatiquement par
compile_et(1) à partir d'un fichier
contenant des noms et les chaînes associées. Chaque table a un
nom pouvant aller jusqu'à 4 caractères, qui sera
utilisé pour remplacer les
XXXX dans le nom de la routine. Ces
routines devraient être appelées avant que les codes d'erreur
correspondants soient utilisés pour que la bibliothèque
com_err puisse reconnaître les codes d'erreur de ces tables
quand elles sont utilisées.
Le fichier d'en-tête
com_err.h devrait être inclus dans
tous les fichiers source qui utilisent des fonctions de la bibliothèque
com_err ; l'édition des liens des fichiers
exécutables doit utiliser «
-lcom_err » pour inclure la bibliothèque
com_err.
VOIR AUSSI¶
compile_et(1),
syslog(3).
Ken Raeburn, « A Common Error Description Library for
UNIX » (une bibliothèque générique de
description d'erreurs pour UNIX).
TRADUCTION¶
La traduction de cette page de manuel est maintenue par les membres de la liste
<debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler
toute erreur de traduction par un rapport de bogue sur le paquet
manpages-fr-extra.
