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.

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.