%
% syslogd.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel syslogd %%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Syslogd - logging Daemon}
\marklabel{MENUSYSTEMSYSLOGD}{}
\index{SYSLOGD}


\section{Allgemein}


    \glqq{}Syslogd\grqq{} bietet ein Systemdienstprogramm, welches die
    Systemprotokollierung und das Schreiben von Kernelnachrichten
    unterst"utzt. Durch die weitere Unterst"utzung von Internet- und
    Unix-Domain-Sockets kann Syslogd sowohl die lokale als auch f"ur
    die Remote-Protokollierung benutzt werden.

    Die Systemprotokollierung wird durch eine Version von syslogd
    bereitgestellt, die aus den BSD-Standardquellen abgeleitet ist. Die
    Kernel-Protokollierung wird in der benutzen Version direkt durch
    den Prozess syslogd unterst"utzt.

    Syslogd bietet eine Art Protokollierung, die viele moderne Programme
    verwenden. Jede protokollierte Nachricht enth"alt mindestens eine Zeit
    und ein Feld f"ur den Hostnamen, normalerweise auch ein Feld f"ur den
    Programmnamen. Dies h"angt jedoch davon ab, wie vertrauensw"urdig das
    Protokollierungsprogramm ist.



\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & 1. &  System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & 3. &  Logging administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & 1. &  Logfile view \\
    & 2. &  Syslogd administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}llll}
    & 1. &  View documentation \\
    & 2. &  Edit configuration \\
    & 3. &  Advanced configuration file handling \\
    & 4. &  Show status \\
    & 5. &  Stop service \\
    & 6. &  Start service \\
    & 7. &  Logfile view \\
    \end{tabular}
\eline
    \begin{tabular}{p{4cm}llll}
    &   Das Men"u 'Logfile View' stellt die verschiedenen Logfiles da, \\
    &   die in der Syslogd Konfiguration, angelegt wurden. Die Anzahl \\
    &   der Eintr"age ist also von der Konfiguration abh"angig. \\
    & \\
    \end{tabular}
\eline
    \begin{tabular}{p{4cm}llll}
    & x. &  View messages \\
    & x. &  View older messages \\
    & x. &  View log.sudo \\
    & x. &  View older log.sudo \\
    & x. &  View antispam*.log \\
    & x. &  View older antispam*.log \\
    & x. &  View log.eis-install \\
    & x. &  View older log.eis-install \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration wird "uber den Men"upunkt \glqq{}Edit configuration\grqq{}
    ge"andert.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, welche "uber das Men"u zug"anglich ist,
    sind folgende Parameter vorhanden; wer sie von Hand edieren will,
    findet sie unter \\
    \texttt{/etc/config.d/syslogd}.


\section{Die Parameter}

\begin{description}

\config{START\_SYSLOGD}
{START\_SYSLOGD}
{STARTSYSLOGD}
{
    Wird diese Variable auf 'yes' gesetzt, so started der Systemlog-Dienst.
    Dieser Dienst kann sowohl lokale Ereignisse als auch Ereignisse von
    anderen PCs (wie z.B. dem \fli-Router) aufzeichnen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_SYSLOGD='yes'}
}


\config{SYSLOGD\_DEST\_N}
{SYSLOGD\_DEST\_N}
{SYSLOGDDESTN}
{
    Diese Variable gibt die Anzahl der eingestellten Systemlogziele
    wieder. Je mehr Ziele man braucht, umso h"oher wird hier die Zahl

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_N='1'}
}


\config{SYSLOGD\_DEST\_x\_NAME}
{SYSLOGD\_DEST\_x\_NAME}
{SYSLOGDDESTxNAME}
{
    An dieser Stelle kann eine Beschreibung hinterlegt werden,
    z. B. zum Zweck dieses SYSLOGD-Jobs oder irgend etwas anderes.
    SYSLOGD wertet diesen Parameter nicht aus.

    G"ultige Werte: Name

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_NAME='syslogd'}
}


\config{SYSLOGD\_DEST\_x\_ACTIVE}
{SYSLOGD\_DEST\_x\_ACTIVE}
{SYSLOGDDESTxACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz aktiv
    sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_ACTIVE='no'}
}


\config{SYSLOGD\_DEST\_x\_SOURCE\_N}
{SYSLOGD\_DEST\_x\_SOURCE\_N}
{SYSLOGDDESTxSOURCEN}
{
    Bei diesem Parameter wird angegeben, wieviele SYSLOGD Quelldefinitionen
    konfiguriert werden sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_SOURCE\_N='1'}
}


\config{SYSLOGD\_DEST\_x\_SOURCE\_x\_NAME}
{SYSLOGD\_DEST\_x\_SOURCE\_x\_NAME}
{SYSLOGDDESTxSOURCExNAME}
{
    An dieser Stelle kann eine Beschreibung hinterlegt werden,
    z. B. Quelle hier genutzt wird.
    SYSLOGD wertet diesen Parameter nicht aus.

    G"ultige Werte: Name

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_SOURCE\_x\_NAME='{}'}
}


\config{SYSLOGD\_DEST\_x\_SOURCE\_x\_ACTIVE}
{SYSLOGD\_DEST\_x\_SOURCE\_x\_ACTIVE}
{SYSLOGDDESTxSOURCExACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Quelldefintion aktiv
    sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_SOURCE\_x\_ACTIVE='no'}
}


\config{SYSLOGD\_DEST\_x\_SOURCE\_x}
{SYSLOGD\_DEST\_x\_SOURCE\_x}
{SYSLOGDDESTxSOURCEx}
{
    Dieser Parameter gibt das Ereignis des Systemlogs an.

\begin{verbatim}
    Beispiel 1: '*.*'
    Beispiel 2: 'kern.info'
\end{verbatim}

    G"ultige Werte: siehe Beispiel

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_SOURCE\_x='*.*'}
}


\config{SYSLOGD\_DEST\_x\_TARGET}
{SYSLOGD\_DEST\_x\_TARGET}
{SYSLOGDDESTxTARGET}
{
    Dieser Parameter gibt das Ziel des Systemlogs an.

\begin{verbatim}
    Beispiel 1: '/var/log/messages'
    Beispiel 2: '@192.168.6.2'
    Beispiel 3: '/dev/console'
\end{verbatim}

    G"ultige Werte: Pfad zur Log Datei, etc..

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_TARGET='/var/log/messages'}
}


\config{SYSLOGD\_DEST\_x\_PREROTATE\_CMD}
{SYSLOGD\_DEST\_x\_PREROTATE\_CMD}
{SYSLOGDDESTxPREROTATECMD}
{
    Diese Variable beschreibt die Aktion, die ausgef"uhrt wird, bevor ein
    Logrotate ausgef"uhrt wird.

    G"ultige Werte: absoluter Pfad zur auszuf"uhrenden Datei

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_PREROTATE\_CMD='{}'}
}


\config{SYSLOGD\_DEST\_x\_POSTROTATE\_CMD}
{SYSLOGD\_DEST\_x\_POSTROTATE\_CMD}
{SYSLOGDDESTxPOSTROTATECMD}
{
    Diese Variable beschreibt die Aktion, die ausgef"uhrt wird, nachdem ein
    Logrotate ausgef"uhrt wurde.

    G"ultige Werte: absoluter Pfad zur auszuf"uhrenden Datei

    Standardeinstellung: \texttt{SYSLOGD\_DEST\_x\_POSTROTATE\_CMD='/usr/sbin/service restart syslogd'}
}


\config{SYSLOGD\_MARK\_INTERVAL}
{SYSLOGD\_MARK\_INTERVAL}
{SYSLOGDMARKINTERVAL}
{
    "Uber diesen Parameter wird das Intervall gesteuert an dem der
    Syslogd Daemon sein Lebenszeichen (Mark) ausgibt. Angabe in Millisekunden.
    0 bedeutet keine Lebenszeichen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{SYSLOGD\_MARK\_INTERVAL='20'}
}


\config{SYSLOGD\_LOG\_COUNT}
{SYSLOGD\_LOG\_COUNT}
{SYSLOGDLOGCOUNT}
{
    "Uber diesen Parameter wird die Anzahl der gesicherten Log Dateien
    angegeben.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{SYSLOGD\_LOG\_COUNT='10'}
}


\config{SYSLOGD\_LOG\_INTERVAL}
{SYSLOGD\_LOG\_INTERVAL}
{SYSLOGDLOGINTERVAL}
{
    "Uber diesen Parameter wird Intervall des Sicherung der Log Dateien
    eingestellt.

    G"ultige Werte: daily, weekly, monthly

    Standardeinstellung: \texttt{SYSLOGD\_LOG\_INTERVAL='monthly'}
}


\config{SYSLOGD\_OPTIONS}
{SYSLOGD\_OPTIONS}
{SYSLOGDOPTIONS}
{

    \achtung{Die -r Option steht jetzt nicht mehr zur Verf"ugung!}

     Wurde \texttt{SYSLOGD\_OPTIONS='-r'} gesetzt, so konnte der syslogd
     Meldungen "uber das Netzwerk empfangen. D.h. ein anderer
     Host konnte "uber \\
     \texttt{SYSLOGD\_DEST\_x\_TARGET='@IP-Adresse'} z.B.
     \texttt{'@192.168.1.11'} Meldungen "ubergeben.

\begin{verbatim}
  -4        Nutze nur IPv4
  -6        Nutze nur IPv6
  -8        Weist syslogd an, 8-Bit-Daten nicht zu verändern.
            Normalerweise ersetzt syslogd C1 Kontrollzeichen
            (ISO 8859 und Unicode Zeichen) mit ihren
            "M-x" (ALT-x) Gegenstücken.
            Hinweis: Diese Option ändert nichts daran, wie syslogd
            Kontrollzeichen verändert (siehe iscntrl(3)). Diese werden
            immer durch ihre "^x" Gegenstücke (CTRL-x) ersetzt.
  -A        Sende an alle Adressen im DNS A-, bzw. AAAA-Record
  -a PEER   Erlaube PEER den syslogd also remote Syslog-Server zu nutzen.
            Diese Angabe wird ignoriert wenn -s genutzt wird.
            Es können mehrere -a Optionen angegeben werden:
              ipaddr[/len][:port]   Akzeptiere Meldungen von 'ipaddr'.
                                    Dabei kann 'ipaddr' eine IPv4-Adresse
                                    sein, oder IPv6-Adresse, wenn sie in
                                    '[' und ']' eingeschlossen ist. Die
                                    optionale Angabe des Ports kann ein
                                    sog. Service-Name oder ein
                                    numerischer Port sein.
              domainname[:port]     Akzeptiere Meldungen, wenn der
                                    Revers-Address-Lockup die Angabe des
                                    Senders 'domainname' enthält.
                                    'domainname' kann Shell-Style Pattern
                                    wie z.B. '*' enthalten.
  -b NAME   Binde an eine spezifische Adresse und/oder Port. Mehrere
            -b Optionen können angegeben werden. Default ist auf allen
            Interfaces auf dem UPD Port 514 zu lauschen, es sei denn,
            es wurde mit der Option -s gestartet.
              address[:port]        Hostname oder IP Adresse, IPv6
                                    Adressen müssen in '[' und ']'
                                    eingeschlossen werden
              :port                 UDP Port Nummer, oder Service Name
                                    default: 'syslog', port 514
  -C        Datei zur Zwischenspeicherung der Sequenznummer von
            Kernel-Meldungen aus /dev/kmsg. Der Standardwert ist
            /run/syslogd.cache. Wenn syslogd nicht in diese Datei
            schreiben oder daraus lesen kann, dann hat das eine
            Wiederholung der Kernel-Log-Meldungen zur Folge, wann immer
            syslogd neu gestartet wird.
            Hinweis: syslogd verlässt sich darauf, dass diese Datei beim
            Systemstart entfernt wird. Der Standardort hängt vom System
            und der Konfiguration des syslogd ab.
  -d        Schalte den debug mode ein. Diese Angabe impliziert -F,
            um den Ablauf im Hintergrund zu unterbinden.
  -f FILE   Alternative Konfigurationsdatei .conf.
            Default ist /etc/syslog.conf.
  -F        Ablauf im Vordergrund. Notwendig, wenn über init(1) überwacht
            wird.
  -H        Verwende beim Loggen von Meldungen entfernter Systeme den in
            der Meldung enthaltenen Host-Namen (falls vorhanden) anstelle
            der Adresse des Systems von dem die Meldung empfangen wurde.
  -k        Erlaube Logging mit der Facility 'kernel', ansonsten
            gewandelt auf 'user'
  -K        Schaltet das Loggen von Kernel-Meldungen aus. Dies ist sinnvoll
            im Fall von Container-Anwendungen, bei denen das Kernel-Logging
            vom Host-System übernommen wird.
  -m MINS   Abstand zwischen den MARK Meldungen, 0 zum Ausschalten,
            Default: 20 Minuten.
  -n        Deaktiviere DNS Anfragen für jede Anfrage
  -p PATH   Pfad zum UNIX domain Socket, mehrere -p Angaben erzeugen
            mehrere Sockets.
            Default, wenn auf -p kein Argument folgt: /dev/log
  -P FILE   Datei in der die Process ID gespeichert wird,
            Default: /run/syslogd.pid
  -r S[:R]  Erlaube Log Rotation. Das Größen Arguent (S) kann mit k/M/G
            qualifiert werden, z.B.. 2M für 2 MiB.
            Beim optionale Rotations Argument gilt ein Default von 5.
            Log Rotation kann auch für jedes Log File in /etc/syslog.conf
            festgelegt werden.
  -s        Ablauf im sog. Secure mode, es werden keine Meldungen von
            anderen Rechner verarbeitet.
            Wenn diese Option doppelt angegeben wird, so wird ebenfalls
            das Logging zu einem Remote Host unterbunden.
  -T        Benutze die local time sowie das Datum für Meldungen von
            Remote Hosts
  -?        Zeige diesen Hilfetext.
  -v        Zeige die Programmversion und beende das Programm.
\end{verbatim}

    G"ultige Werte: siehe oben

    Standardeinstellung: \texttt{SYSLOGD\_OPTIONS='{}'}
}

\end{description}

\jump{MENUSYSTEMLOGGING}{Zur"uck zum Men"u: Logging administration}

