SYSLOG(3)          Manuel du programmeur Linux          SYSLOG(3)


NOM
       syslog, closelog, openlog - Envoyer un message de journal­
       isation.

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  journali­
       sation. 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 automa­
       tiquement 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.



Linux                    10 Novembre 1996                       1





SYSLOG(3)          Manuel du programmeur Linux          SYSLOG(3)


       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.




Linux                    10 Novembre 1996                       2





SYSLOG(3)          Manuel du programmeur Linux          SYSLOG(3)


       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.



























Linux                    10 Novembre 1996                       3