openlog

(PHP 3, PHP 4 )

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. L'utilisation de openlog() est optionnelle; cette fonction sera automatiquement appelée par syslog() si nécessaire, et dans ce cas, l'identification sera mise par défaut à FALSE. 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 optionnel. 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 local. 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érique
LOG_UUCPUUCP subsystem

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