Ticket #146: leafnode.patch

File leafnode.patch, 8.2 KB (added by billy@…, 22 years ago)

Adds leafnode section.

  • leafnode/leafnode-config.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode-config.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode-config.xml
    old new  
     1<sect2>
     2<title>Configuring leafnode</title>
     3
     4<sect3><title>Config files</title>
     5<para><userinput>/etc/leafnode/config,
     6/etc/inetd.conf, /etc/xinetd.conf</userinput></para>
     7
     8<para>leafnode may be configured to use inetd or xinetd as follows:
     9</para>
     10
     11<para>inetd configuration</para>
     12<para>Add a leafnode entry to the <filename>/etc/inetd.conf</filename>
     13file with the following command:
     14<screen><userinput>
     15echo "nntp stream tcp nowait news /usr/sbin/tcpd /usr/sbin/leafnode" \
     16&gt;&gt; /etc/inetd.conf &amp;&amp;
     17</userinput></screen></para>
     18
     19<para>xinetd configuration</para>
     20<para>Add a leafnode entry to the <filename>/etc/xinetd.conf</filename>
     21file with the following command:
     22<screen><userinput>
     23cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"
     24        service nntp
     25        {
     26           flags           = NAMEINARGS NOLIBWRAP
     27           socket_type     = stream
     28           protocol        = tcp
     29           wait            = no
     30           user            = news
     31           server          = /usr/sbin/tcpd
     32           server_args     = /usr/sbin/leafnode
     33           instances       = 7
     34           per_source      = 3
     35        }
     36EOF                                                                 
     37
     38</userinput></screen></para>
     39
     40<para>The <filename>/etc/news/config</filename> file must be
     41edited to reflect the name of the upstream NNTP provider.  Copy the
     42example configuration file to <filename>/etc/news/config</filename>
     43and save the original for reference : </para>
     44
     45<para><screen><userinput>
     46cp /etc/news/config.example /etc/news/config
     47</userinput></screen></para>
     48<para>Change the</para>
     49<para><screen><userinput>server = </userinput></screen></para>
     50<para>entry to reflect your news provider. </para>
     51
     52<para>The NNTPSERVER environment variable must be set to 127.0.0.1 to
     53prevent news clients from reading news from the upstream feed, add the
     54following to <filename>/etc/profile</filename> or
     55<filename>$HOME/.bash_profile</filename> :</para>
     56<para><screen><userinput>
     57export NNTPSERVER=127.0.0.1
     58</userinput></screen></para>
     59
     60</sect3>
     61
     62</sect2>
     63

  • leafnode/leafnode-desc.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode-desc.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode-desc.xml
    old new  
     1<sect2>
     2<title>Contents</title>
     3
     4<para>The leafnode package contains
     5<userinput>leafnode</userinput>,
     6<userinput>applyfilter</userinput>,
     7<userinput>texpire</userinput>,
     8<userinput>checkgroups</userinput>,
     9<userinput>fetchnews</userinput> and
     10<userinput>newsq.</userinput></para></sect2>
     11
     12<sect2><title>Description</title>
     13
     14<sect3><title>leafnode</title>
     15<para>leafnode is the NNTP server daemon.</para></sect3>
     16
     17<sect3><title>applyfilter</title>
     18<para>applyfilter filters newsgroup articles according to regular
     19expressions.</para></sect3>
     20
     21<sect3><title>texpire</title>
     22<para>texpire expires old articles and unread groups.</para></sect3>
     23
     24<sect3><title>checkgroups</title>
     25<para>checkgroups inserts newsgroup titles into the newsgroup
     26database.</para></sect3>
     27
     28<sect3><title>fetchnews</title>
     29<para>fetchnews sends posted articles to and retrieves new articles
     30from an upstream news server.</para></sect3>
     31
     32<sect3><title>newsq</title>
     33<para>newsq shows articles waiting to be sent upstream.</para></sect3>
     34
     35
     36</sect2>
     37

  • leafnode/leafnode-exp.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode-exp.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode-exp.xml
    old new  
     1<sect2>
     2<title>Installation command explanations</title>
     3
     4<para><userinput>
     5groupadd news
     6useradd -g news news :
     7</userinput></para>
     8<para>Create the group and user news, if not present.  Errors
     9resulting from an already existing user or group news may be
     10ignored.</para>
     11
     12<para><userinput> --prefix=/usr : </userinput>
     13Change the default installation directory of /usr/local.</para>
     14
     15<para><userinput> --sysconfdir=/etc/news : </userinput>
     16leafnode reads it's configuration data from an file called
     17<filename>config</filename>, this with be created in
     18<filename>/etc/news</filename> to avoid any potential conflict with
     19other packages.
     20</para>
     21
     22<para><userinput> make update : </userinput>
     23Create an initial <filename>/etc/news/config.example</filename> file,
     24which must be renamed to <filename>/etc/news/config</filename>.</para>
     25
     26</sect2>

  • leafnode/leafnode-inst.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode-inst.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode-inst.xml
    old new  
     1<sect2>
     2<title>Installation of leafnode</title>
     3
     4<para>Install leafnode by running the following commands:</para>
     5<para><screen><userinput>
     6groupadd news
     7useradd -g news news
     8./configure    --prefix=/usr --sysconfdir=/etc/news &amp;&amp;
     9make &amp;&amp;
     10make install &amp;&amp;
     11ldconfig &amp;&amp;
     12make update
     13</userinput></screen></para>
     14</sect2>
     15

  • leafnode/leafnode-intro.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode-intro.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode-intro.xml
    old new  
     1<sect2>
     2<title>Introduction to leafnode-&leafnode-version;</title>
     3
     4<screen>Download location (HTTP):       <ulink url="&leafnode-download-http;"/>
     5Version used:                   &leafnode-version;
     6Package size:                   &leafnode-size;
     7Estimated Disk space required:  &leafnode-buildsize;</screen>
     8
     9<para>leafnode is an NNTP server designed for small sites to provide a
     10local USENET spool.</para>
     11
     12<para><screen>leafnode depends on:
     13<xref linkend="pcre"/></screen>
     14</para></sect2>
     15 No newline at end of file

  • leafnode/leafnode.ent 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode/leafnode.ent /home/billy/NEWBLFS/BOOK/server/other/leafnode/leafnode.ent
    old new  
    11<!ENTITY leafnode SYSTEM "../leafnode.xml">
     2<!ENTITY leafnode-intro SYSTEM "leafnode-intro.xml">
     3<!ENTITY leafnode-inst SYSTEM "leafnode-inst.xml">
     4<!ENTITY leafnode-exp SYSTEM "leafnode-exp.xml">
     5<!ENTITY leafnode-config-exp SYSTEM "leafnode-config-exp.xml">
     6<!ENTITY leafnode-desc SYSTEM "leafnode-desc.xml">
     7<!ENTITY leafnode-config SYSTEM "leafnode-config.xml">
     8<!ENTITY leafnode-buildsize "3.9 MB">
     9<!ENTITY leafnode-version "1.9.24">
     10<!ENTITY leafnode-download-ftp
     11"ftp://wpxx02.toxi.uni-wuerzburg.de/pub/leafnode-1.9.24.rel.tar.bz2">
     12<!ENTITY leafnode-download-http
     13"http://www-dt.e-technik.uni-dortmund.de/~ma/leafnode/leafnode-1.9.24.rel.tar.bz2">
     14<!ENTITY leafnode-download-ftp "">
     15<!ENTITY leafnode-size "500 KB">

  • leafnode.xml 

    diff --exclude='bind*' --exclude='xinetd*' --exclude=CVS -Naur ./leafnode.xml /home/billy/NEWBLFS/BOOK/server/other/leafnode.xml
    old new  
    1 <sect1 id="leafnode" xreflabel="leafnode">
     1<sect1 id="leafnode" xreflabel="leafnode-&leafnode-version;">
    22<?dbhtml filename="leafnode.html" dir="server"?>
    3 <title>leafnode</title>
     3<title>leafnode-&leafnode-version;</title>
    44
    5 <para>TO BE DONE</para>
     5&leafnode-intro;
     6&leafnode-inst;
     7&leafnode-exp;
     8&leafnode-config;
     9&leafnode-desc;
    610
    711</sect1>
    812