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 ();
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 suivit de paramètres, comme
pour fprintf(3).
Le comportement de com_err peut être modifié en utilisant
set_com_err_hook, qui définie 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 renvoie la valeur précédente du « hook ». Ces deux
procédures nécessite 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 seront utilisés 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 ils sont utilisés.
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.