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 message 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 quant 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.