source: server/mail/qpopper.xml@ ff769b8c

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY qpopper-download-http "http://ftp.uni-koeln.de/mail/qpopper&qpopper-version;.tar.gz">
<!ENTITY qpopper-download-ftp "ftp://ftp.qualcomm.com/eudora/servers/unix/popper/qpopper&qpopper-version;.tar.gz">
<!ENTITY qpopper-md5sum "e00853280c9e899711f0b0239d3d8f86">
<!ENTITY qpopper-size "2.2 MB">
<!ENTITY qpopper-buildsize "9.0 MB">
<!ENTITY qpopper-time "0.13 SBU">
]>

<sect1 id="qpopper" xreflabel="Qpopper-&qpopper-version;">
<sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
</sect1info>

<?dbhtml filename="qpopper.html"?>
<title>Qpopper-&qpopper-version;</title>

<indexterm zone="qpopper">
  <primary sortas="a-Qpopper">Qpopper</primary>
</indexterm>

<sect2>
<title>Introduction to <application>Qpopper</application></title>

<para>The <application>Qpopper</application> package contains a
<acronym>POP</acronym>3 mail server.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
  <listitem><para>Download (HTTP): <ulink url="&qpopper-download-http;"/></para></listitem>
  <listitem><para>Download (FTP): <ulink url="&qpopper-download-ftp;"/></para></listitem>
  <listitem><para>Download MD5 sum: &qpopper-md5sum;</para></listitem>
  <listitem><para>Download size: &qpopper-size;</para></listitem>
  <listitem><para>Estimated disk space required: &qpopper-buildsize;</para></listitem>
  <listitem><para>Estimated build time: &qpopper-time;</para></listitem>
</itemizedlist>
</sect3>

<sect3>
<title><application>Qpopper</application> dependencies</title>

<sect4>
<title>Required</title>
  <para><ulink url="../server/mail.html">MTA</ulink></para>
</sect4>

<sect4>
<title>Optional</title>
  <para><xref linkend="openssl"/>,
  <xref linkend="gdbm"/>,
  <xref linkend="Linux_PAM"/>, and
  <xref linkend="mitkrb"/> or <xref linkend="heimdal"/></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Qpopper</application></title>

<para>Install <application>Qpopper</application> with the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application>Qpopper</application></title>

<sect3 id="qpopper-config"><title>Configuration Information</title>

<para>Update the <application>Syslog</application> configuration file and 
force the <command>syslogd</command> daemon to reread the new file so that 
<application>Qpopper</application> events are logged:</para>

<indexterm zone="qpopper qpopper-config">
  <primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary>
</indexterm>

<screen><userinput><command>echo "local0.notice;local0.debug /var/log/POP.log" &gt;&gt; \
    /etc/syslog.conf &amp;&amp;
killall -HUP syslogd</command></userinput></screen>

<para>If you use <command>inetd</command>, the following command will add the 
<application>Qpopper</application> entry to 
<filename>/etc/inetd.conf</filename>:</para>

<indexterm zone="qpopper qpopper-config">
  <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
</indexterm>

<screen><userinput><command>echo "pop3 stream tcp nowait root /usr/sbin/popper popper" &gt;&gt; \
    /etc/inetd.conf &amp;&amp;
killall inetd || inetd</command></userinput></screen>

<para>Issue a <command>killall -HUP inetd</command> to reread the changed
<filename>inetd.conf</filename> file.</para>

<para>If you use <command>xinetd</command>, the following command will create the 
<application>Qpopper</application> file as <filename>/etc/xinetd.d/pop3</filename>:</para>

<screen><userinput><command>cat &gt;&gt; /etc/xinetd.d/pop3 &lt;&lt; "EOF"</command>
# Begin /etc/xinetd.d/pop3

service pop3
{
    port            = 110
    socket_type     = stream
    protocol        = tcp
    wait            = no
    user            = root
    server          = /usr/sbin/popper
}

# End /etc/xinetd.d/pop3
<command>EOF</command></userinput></screen>

<indexterm zone="qpopper qpopper-config">
  <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
</indexterm>

<indexterm zone="qpopper qpopper-config">
  <primary sortas="e-etc-xinetd.d-pop3">/etc/xinetd.d/pop3</primary>
</indexterm>

<para>Issue a <command>killall -HUP xinetd</command> to reread the changed
<filename>xinetd.conf</filename> file.</para>
</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>

<seglistitem>
<seg>popper</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="popper-qpopper">
<term><command>popper</command></term>
<listitem><para>is the <acronym>POP</acronym>3 server daemon.</para>
<indexterm zone="qpopper popper-qpopper">
<primary sortas="b-popper">popper</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>