BOOK/chapter08/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-fin-sbu;</seg>
  35         <seg>&sysklogd-fin-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</userinput></screen>
  49
  50     <para>Compile the package:</para>
  51
  52 <screen><userinput remap="make">make</userinput></screen>
  53
  54     <para>This package does not come with a test suite.</para>
  55
  56     <para>Install the package:</para>
  57
  58 <screen><userinput remap="install">make BINDIR=/sbin install</userinput></screen>
  59
  60   </sect2>
  61
  62   <sect2 id="conf-sysklogd" role="configuration">
  63     <title>Configuring Sysklogd</title>
  64
  65     <indexterm zone="conf-sysklogd">
  66       <primary sortas="a-Sysklogd">Sysklogd</primary>
  67       <secondary>configuring</secondary>
  68     </indexterm>
  69
  70     <indexterm zone="conf-sysklogd">
  71       <primary sortas="e-/etc/syslog.conf">/etc/syslog.conf</primary>
  72     </indexterm>
  73
  74     <para>Create a new <filename>/etc/syslog.conf</filename> file by running the
  75     following:</para>
  76
  77 <screen><userinput>cat &gt; /etc/syslog.conf &lt;&lt; "EOF"
  78 <literal># Begin /etc/syslog.conf
  79
  80 auth,authpriv.* -/var/log/auth.log
  81 *.*;auth,authpriv.none -/var/log/sys.log
  82 daemon.* -/var/log/daemon.log
  83 kern.* -/var/log/kern.log
  84 mail.* -/var/log/mail.log
  85 user.* -/var/log/user.log
  86 *.emerg *
  87
  88 # End /etc/syslog.conf</literal>
  89 EOF</userinput></screen>
  90
  91   </sect2>
  92
  93   <sect2 id="contents-sysklogd" role="content">
  94     <title>Contents of Sysklogd</title>
  95
  96     <segmentedlist>
  97       <segtitle>Installed programs</segtitle>
  98
  99       <seglistitem>
 100         <seg>klogd and syslogd</seg>
 101       </seglistitem>
 102     </segmentedlist>
 103
 104     <variablelist>
 105       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 106       <?dbfo list-presentation="list"?>
 107       <?dbhtml list-presentation="table"?>
 108
 109       <varlistentry id="klogd">
 110         <term><command>klogd</command></term>
 111         <listitem>
 112           <para>A system daemon for intercepting and logging kernel messages</para>
 113           <indexterm zone="ch-system-sysklogd klogd">
 114             <primary sortas="b-klogd">klogd</primary>
 115           </indexterm>
 116         </listitem>
 117       </varlistentry>
 118
 119       <varlistentry id="syslogd">
 120         <term><command>syslogd</command></term>
 121         <listitem>
 122           <para>Logs the messages that system programs offer for logging [Every
 123           logged message contains at least a date stamp and a hostname, and
 124           normally the program's name too, but that depends on how trusting the
 125           logging daemon is told to be.]</para>
 126           <indexterm zone="ch-system-sysklogd syslogd">
 127             <primary sortas="b-syslogd">syslogd</primary>
 128           </indexterm>
 129         </listitem>
 130       </varlistentry>
 131
 132     </variablelist>
 133
 134   </sect2>
 135
 136 </sect1>