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.

SIPB                                            22 novembre 1998                                      COM_ERR(3)