Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       closelog,   openlog,   syslog,   vsyslog   -   Envoyer  un  message  de
       journalisation

SYNOPSIS

       #include <syslog.h>

       void openlog(const char *ident, int option, int facility);
       void syslog(int priority, const char *format, ...);
       void closelog(void);

       #include <stdarg.h>

       void vsyslog(int priority, const char *format, va_list ap);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       vsyslog() : _BSD_SOURCE

DESCRIPTION

       closelog()   ferme  le  descripteur  utilise  pour  la  journalisation.
       L'utilisation de closelog() est facultative.

       openlog() ouvre une connexion de journalisation. La chaine pointee  par
       ident  sera  ajoutee  a  chaque  message  (c'est generalement le nom du
       programme). L'argument  option  precise  les  attributs  controlant  le
       fonctionnement  de  openlog()  et  des  appels  ulterieurs  a syslog().
       L'argument facility est une  valeur  par  defaut  employee  lorsque  ce
       parametre  n'est  pas fourni lors des appels ulterieurs a syslog(). Les
       valeurs pour option et facility sont decrites plus  bas.  L'utilisation
       de  openlog()  est  optionnelle.  Cette  fonction  sera automatiquement
       invoquee par syslog() si besoin. Dans ce cas, ident aura la valeur  par
       defaut NULL.

       syslog() cree un message journalise, qui sera distribue par syslogd(8).
       L'argument priority est une combinaison par OU binaire des  valeurs  de
       facility  et  de level, indiquees plus bas. Les arguments restants sont
       un format, comme celui de printf(3) et tous les  arguments  necessaires
       pour  ce format, sauf que les deux caracteres %m seront automatiquement
       remplaces par le libelle d'erreur strerror(errno).  Un  saut  de  ligne
       final peut etre ajoute si besoin est.

       La  fonction  vsyslog()  realise  la  meme  tache  que  syslog()  a  la
       difference qu'elle prend un ensemble d'arguments obtenus a l'aide de la
       macro stdarg(3) pour les listes variables d'arguments.

       Les  sous-sections  ci-dessous  detaillent les parametres utilises pour
       les valeurs de option, facility et priority.

   option
       L'argument option d'openlog() est un OU binaire  entre  les  constantes
       suivantes :

       LOG_CONS       ecrire  directement  sur la console systeme s'il y a une
                      erreur durant la transmission.

       LOG_NDELAY     ouvrir  la  connexion  immediatement  (normalement,   la
                      connexion  est  ouverte  quand  le  premier  message est
                      transmis).

       LOG_NOWAIT     Ne pas attendre la fin des processus  fils  qui  peuvent
                      etre  crees  lors  de  l'enregistrement  du  message. La
                      bibliotheque glibc ne cree pas de processus fils,  ainsi
                      cette option est sans effet sous Linux.

       LOG_ODELAY     L'inverse de LOG_NDELAY; l'ouverture de la connexion est
                      repoussee jusqu'a l'invocation  de  syslog().  C'est  le
                      comportement  par  defaut,  et  l'option  n'a pas besoin
                      d'etre indiquee.

       LOG_PERROR     (pas dans POSIX.1-2001) ecrire sur stderr egalement.

       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 different des
       messages, en fonction de fichiers de configuration.

       LOG_AUTH       message de securite/autorisation (DECONSEILLE ! Utilisez
                      LOG_AUTHPRIV a la place)

       LOG_AUTHPRIV   message de securite/autorisation (prive).

       LOG_CRON       message d'un demon horaire (cron et at)

       LOG_DAEMON     demon du systeme sans classification particuliere.

       LOG_FTP        demon ftp.

       LOG_KERN       messages  noyau (ils ne peuvent pas etre produit par des
                      processus utilisateurs)

       LOG_LOCAL0 through LOG_LOCAL7
                      reserve pour des utilisations locales.

       LOG_LPR        message du sous-systeme d'impression.

       LOG_MAIL       message du sous-systeme de courrier.

       LOG_NEWS       message du sous-systeme des news USENET.

       LOG_SYSLOG     message interne de syslogd(8)

       LOG_USER (defaut)
                      message utilisateur generique.

       LOG_UUCP       message du sous-systeme UUCP.

   level
       Ceci determine l'importance  du  message.  Les  niveaux,  dans  l'ordre
       d'importance decroissante, sont :

       LOG_EMERG      Le systeme est inutilisable.

       LOG_ALERT      Des actions doivent etre entreprises immediatement.

       LOG_CRIT       Les conditions sont critiques.

       LOG_ERR        Des erreurs se produisent.

       LOG_WARNING    Des avertissement se presentent.

       LOG_NOTICE     Condition normale, mais message significatif.

       LOG_INFO       Message d'information simple.

       LOG_DEBUG      Message de debogage.

       La  fonction  setlogmask(3)  permet  de  restreindre l'enregistrement a
       certains niveaux uniquement.

CONFORMIT'E

       Les fonctions openlog(), closelog() et syslog()  (mais  pas  vsyslog())
       sont  mentionnees  dans  SUSv2  et  POSIX.1-2001.  POSIX.1-2001 indique
       uniquement les valeurs LOG_USER et LOG_LOCAL* pour l'argument facility.
       Neanmoins, a l'exception de LOG_AUTHPRIV et LOG_FTP, les autres valeurs
       pour facility existent sur la plupart  des  systemes  Unix.  La  valeur
       LOG_PERROR  de l'argument option n'est pas mentionnee par POSIX.1-2001,
       mais est disponible dans la plupart des versions d'Unix.

NOTES

       Le parametre ident durant l'appel openlog() est generalement stocke tel
       quel.  Ainsi,  si  la  chaine  vers  laquelle  il  pointe est modifiee,
       syslog() peut afficher la  chaine  modifiee,  et  si  la  chaine  cesse
       d'exister,  le  resultat est indefini. Le comportement le plus portable
       est l'utilisation d'une chaine constante.

       Ne jamais passer directement  une  chaine  fournie  par  l'utilisateur,
       utilisez plutot :

           syslog(priority, "%s", chaine);

VOIR AUSSI

       logger(1), setlogmask(3), syslog.conf(5), syslogd(8)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue a l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).   Nicolas
       Francois et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  ecrivant  a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.