sysklogd.xml 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-sysklogd" xreflabel="Sysklogd" role="wrap">
  7. <title>Sysklogd-&sysklogd-version;</title>
  8. <?dbhtml filename="sysklogd.html"?>
  9. <indexterm zone="ch-system-sysklogd"><primary sortas="a-Sysklogd">Sysklogd</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Sysklogd package contains programs for logging system messages, such
  12. as those given by the kernel when unusual things happen.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.1 SBU</seg><seg>704 KB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>&dependencies;</segtitle>
  20. <seglistitem><seg>Binutils, Coreutils, GCC, Glibc, Make</seg></seglistitem>
  21. </segmentedlist>
  22. </sect2>
  23. <sect2 role="installation">
  24. <title>Installation of Sysklogd</title>
  25. <para>The following patch fixes various issues, including a problem building
  26. Sysklogd with Linux 2.6 series kernels</para>
  27. <screen><userinput>patch -Np1 -i ../&sysklogd-fixes-patch;</userinput></screen>
  28. <para>The following patch makes sysklogd treat bytes in the 0x80--0x9f range
  29. literally in the messages being logged, instead of replacing them with octal
  30. codes. Unpatched sysklogd would damage messages in the UTF-8 encoding.</para>
  31. <screen><userinput>patch -Np1 -i ../&sysklogd-8bit-patch;</userinput></screen>
  32. <para>Compile the package:</para>
  33. <screen><userinput>make</userinput></screen>
  34. <para>This package does not come with a test suite.</para>
  35. <para>Install the package:</para>
  36. <screen><userinput>make install</userinput></screen>
  37. </sect2>
  38. <sect2 id="conf-sysklogd" role="configuration"><title>Configuring Sysklogd</title>
  39. <indexterm zone="conf-sysklogd">
  40. <primary sortas="a-Sysklogd">Sysklogd</primary>
  41. <secondary>configuring</secondary></indexterm>
  42. <indexterm zone="conf-sysklogd"><primary sortas="e-/etc/syslog.conf">/etc/syslog.conf</primary></indexterm>
  43. <para>Create a new <filename>/etc/syslog.conf</filename> file by running the
  44. following:</para>
  45. <screen><userinput>cat &gt; /etc/syslog.conf &lt;&lt; "EOF"
  46. <literal># Begin /etc/syslog.conf
  47. auth,authpriv.* -/var/log/auth.log
  48. *.*;auth,authpriv.none -/var/log/sys.log
  49. daemon.* -/var/log/daemon.log
  50. kern.* -/var/log/kern.log
  51. mail.* -/var/log/mail.log
  52. user.* -/var/log/user.log
  53. *.emerg *
  54. # log the bootscript output:
  55. local2.* -/var/log/boot.log
  56. # End /etc/syslog.conf</literal>
  57. EOF</userinput></screen>
  58. </sect2>
  59. <sect2 id="contents-sysklogd" role="content"><title>Contents of Sysklogd</title>
  60. <segmentedlist>
  61. <segtitle>Installed programs</segtitle>
  62. <seglistitem><seg>klogd and syslogd</seg></seglistitem>
  63. </segmentedlist>
  64. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  65. <?dbfo list-presentation="list"?>
  66. <?dbhtml list-presentation="table"?>
  67. <varlistentry id="klogd">
  68. <term><command>klogd</command></term>
  69. <listitem>
  70. <para>A system daemon for intercepting and logging kernel messages</para>
  71. <indexterm zone="ch-system-sysklogd klogd"><primary sortas="b-klogd">klogd</primary></indexterm>
  72. </listitem>
  73. </varlistentry>
  74. <varlistentry id="syslogd">
  75. <term><command>syslogd</command></term>
  76. <listitem>
  77. <para>Logs the messages that system programs offer for logging. Every logged
  78. message contains at least a date stamp and a hostname, and normally the
  79. program's name too, but that depends on how trusting the logging daemon is told
  80. to be</para>
  81. <indexterm zone="ch-system-sysklogd syslogd"><primary sortas="b-syslogd">syslogd</primary></indexterm>
  82. </listitem>
  83. </varlistentry>
  84. </variablelist>
  85. </sect2>
  86. </sect1>