Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

44 2 Programmieren mit Unix-Prozessen
Zentrale Konfiguration der Schwellwerte: Für alle systemweiten Protokolldateien
kann ein Schwellwert definiert werden, der angibt, ab welchem Gewicht
eine eintreffende Nachricht in die entsprechende Log-Datei aufgenommen
werden soll.
Kurz zusammengefaßt ermöglicht der Syslog-Dienst das einfache Protokollieren
von Zustandsmeldungen und Fehlerausgaben. Anwendungsprogramme
können jederzeit alle Meldungen an den Syslog-Dienst übertragen. Vom Systemadministrator
kann dann – ohne Neustart oder gar Änderung der Applikation
– anhand der Art der Anwendung oder der Priorität der Meldung eine
Auswahl der tatsächlich zu protokollierenden Nachrichten getroffen werden.
Die Programmierschnittstelle 6 des Syslog-Diensts bietet im wesentlichen die
folgenden drei Funktionen zur vereinfachten Klassifizierung und Ausgabe von
Nachrichten:
#include
void openlog( const char *ident, int logopt ,
int facility );
void syslog( int priority , const char *message , ... );
void closelog( void );
Die syslog()-Funktion gibt die aus dem Parameter message in Verbindung
mit den nachfolgenden Argumenten formatierte Nachricht an den Syslog-
Dienst weiter. Die Formatierung der Nachricht entspricht, bis auf eine kleine
Ergänzung, dem Verfahren der printf()-Funktion. Neben den von printf()
bekannten Umwandlungszeichen versteht syslog() noch die Zeichenfolge %m,
durch welche der zu errno zugehörige Fehlertext eingesetzt wird. Gültige
Werte für den Parameter priority erhält man durch Oder-Verknüpfung der
in festgelegten Konstanten für die Priorität und (optional) die
Kategorie der auszugebenden Meldung.
Über die Funktion openlog() werden die Standards für alle im weiteren
Verlauf der Anwendung erzeugten Nachrichten festgelegt. Die Zeichenkette
ident wird dann in alle Nachrichten eingebettet, in aller Regel wird hier
der Programmname des laufenden Programms hinterlegt. Über den Parameter
logopt können zusätzliche Features ausgewählt werden. Die Angabe von
LOG_PID bewirkt z. B., daß jede Meldung mit der Prozeßnummer (PID) des
aktuellen Prozesses versehen wird. Die verschiedenen möglichen Werte für
logopt werden ebenfalls in definiert. Mit closelog() wird die
Ausgabe auf den Syslog-Dienst abgeschlossen.
6 Die Programmierschnittstelle ist durch das X/Open System Interface, eine Erweiterung
zu IEEE Std 1003.1-2001, definiert.