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.