openlog

(PHP 3, PHP 4 )

openlog --  Stellt eine Verbindung zu einem Log-Dienst des Systems her

Beschreibung:

int 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-Konfiguartion) die Festlegung der Behandlungsweise von Log-Nachrichten. Der Gebrauch von openlog() ist optional. Er wird - falls erforderlich - automatisch aufgerufen von syslog(). Dann ist der Vorgabewert von ident falsch / FALSE.

Tabelle 1. openlog() Options

KonstanteBeschreibung
LOG_CONS Tritt ein Fehler auf beim Senden von Daten an den System-Logging-Service, wird direkt an die System-Konsole ausgegeben.
LOG_NDELAY Öffnet sofort die Verbindung zum Log-Service.
LOG_ODELAY (Voreinstellung); öffne die Verbindung erst, wenn die erste Meldung geloggt werden soll.
LOG_PERROR Gib die Log-Meldungen auch an der Standard-Ausgabe für Fehler aus.
LOG_PIDSchließe die PID bei jeder Meldung ein.
Sie können eine oder mehrere dieser Optionen verwenden. Benutzen Sie mehrere, müssen diese per OR getrennt werden. Um die Verbindung sofort herzu stellen, auch auf die Konsole zu schreiben und die PID in jede Meldung auf zu nehmen, müssen Sie folgendes angeben: LOG_CONS | LOG_NDELAY | LOG_PID.

Tabelle 2. openlog()-Möglichkeiten

KonstanteBeschreibung
LOG_AUTH Security- / Authorization-Meldungen (benutzt statt dessen LOG_AUTHPRIV in Systemen, wo diese Konstante definiert ist).
LOG_AUTHPRIV Security- / Authorization-Meldungen (private).
LOG_CRON Zeitabhängig gestartete Dienste (Dämonen wie cron and at).
LOG_DAEMONAndere System-Dienste (Dämonen).
LOG_KERNKernel-Meldungen.
LOG_LOCAL0 ... LOG_LOCAL7Reserviert für lokale Benutzung.
LOG_LPRZeilen-Drucker Subsystem.
LOG_MAILMailing-Subsystem.
LOG_NEWSUSENET-News-Subsystem.
LOG_SYSLOG Meldungen die intern von syslogd erzeugt wurden.
LOG_USERGenerische User-Level-Meldungen.
LOG_UUCPUUCP-Subsystem

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