Loading

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.