.\" Copyright (c) 1988 Massachusetts Institute of Technology, .\" Student Information Processing Board. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH COM_ERR 3 "22 novembre 1998" SIPB .SH NOM come_err \- Fonction générique d'affichage d'erreurs .SH SYNOPSIS .nf #include void (*\fIproc\fP) (const char *, long, const char *, va_list); .PP void com_err (const char *whoami, long code, const char *format, ...); .PP proc = set_com_err_hook (proc); .PP proc = reset_com_err_hook (); .PP void initialize_XXXX_error_table (); .fi .SH DESCRIPTION \fBcom_err\fP affiche un message d'erreur sur le flux d'erreur standard \fBstderr\fP (voir \fBstdio\fP(3)), contenant la chaîne \fIwhoami\fP, 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 \fIcode\fP (dérivée de \fBcompile_et\fP(1)) et d'une chaîne de \fIformat\fP suivie de paramètres, comme pour \fBfprintf\fP(3). Le comportement de \fBcom_err\fP peut être modifié en utilisant \fIset_com_err_hook\fP, qui définit une procédure appelée avec les paramètres de \fBcom_err\fP 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 \fBsyslog\fP(3). \fIreset_com_err_hook\fP peut être utilisé pour restaurer le comportement de \fBcom_err\fP 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 \fIproc\fP, comme dans le synopsis ci\-dessus. La routine \fIinitialize_XXXX_error_table\fP est générée automatiquement par \fBcompile_et\fP(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 \fIXXXX\fP 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 \fBcom_err\fP puisse reconnaître les codes d'erreur de ces tables quand elles sont utilisées. Le fichier d'en\-tête \fIcom_err.h\fP devrait être inclus dans tous les fichiers source qui utilisent des fonctions de la bibliothèque \fBcom_err\fP\ ; l'édition des liens des fichiers exécutables doit utiliser «\ \fI\-lcom_err\fP\ » pour inclure la bibliothèque \fBcom_err\fP. .\" .IR for manual entries .\" .PP for paragraph breaks .SH "VOIR AUSSI" \fBcompile_et\fP(1), \fBsyslog\fP(3). Ken Raeburn, «\ A Common Error Description Library for UNIX\ » (une bibliothèque générique de description d'erreurs pour UNIX). .SH TRADUCTION La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages\-fr\-extra.