.\" -*- coding: UTF-8 -*- .\" Written Feb 1994 by Steve Greenland (stevegr@neosoft.com) .\" and Copyright 2001, 2017 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Updated 1999.12.19 by Karl M. Hegbloom .\" .\" Updated 13 Oct 2001, Michael Kerrisk .\" Added description of vsyslog .\" Added descriptions of LOG_ODELAY and LOG_NOWAIT .\" Added brief description of facility and option arguments .\" Added CONFORMING TO section .\" 2001-10-13, aeb, minor changes .\" Modified 13 Dec 2001, Martin Schulze .\" Modified 3 Jan 2002, Michael Kerrisk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSLOG 3 "15. September 2017" Linux Linux\-Programmierhandbuch .SH BEZEICHNUNG closelog, openlog, syslog, vsyslog \- verschickt Nachrichten an die Systemprotokollierung .SH ÜBERSICHT \fB#include \fP .PP \fBvoid openlog(const char *\fP\fIident\fP\fB, int \fP\fIoption\fP\fB, int \fP\fIfacility\fP\fB);\fP .br \fBvoid syslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, …);\fP .br \fBvoid closelog(void);\fP .PP \fBvoid vsyslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP .PP .in -4n Mit Glibc erforderliche Makros (siehe \fBfeature_test_macros\fP(7)): .in .PP \fBvsyslog\fP(): Seit Glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 und älter: _BSD_SOURCE .SH BESCHREIBUNG .SS openlog() \fBopenlog\fP() öffnet für ein Programm eine Verbindung zum Syslog\-Daemon. .PP Die Zeichenkette \fIident\fP wird jeder Nachricht vorangestellt und wird üblicherweise auf den Programmnamen gesetzt. Falls \fIident\fP gleich NULL ist, wird der Programmname benutzt. (POSIX.1\-2008 enthält keine Spezifikation für den Fall, dass \fIident\fP gleich NULL ist) .PP Der \fIoption\fP\-Parameter definiert Schalter, welche die Ausführung von \fBOpenlog\fP und darauffolgende Aufrufe von \fBsyslog\fP() steuern. Der \fIfacility\fP\-Parameter definiert einen Standardwert, welcher benutzt wird, falls in darauffolgenden \fBsyslog\fP()\-Aufrufen nichts spezifiziert wurde. Die Werte, die für \fIoption\fP und \fIfacility\fP angegeben werden dürfen, werden weiter unten beschrieben. .PP .\" Die Benutzung von \fBopenlog()\fP ist optional; gegebenenfalls wird die Routine automatisch von \fBsyslog()\fP aufgerufen, wenn es nötig ist, dann wird \fIident\fP auf NULL gesetzt. .SS "syslog() und vsyslog()" \fBsyslog()\fP erzeugt eine Protokoll\-Nachricht, die vom \fBsyslogd\fP(8) verteilt wird. .PP Der Parameter \fIpriority\fP ist das Ergebnis einer ODER\-Verknüpfung eines Werts \fIfacility\fP und eines Werts \fIlevel\fP (weiter unten beschrieben). Falls kein Wert \fIfacility\fP mit \fIpriority\fP ODER\-verknüpft wird, dann wird der durch \fBopenlog\fP() gesetzte Vorgabewert verwandt, oder, falls es keinen vorhergehenden Aufruf \fBopenlog\fP() gab, die Vorgabe \fBLOG_USER\fP verwandt. .PP Die verbleibenden Parameter sind \fIformat\fP, wie bei \fBprintf\fP(3) und weitere Parameter, die von \fIformat\fP benötigt werden. Allerdings wird die Zwei\-Zeichen\-Folge %m durch die Fehlermeldung \fIstrerror\fP(\fIerrno\fP) ersetzt werden. Die Formatzeichenkette muss kein abschließendes Zeilenumbruchzeichen enthalten. .PP .\" Die Funktion \fBvsyslog\fP() führt die gleiche Aufgabe aus wie \fBsyslog\fP(), mit dem Unterschied, dass sie eine Liste an Parametern erhält, die mit Makros aus der \fBstdarg\fP(3)\-Variablenliste abgefragt werden. .SS closelog() .\" \fBcloselog()\fP schließt den Dateideskriptor, der zum Schreiben der Protokoll\-Nachrichten benutzt wurde. Die Benutzung von \fBcloselog()\fP ist optional. .SS "Werte für \fIoption\fP" Der Parameter \fIoption\fP von \fBopenlog\fP() ist eine Bitmaske, die durch ODER\-Verknüpfung beliebiger der folgenden Werte erstellt wird: .TP 15 \fBLOG_CONS\fP schreibt direkt auf die Systemkonsole, falls ein Fehler beim Schreiben an die Systemprotokollierung auftritt. .TP \fBLOG_NDELAY\fP öffnet die Verbindung sofort (normalerweise wird die Verbindung geöffnet, wenn die erste Nachricht protokolliert wird). Dies kann zum Beispiel nützlich sein, falls durch ein nachfolgendes \fBchroot\fP(2) die intern von der Protokollierungseinrichtung verwandten Pfadnamen unerreichbar werden würden. .TP \fBLOG_NOWAIT\fP wartet nicht auf Kindprozesse, welche eventuell beim Protokollieren der Nachricht erzeugt wurden. (Die GNU\-C\-Bibliothek erzeugt keine Kindprozesse, insofern hat diese Option keine Auswirkung unter Linux.) .TP \fBLOG_ODELAY\fP das Gegenteil von \fBLOG_NDELAY\fP; das Öffnen der Verbindung wird bis zum Aufruf von \fBsyslog\fP() verzögert. (Das ist das Standardverhalten und muss nicht angegeben werden.) .TP \fBLOG_PERROR\fP (nicht in POSIX.1\-2001 oder POSIX.1\-2008) die Nachricht auch nach \fIstderr\fP protokollieren. .TP \fBLOG_PID\fP .\" füge die PID des Aufrufenden in jede Nachricht ein. .SS "Werte für \fIfacility\fP" Der Parameter \fIfacility\fP wird benutzt, um anzugeben, welcher Programmtyp die Nachricht protokolliert. Dadurch kann mit der Konfigurationsdatei \fIsyslog.conf\fP erreicht werden, dass Nachrichten von unterschiedlichen Einrichtungen auch unterschiedlich behandelt werden. .TP 15 \fBLOG_AUTH\fP Sicherheits\-/Autorisations\-Nachrichten .TP \fBLOG_AUTHPRIV\fP Sicherheits\-/Autorisations\-Nachrichten (privat) .TP \fBLOG_CRON\fP Uhr\-Daemon (\fBcron\fP und \fBat\fP) .TP \fBLOG_DAEMON\fP System\-Daemonen ohne spezielle Einrichtungswerte .TP \fBLOG_FTP\fP FTP\-Daemon .TP \fBLOG_KERN\fP .\" LOG_KERN has the value 0; if used as a facility, zero translates to: .\" "use the default facility". Kernel\-Nachrichten (diese können nicht von Benutzerprozessen erzeugt werden) .TP \fBLOG_LOCAL0\fP bis \fBLOG_LOCAL7\fP reserviert für den lokalen Gebrauch .TP \fBLOG_LPR\fP Zeilendrucker\-Untersystem .TP \fBLOG_MAIL\fP Mail\-Subsystem .TP \fBLOG_NEWS\fP Usenet Nachrichten\-Untersystem .TP \fBLOG_SYSLOG\fP Nachrichten, die intern vom \fBsyslogd\fP(8) erzeugt wurden .TP \fBLOG_USER\fP (Standardwert) generische Nachrichten auf Anwenderebene .TP \fBLOG_UUCP\fP .\" UUCP\-Subsystem .SS "Werte für \fIlevel\fP" Dieser Parameter gibt die Dringlichkeitsstufe der Nachricht an. Die Stufen sind in absteigender Wichtigkeit: .TP 15 \fBLOG_EMERG\fP Das System ist unbrauchbar. .TP \fBLOG_ALERT\fP Es muss sofort gehandelt werden. .TP \fBLOG_CRIT\fP kritische Bedingungen .TP \fBLOG_ERR\fP Fehlerbedingungen .TP \fBLOG_WARNING\fP Warnungsbedingungen .TP \fBLOG_NOTICE\fP normale, aber bedeutende Bedingung .TP \fBLOG_INFO\fP Information .TP \fBLOG_DEBUG\fP Debuginformation .PP Die Funktion \fBsetlogmask\fP(3) kann dazu benutzt werden, um das Protokollieren auf bestimmte Level einzuschränken. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbw21 lb lb l l l. Schnittstelle Attribut Wert T{ \fBopenlog\fP(), \fBcloselog\fP() T} Multithread\-Fähigkeit MT\-Safe T{ \fBsyslog\fP(), \fBvsyslog\fP() T} Multithread\-Fähigkeit MT\-Safe env locale .TE .SH "KONFORM ZU" Die Funktionen \fBopenlog\fP(), \fBcloselog\fP() und \fBsyslog\fP() (aber nicht \fBvsyslog\fP()) sind in SUSv2, POSIX.1\-2001, and POSIX.1\-2008 spezifiert. .PP POSIX.1\-2001 spezifiert nur die Werte \fBLOG_USER\fP und \fBLOG_LOCAL*\fP für \fIfacility\fP. Auf den meisten UNIX Systemen gibt es jedoch auch die anderen \fIfacility\fP\-Optionen mit der Ausnahme von \fBLOG_AUTHPRIV\fP und \fBLOG_FTP\fP. .PP .\" .SH HISTORY .\" A .\" .BR syslog () .\" function call appeared in 4.2BSD. .\" 4.3BSD documents .\" .BR openlog (), .\" .BR syslog (), .\" .BR closelog (), .\" and .\" .BR setlogmask (). .\" 4.3BSD-Reno also documents .\" .BR vsyslog (). .\" Of course early v* functions used the .\" .I .\" mechanism, which is not compatible with .\" .IR . Der Wert \fBLOG_PERROR\fP für den Parameter \fIoption\fP ist in POSIX.1\-2001 oder POSIX.1\-2008 nicht spezifiert, aber auf den meisten UNIX\-Versionen verfügbar. .SH ANMERKUNGEN Das Argument \fIident\fP im Aufruf von \fBopenlog\fP() wird wahrscheinlich unverändert gespeichert. Falls sich demnach die Zeichenkette, auf die sich \fIident\fP bezieht, ändert, kann \fBsyslog\fP() die geänderte Zeichenkette voranstellen. Falls die Zeichenkette nicht mehr gefunden werden kann, ergibt dies ein undefiniertes Ergebnis. Die portabelste Lösung ist die Verwendung einer konstanten Zeichenkette. .PP Übergeben Sie niemals eine Zeichenkette, die Daten von Benutzeriengaben enthält, als Format, sondern benutzen Sie das Folgende: .PP .in +4n .EX syslog(priority, "%s", string); .EE .in .SH "SIEHE AUCH" \fBjournalctl\fP(1), \fBlogger\fP(1), \fBsetlogmask\fP(3), \fBsyslog.conf\fP(5), \fBsyslogd\fP(8) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 5.04 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Gerd Koenig erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@\:lists.\:debian.\:org Mailingliste der Übersetzer .ME .