openlog

(PHP 3, PHP 4, PHP 5)

openlog --  Stellt eine Verbindung zum Log-Dienst des Systems her

Beschreibung

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

Die Funktion openlog() kontaktiert die System-Log-Dienste eines Programms. Die Zeichenkette ident wird jeder Meldung angefügt. Werte für die Parameter option und facility werden unten erläutert. Das Argument option wird verwendet, um festzulegen, welche Log-Optionen bei der Erzeugung von Log-Nachrichten verwendet werden sollen. Das Argument facility wird verwendet, um die Art des Programmes festzulegen, das die Nachricht loggt. Dies erlaubt Ihnen (in Ihrer speziellen SysLog-Konfiguration) die Festlegung der Behandlungsweise von Log-Nachrichten. Die Verwendung von openlog() ist optional. Die Funktion wird - falls erforderlich - automatisch von syslog() aufgerufen, dabei wird ident standardmäßig mit FALSE belegt.

Tabelle 1. openlog()-Optionen

KonstanteBeschreibung
LOG_CONS Tritt ein Fehler auf, wenn Daten an den Systemlogger gesendet werden, leite die Ausgabe direkt an die Konsole um.
LOG_NDELAY Öffnet die Verbindung zum Log-Service sofort.
LOG_ODELAY (Standardwert); öffnet die Verbindung erst, wenn die erste Meldung geloggt werden soll.
LOG_PERRORSchreibt den Logeintrag auch in das Standard-Error-Device
LOG_PIDFügt die PID an jede Message an
Sie können eine oder mehrere dieser Optionen verwenden. Benutzen Sie mehrere, müssen diese per OR getrennt werden. Um zum Beispiel die Verbindung sofort herzu stellen, auf die Konsole zu schreiben und zugleich die PID in jede Meldung aufzunehmen, müssen Sie folgendes angeben: LOG_CONS | LOG_NDELAY | LOG_PID.

Tabelle 2. openlog()-Möglichkeiten

KonstanteBeschreibung
LOG_AUTH Sicherheits-/Authorisierungsmeldungen (benutzt statt dessen LOG_AUTHPRIV in Systemen, wo diese Konstante definiert ist).
LOG_AUTHPRIV Sicherheits-/Authorisierungsmeldungen (private).
LOG_CRONZeitabhängig gestartete Dienste (cron und at)
LOG_DAEMONAndere Systemdienste
LOG_KERNKernel-Meldungen
LOG_LOCAL0 ... LOG_LOCAL7Reserviert für lokale Benutzung, diese Konstanten stehen unter Windows nicht zur Verfügung.
LOG_LPRZeilen-Drucker Subsystem.
LOG_MAILMailing-Subsystem.
LOG_NEWSUSENET-News-Subsystem.
LOG_SYSLOGMeldungen die intern von syslogd erzeugt wurden.
LOG_USERGenerische User-Level-Meldungen.
LOG_UUCPUUCP-Subsystem

Anmerkung: LOG_USER ist als Logtyp nur unter Windows gültig.

Siehe auch define_syslog_variables(), syslog() und closelog().