Available in

(2) (3) (4) (5) (7) (3)/de (2)/es (3)/es (2)/fr (3)/fr (5)/hu (2)/ja (3)/ja (5)/ja (2)/ko (2)/nl (3)/pt

Contents

BEZEICHNUNG

closelog, openlog, syslog − Schreib eine Nachricht an den syslog

ÜBERSICHT

#include <syslog.h>

void openlog( char *ident, int option, int facility)

void syslog( int priority, char *format, ...)

void closelog( void )

BESCHREIBUNG

Syslog ist eine Möglichkeit, Nachrichten (z.B. Status- oder Fehlerberichte) an eine zentrale Stelle auf dem System zu schicken und dort zu verarbeiten. Auf der Serverseite muss dazu der syslogd(8) gestartet werden, dieser empfängt die Nachrichten.

openlog() stellt eine Verbindung zum syslog Server für das Programm her. Die Zeichenkette, auf die ident zeigt, wird vor jede Nachricht gehängt und ist normalerweise der Programmname. option und facility werden im nächsten Abschnitt behandelt. Die Benutzung von openlog() ist optional; Gegebenenfalls wird die Routine automatisch von syslog() aufgerufen, wenn es nötig ist, dann wird ident auf NULL gesetzt.

syslog() erzeugt eine Log-Nachricht, die vom syslogd(8) verarbeitet wird. priority ist eine Kombination von facility und einem level, die im nächsten Abschnitt erläutert werden. Die verbleibenden Parameter sind format, wie bei printf(3), und weitere Argumente, die von format benötigt werden, mit der Ausnahme, dass die zwei Zeichen %m durch die Fehlermeldung (strerror) ersetzt werden, die dem aktuellen Wert von errno entsprechen.

closelog() schließt den Deskriptor, der zum Schreiben der Log-Nachrichten benutzt wurde. Die Benutzung von closelog() ist optional.

PARAMETER

Dieser Abschnitt beschreibt die Parameter, die benutzt werden, um die Werte von option, facility, und priority zu setzen.

option
Der Parameter option von openlog() ist eine ODER-Verknüpfung von einer dieser Konstanten:
LOG_CONS

schreibt direkt auf die Systemkonsole, wenn ein Fehler beim Schreiben an den syslog auftritt.

LOG_NDELAY

öffnet sofort eine Verbindung zum syslog (normalerweise wird die Verbindung erst dann hergestellt, wenn die erste Nachricht gelogt werden soll).

LOG_PERROR

schreibt ebenfalls auf die Standardfehlerausgabe stderr.

LOG_PID

logt zusätzlich die Prozess-ID bei jeder Nachricht.

facility
Der Parameter facility wird benutzt, um anzugeben, welche Einrichtung die Nachricht sendet. Dadurch kann mit der Konfigurationsdatei syslog.conf erreicht werden, dass Nachrichten von unterschiedlichen Einrichtungen auch unterschiedlich behandelt werden.
LOG_AUTH

Sicherheits-/Autorisations-Nachrichten. Wurde verworfen. Stattdessen sollte LOG_AUTHPRIV benutzt werden

LOG_AUTHPRIV

Sicherheits-/Autorisations-Nachrichten

LOG_CRON

Uhr-Dämonen) (cron und at)

LOG_DAEMON

andere System-Dämonen

LOG_KERN

Kernel-Nachrichten

LOG_LOCAL0 bis LOG_LOCAL7

reserviert für den lokalen Gebrauch

LOG_LPR

Nachrichten vom Drucker-Subsystem

LOG_MAIL

Nachrichten vom Mail-Subsystem

LOG_NEWS

Nachrichten vom Usenet News-Subsystem

LOG_SYSLOG

Nachrichten, die intern vom syslogd erzeugt wurden

LOG_USER(default)

Generische User-Level Nachrichten

LOG_UUCP

Nachrichten vom UUCP-Subsystem

level
Dieser Parameter gibt die Dringlichkeitsstufe der Nachricht an. Die Level sind, in fallender Wichtigkeit:
LOG_EMERG

Das System ist unbrauchbar

LOG_ALERT

Es müssen dringend Aktionen eingeleitet werden

LOG_CRIT

Kritische Nachricht

LOG_ERR

Fehlernachricht

LOG_WARNING

Warnungen

LOG_NOTICE

Normale, aber bedeutende Nachricht

LOG_INFO

Normale Information

LOG_DEBUG

Debuginformation

GESCHICHTE

Eine syslog−Funktion erschien in BSD 4.2.

SIEHE AUCH

logger(1), syslog.conf(5), syslogd(8).

COMMENTS

blog comments powered by Disqus