Fonctions
des bibliothèques (section 3) syslog
Nom
syslog, closelog, openlog - Envoyer un message de journalisation.Synopsis
#include <syslog.h>void openlog (char *ident, int option, int facility)
void syslog (int priority, char *format, ...)
void closelog (void )
Description
closelog() ferme le descripteur utilisé pour la journalisation. L'utilisation de closelog() est optionnelle.openlog() ouvre une connection de journalisation. La chaîne pointée par ident sera ajouteé à chaque message (c'est généralement le nom du programme). Les valeurs de option et facility sont décrites plus bas. L'utilisation de openlog() est optionnelle. Cette fonction sera automatiquement invoquée par syslog() si besoin. Dans ce cas ident aura la valeur par défaut NULL.
syslog() crée un message journalisé, qui sera distribué par syslogd(8) . priority est une combinaison des valeurs de facility et de level, indiquées plus bas. Les arguments restants sont un format, comme celui de printf(3) et tous les arguments nécessaires pour ce format, sauf que les deux caractères %m seront automatiquement remplacés par le libelle d'erreur (strerror) correspondant au code errno.
ParamÈtres
Cette section détaille les paramètres utilisés pour les valeurs de option, facility, et priority.option
L'argument option de openlog() est un OU binaire entre les constantes suivantes :- LOG_CONS
- écrire directement sur la console système s'il y a une erreur durant la transmission.
- LOG_NDELAY
- ouvrir la connexion immédiatement (normalement, la connexion est ouverte quand le premier message est transmis).
- LOG_PERROR
- écrire sur stderr également.
- LOG_PID
- inclure le PID dans chaque message.
facility
L'argument facility 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.- LOG_AUTH
- message de sécurité/autorisation (DéCONSEILLé ! Utilisez LOG_AUTHPRIV a la place)
- LOG_AUTHPRIV
- message de sécurité/autorisation (privé).
- LOG_CRON
- message d'un démon horaire (cron et at)
- LOG_DAEMON
- message d'un autre démon du système.
- LOG_KERN
- message du noyau.
- LOG_LOCAL0 through LOG_LOCAL7
- réservé pour des utilisations locales.
- LOG_LPR
- message du sous-système d'impression.
- LOG_MAIL
- message du sous-système de courier.
- LOG_NEWS
- message du sous-système des news USENET.
- LOG_SYSLOG
- message interne de syslogd
- LOG_USER(default)
- message utilisateur générique.
- LOG_UUCP
- message du sous-système UUCP.
level
Ceci détermine l'importance du message. Les niveaux, dans l'ordre d'importance décroissante, sont :- LOG_EMERG
- Le système est inutilisable.
- LOG_ALERT
- Des actions doivent être entreprises immédiatement.
- LOG_CRIT
- Les conditions sont critiques.
- LOG_ERR
- Des erreurs se produisent.
- LOG_WARNING
- Des avertissement se présentent.
- LOG_NOTICE
- Condition normale, mais message significatif.
- LOG_INFO
- Message d'information simple.
- LOG_DEBUG
- Message de debugging.
Historique
Une fonction syslog est appparue dans BSD 4.2.Voir Aussi
logger(1) , syslog.conf(5) , syslogd(8)
Traduction
Christophe Blaess, 1997.