Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] syslog, vsyslog, openlog, closelog - Envoyer un message de journalisation. [size=18] [b]Résumé[/b] [/size] [b]#include <syslog.h>[/b] [b][i]void openlog (const char * ident , int option , int facility );[/i][/b] [b][i]void syslog (int priority , char * format , ...);[/i][/b] [b][i]void closelog (void );[/i][/b] [b]#include <stdarg.h>[/b] [b][i]void vsyslog (int priority , char * format , va_list ap );[/i][/b] [size=18] [b]Description[/b] [/size] [b]closelog()[/b] ferme le descripteur utilisé pour la journalisation. L'utilisation de [b]closelog()[/b] est facultative. [b]openlog()[/b] ouvre une connection de journalisation. La chaîne pointée par [i]ident [/i] sera ajouteé à chaque message (c'est généralement le nom du programme). L'argument [i]option[/i] précise les attributs contrôlant le fonctionnement de [b]openlog()[/b] et des appels ultérieurs à [b]syslog() .[/b] L'argument [i]facility[/i] est une valeur par défaut employée lorsque ce paramètre n'est pas fourni lors des appels ultérieurs à [b]syslog() .[/b] Les valeurs pour [i]option[/i] et [i]facility[/i] sont décrites plus bas. L'utilisation de [b]openlog()[/b] est optionnelle. Cette fonction sera automatiquement invoquée par [b]syslog()[/b] si besoin. Dans ce cas [i]ident[/i] aura la valeur par défaut NULL. [b]syslog()[/b] crée un message journalisé, qui sera distribué par [b]syslogd (8).[/b] L'argument [i]priority[/i] est une combinaison par OU binaire des valeurs de [i]facility[/i] et de [b]level , [/b] indiquées plus bas. Les arguments restants sont un [b]format ,[/b] comme celui de [b]printf (3)[/b] et tous les arguments nécessaires pour ce [b]format ,[/b] sauf que les deux caractères %m seront automatiquement remplacés par le libelle d'erreur [b]strerror ( errno ).[/b] Un saut de ligne final est ajouté si besoin est. La fonction [b]vsyslog()[/b] réalise la même tâche que [b]syslog()[/b] à la différence qu'elle prend un ensemble d'arguments obtenus à l'aide de la macro [b]stdarg (3)[/b] pour les listes variables d'arguments. [size=18] [b]ParamÈtres[/b] [/size] Cette section détaille les paramètres utilisés pour les valeurs de [b]option , facility , et priority .[/b] [b]Option[/b] L'argument [i]option[/i] de [b]openlog()[/b] est un OU binaire entre les constantes suivantes : [b]LOG_CONS[/b] [table][row][col]    [/col][col]écrire directement sur la console système s'il y a une erreur durant la transmission.[/col][/row][/table] [b]LOG_NDELAY[/b] [table][row][col]    [/col][col]ouvrir la connexion immédiatement (normalement, la connexion est ouverte quand le premier message est transmis).[/col][/row][/table] [b]LOG_NOWAIT[/b] [table][row][col]    [/col][col]Ne pas attendre la fin des processus fils qui peuvent être créés lors d l'enregistrement du message. La bibliothèque GlibC ne crée pas de processus fils, ainsi cette option est sans effet sous Linux.[/col][/row][/table] [b]LOG_ODELAY[/b] [table][row][col]    [/col][col]L'inverse de [b]LOG_NDELAY ;[/b] l'ouverture de la connexion est repoussée jusqu'à l'invocation de [b]syslog() .[/b] C'est le comportement par défaut, et l'option n'a pas besoin d'être indiquée.[/col][/row][/table] [b]LOG_PERROR[/b] [table][row][col]    [/col][col](pas dans SUSv3) écrire sur stderr également.[/col][/row][/table] [b]LOG_PID[/b] [table][row][col]    [/col][col]inclure le PID dans chaque message.[/col][/row][/table] [b]Facility[/b] L'argument [i]facility[/i] permet d'indiquer le type du programme qui demande la journalisation du message. Ceci permet un traitement différent des messages, en fonction de fichiers de configuration. [b]LOG_AUTH[/b] [table][row][col]    [/col][col]message de sécurité/autorisation (DÉCONSEILLÉ ! Utilisez [b]LOG_AUTHPRIV [/b] a la place)[/col][/row][/table] [b]LOG_AUTHPRIV[/b] [table][row][col]    [/col][col]message de sécurité/autorisation (privé).[/col][/row][/table] [b]LOG_CRON[/b] [table][row][col]    [/col][col]message d'un démon horaire [b]( cron et at )[/b][/col][/row][/table] [b]LOG_DAEMON[/b] [table][row][col]    [/col][col]démon du système sans classification particulière.[/col][/row][/table] [b]LOG_FTP[/b] [table][row][col]    [/col][col]démon ftp.[/col][/row][/table] [b]LOG_KERN[/b] [table][row][col]    [/col][col]message du noyau.[/col][/row][/table] [b]LOG_LOCAL0 through LOG_LOCAL7[/b] [table][row][col]    [/col][col]réservé pour des utilisations locales.[/col][/row][/table] [b]LOG_LPR[/b] [table][row][col]    [/col][col]message du sous-système d'impression.[/col][/row][/table] [b]LOG_MAIL[/b] [table][row][col]    [/col][col]message du sous-système de courier.[/col][/row][/table] [b]LOG_NEWS[/b] [table][row][col]    [/col][col]message du sous-système des news USENET.[/col][/row][/table] [b]LOG_SYSLOG[/b] [table][row][col]    [/col][col]message interne de [b]syslogd [/b][/col][/row][/table] [b]LOG_USER (défaut)[/b] [table][row][col]    [/col][col]message utilisateur générique.[/col][/row][/table] [b]LOG_UUCP[/b] [table][row][col]    [/col][col]message du sous-système UUCP. [/col][/row][/table] [b]Level[/b] Ceci détermine l'importance du message. Les niveaux, dans l'ordre d'importance décroissante, sont : [b]LOG_EMERG[/b] [table][row][col]    [/col][col]Le système est inutilisable.[/col][/row][/table] [b]LOG_ALERT[/b] [table][row][col]    [/col][col]Des actions doivent être entreprises immédiatement.[/col][/row][/table] [b]LOG_CRIT[/b] [table][row][col]    [/col][col]Les conditions sont critiques.[/col][/row][/table] [b]LOG_ERR[/b] [table][row][col]    [/col][col]Des erreurs se produisent.[/col][/row][/table] [b]LOG_WARNING[/b] [table][row][col]    [/col][col]Des avertissement se présentent.[/col][/row][/table] [b]LOG_NOTICE[/b] [table][row][col]    [/col][col]Condition normale, mais message significatif.[/col][/row][/table] [b]LOG_INFO[/b] [table][row][col]    [/col][col]Message d'information simple.[/col][/row][/table] [b]LOG_DEBUG[/b] [table][row][col]    [/col][col]Message de debugging.[/col][/row][/table]     La fonction [b]setlogmask (3)[/b] permet de restreindre l'enregistrement à certains niveaux uniquement. [size=18] [b]Conformité[/b] [/size] Les fonctions [b]openlog() ,[/b] [b]closelog() ,[/b] et [b]syslog()[/b] (mais pas [b]vsyslog() )[/b] sont mentionnées dans SUSv2 et POSIX 1003.1-2001. POSIX 1003.1-2001 indique uniquement les valeurs [b]LOG_USER[/b] et [b]LOG_LOCAL[/b] pour l'argument [b]facility .[/b] Néanmoins, à l'exception de [b]LOG_AUTHPRIV[/b] et [b]LOG_FTP ,[/b] les autres valeurs pour [i]facility[/i] existent sur la plupart des systèmes Unix. La valeur [b]LOG_PERROR[/b] de l'argument [i]option[/i] n'est pas mentionnée par POSIX 1003.1-2001, mais est disponible dans la plupart des versions d'Unix. [size=18] [b]Historique[/b] [/size] Une fonction [b]syslog[/b] est appparue dans BSD 4.2. BSD 4.3 documente [b]openlog (),[/b] [b]syslog (),[/b] [b]closelog (),[/b] et [b]setlogmask ().[/b] 4.3BSD-Reno documente aussi [b]vsyslog ().[/b] Bien sûr les premières fonctions v utilisaient le mécanisme [b]<varargs.h> ,[/b] qui n'est pas compatible avec [b]<stdarg.h> .[/b] [size=18] [b]Notes[/b] [/size] Le paramètre [i]ident[/i] durant l'appel [b]openlog()[/b] est généralement stocké tel quel. Ainsi si la chaîne vers laquelle il pointe est modifiée, [b]syslog()[/b] peut afficher la chaîne modifiée, et si la chaîne cesse d'exister, le résultat est indéfini. Le comportement le plus portable est l'utilisation d'une chaîne constante.     Ne jamais passer directement une chaîne fournie par l'utilisateur, utilisez[table][row][col]    [/col][col] syslog ("%s", chaine);[/col][/row][/table] à la place. [size=18] [b]Voir aussi[/b] [/size] [b]logger (1),[/b] [b]setlogmask (3),[/b] [b]syslog.conf (5),[/b] [b]syslogd (8)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier