chapter06/sysklogd.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-system-sysklogd" role="wrap" revision="sysv">
   9   <?dbhtml filename="sysklogd.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>sysklogd</productname>
  13     <productnumber>&sysklogd-version;</productnumber>
  14     <address>&sysklogd-url;</address>
  15   </sect1info>
  16
  17   <title>Sysklogd-&sysklogd-version;</title>
  18
  19   <indexterm zone="ch-system-sysklogd">
  20     <primary sortas="a-Sysklogd">Sysklogd</primary>
  21   </indexterm>
  22
  23   <sect2 role="package">
  24     <title/>
  25
  26     <para>The Sysklogd package contains programs for logging system messages,
  27     such as those given by the kernel when unusual things happen.</para>
  28
  29     <segmentedlist>
  30       <segtitle>&buildtime;</segtitle>
  31       <segtitle>&diskspace;</segtitle>
  32
  33       <seglistitem>
  34         <seg>&sysklogd-ch6-sbu;</seg>
  35         <seg>&sysklogd-ch6-du;</seg>
  36       </seglistitem>
  37     </segmentedlist>
  38
  39   </sect2>
  40
  41   <sect2 role="installation">
  42     <title>Installation of Sysklogd</title>
  43
  44     <para>First, fix problems that causes a segmentation fault under
  45     some conditions in klogd and fix an obsolete program construct:</para>
  46
  47 <screen><userinput remap="pre">sed -i '/Error loading kernel symbols/{n;n;d}' ksym_mod.c
  48 sed -i 's/union wait/int/' syslogd.c
  49 </userinput></screen>
  50
  51     <para>Compile the package:</para>
  52
  53 <screen><userinput remap="make">make</userinput></screen>
  54
  55     <para>This package does not come with a test suite.</para>
  56
  57     <para>Install the package:</para>
  58
  59 <screen><userinput remap="install">make BINDIR=/sbin install</userinput></screen>
  60
  61   </sect2>
  62
  63   <sect2 id="conf-sysklogd" role="configuration">
  64     <title>Configuring Sysklogd</title>
  65
  66     <indexterm zone="conf-sysklogd">
  67       <primary sortas="a-Sysklogd">Sysklogd</primary>
  68       <secondary>configuring</secondary>
  69     </indexterm>
  70
  71     <indexterm zone="conf-sysklogd">
  72       <primary sortas="e-/etc/syslog.conf">/etc/syslog.conf</primary>
  73     </indexterm>
  74
  75     <para>Create a new <filename>/etc/syslog.conf</filename> file by running the
  76     following:</para>
  77
  78 <screen><userinput>cat &gt; /etc/syslog.conf &lt;&lt; "EOF"
  79 <literal># Begin /etc/syslog.conf
  80
  81 auth,authpriv.* -/var/log/auth.log
  82 *.*;auth,authpriv.none -/var/log/sys.log
  83 daemon.* -/var/log/daemon.log
  84 kern.* -/var/log/kern.log
  85 mail.* -/var/log/mail.log
  86 user.* -/var/log/user.log
  87 *.emerg *
  88
  89 # End /etc/syslog.conf</literal>
  90 EOF</userinput></screen>
  91
  92   </sect2>
  93
  94   <sect2 id="contents-sysklogd" role="content">
  95     <title>Contents of Sysklogd</title>
  96
  97     <segmentedlist>
  98       <segtitle>Installed programs</segtitle>
  99
 100       <seglistitem>
 101         <seg>klogd and syslogd</seg>
 102       </seglistitem>
 103     </segmentedlist>
 104
 105     <variablelist>
 106       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 107       <?dbfo list-presentation="list"?>
 108       <?dbhtml list-presentation="table"?>
 109
 110       <varlistentry id="klogd">
 111         <term><command>klogd</command></term>
 112         <listitem>
 113           <para>A system daemon for intercepting and logging kernel messages</para>
 114           <indexterm zone="ch-system-sysklogd klogd">
 115             <primary sortas="b-klogd">klogd</primary>
 116           </indexterm>
 117         </listitem>
 118       </varlistentry>
 119
 120       <varlistentry id="syslogd">
 121         <term><command>syslogd</command></term>
 122         <listitem>
 123           <para>Logs the messages that system programs offer for logging [Every
 124           logged message contains at least a date stamp and a hostname, and
 125           normally the program's name too, but that depends on how trusting the
 126           logging daemon is told to be.]</para>
 127           <indexterm zone="ch-system-sysklogd syslogd">
 128             <primary sortas="b-syslogd">syslogd</primary>
 129           </indexterm>
 130         </listitem>
 131       </varlistentry>
 132
 133     </variablelist>
 134
 135   </sect2>
 136
 137 </sect1>