openlog

(PHP 3, PHP 4 , PHP 5)

openlog -- Ouvre la connexion à l'historique système

Description

int openlog ( string ident, int option, int facility )

openlog() ouvre la connexion à l'historique système. La chaîne ident sera ajoutée à chaque message. Les valeurs de option et facility sont données ci-dessous. facility sert à indiquer quel programme enregistre ce message. Cela vous permet de spécifier (sur la machine d'historique) comment traiter les messages venant de plusieurs serveurs. L'utilisation de openlog() est optionnelle. Cette fonction sera automatiquement appelée par la fonction syslog() si nécessaire, auquel cas ident vaudra par défaut FALSE.

Tableau 1. Options openlog()

ConstanteDescription
LOG_CONS Si une erreur survient lors de l'envoi des données au gestionnaire d'historique, écrire directement l'erreur sur la console.
LOG_NDELAY Ouvre immédiatement une connexion au gestionnaire d'historique
LOG_ODELAY Retarde l'ouverture de la connexion jusqu'à ce que le premier message soit enregistré (par défaut)
LOG_PERROREnvoie le message au gestionnaire standard
LOG_PIDInclut le PID à chaque message
Vous pouvez utiliser une ou plusieurs de ces options. Pour les combiner, utiliser l'opérateur OR. Par exemple, pour ouvrir immédiatement la connexion, écrire sur la console et inclure le PID de chaque message, utilisez : LOG_CONS | LOG_NDELAY | LOG_PID.

Tableau 2. Paramètre facility de openlog()

ConstanteDescription
LOG_AUTH sécurité/messages d'autorisation (utilisez LOG_AUTHPRIV, pour remplacer cette constante sur les systèmes où elle est définie).
LOG_AUTHPRIVsécurité/messages d'autorisation (privé)
LOG_CRONdémon horloge (cron et at)
LOG_DAEMONautres démons système
LOG_KERNnoyau (kernel)
LOG_LOCAL0 ... LOG_LOCAL7réservé pour utilisation locale. Inutilisable sous Windows
LOG_LPRimprimante (line printer subsystem)
LOG_MAILmessagerie mail
LOG_NEWSUSENET : groupes de news (newsgroup)
LOG_SYSLOGmessages générés en interne par syslogd
LOG_USERmessages utilisateurs génériques
LOG_UUCPUUCP subsystem

Note : LOG_USER est le seul type valide sous les environnements Windows.

Voir aussi define_syslog_variables(), syslog() et closelog().