[deployment-guide/comm-rel: 689/727] Log Files chapter: added section Configuring rsyslog

[Jaromir Hradilek]

commit 5d976f8263d6917d649fb765948e024743705326
Author: Martin Prpic <mprpic at redhat.com>
Date:   Wed Sep 22 11:51:42 2010 +0200

    Log Files chapter: added section Configuring rsyslog

 en-US/Log_Files.xml |   83 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 81 insertions(+), 2 deletions(-)
---
diff --git a/en-US/Log_Files.xml b/en-US/Log_Files.xml
index c60e34e..05f141e 100644
--- a/en-US/Log_Files.xml
+++ b/en-US/Log_Files.xml
@@ -32,7 +32,86 @@
       <command>rsyslog</command>
     </primary>
   </indexterm>
-  <para>Some log files are controlled by a daemon called <systemitem class="daemon">rsyslog</systemitem>. A list of log messages maintained by <systemitem class="daemon">rsyslog</systemitem> can be found in the <filename>/etc/rsyslog.conf</filename> configuration file.</para>
+  <para>Some log files are controlled by a daemon called <systemitem class="daemon">rsyslogd</systemitem>. A list of log messages maintained by <systemitem class="daemon">rsyslogd</systemitem> can be found in the <filename>/etc/rsyslog.conf</filename> configuration file.</para>
+  <para>
+    <command>rsyslog</command> replaced <command>syslogd</command> as the default program for forwarding log messages over the network. <command>rsyslog</command> uses the basic <command>syslog</command> protocol and extends its functionality with enhanced filtering, encryption protected relaying of messages, various configuration options, or support for transportation via the <systemitem class="protocol">TCP</systemitem> or <systemitem class="protocol">UDP</systemitem> protocols.
+  </para>
+  <section id="s1-configuring-rsyslog">
+    <title>Configuring <command>rsyslog</command></title>
+    <para>
+      The main configuration file for <command>rsyslog</command> is <filename>/etc/rsyslog.conf</filename>. It is essentially divided in the following parts:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          Modules — 
+        </para>
+        <itemizedlist>
+          <listitem>
+            <para>
+              Input Modules
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Output Modules
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Parser Modules
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Message Modification Module
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              String Generator Modules
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Library Modules
+            </para>
+          </listitem>
+        </itemizedlist>
+        <para>
+          A comprehensive list of all available modules and their detailed description can be found at <ulink url="http://www.rsyslog.com/doc/rsyslog_conf_modules.html/">http://www.rsyslog.com/doc/rsyslog_conf_modules.html</ulink>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Global Directives — 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Rules — 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Templates — 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Filter Conditions — 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Output Channels — 
+        </para>
+      </listitem>
+    </itemizedlist>
+    <para>
+      Note that any empty lines or lines that begin with a hash mark (#) are comments and are not processed. 
+    </para>
+  </section>
   <section
     id="s1-logfiles-locating">
     <title>Locating Log Files</title>
@@ -53,7 +132,7 @@
         <command>logrotate</command>
       </primary>
     </indexterm>
-    <para>You may notice multiple files in the log file directory with numbers after them (e.g.: <filename>cron-20100906</filename>). These numbers represent a timestamp that has been added to a rotated log file. Log files are rotated so their file sizes do not become too large. The <filename>logrotate</filename> package contains a cron task that automatically rotates log files according to the <filename>/etc/logrotate.conf</filename> configuration file and the configuration files in the <filename>/etc/logrotate.d/</filename> directory.</para>
+    <para>You may notice multiple files in the <filename>/var/log/</filename> directory with numbers after them (e.g.: <filename>cron-20100906</filename>). These numbers represent a timestamp that has been added to a rotated log file. Log files are rotated so their file sizes do not become too large. The <filename>logrotate</filename> package contains a cron task that automatically rotates log files according to the <filename>/etc/logrotate.conf</filename> configuration file and the configuration files in the <filename>/etc/logrotate.d/</filename> directory.</para>
     <section id="configuring-logrotate">
       <title>Configuring <package>logrotate</package></title>
       <para>