Rechercher une page de manuel
syslog
Langue: de
Version: 3. Juni 1996 (openSuse - 09/10/07)
Section: 3 (Bibliothèques de fonctions)
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).Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre