Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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> >>.