Changeset 3bac165


Ignore:
Timestamp:
04/28/2005 08:06:40 PM (16 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
d3c4028
Parents:
c67971c
Message:

Tagged fetchmail.xml.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3823 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • basicnet/mailnews/fetchmail.xml

    rc67971c r3bac165  
    1414
    1515<sect1 id="fetchmail" xreflabel="Fetchmail">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="fetchmail.html"?>
    21 <title>Fetchmail-&fetchmail-version;</title>
    22 
    23 <sect2>
    24 <title>Introduction to <application>Fetchmail</application></title>
    25 
    26 <para>The <application>Fetchmail</application> package contains a mail
    27 retrieval program. &quot;It retrieves mail from remote mail servers and
    28 forwards it to your local (client) machine's delivery system, so it can then be
    29 read by normal mail user agents.&quot; </para>
    30 
    31 <sect3><title>Package information</title>
    32 <itemizedlist spacing='compact'>
    33 <listitem><para>Download (HTTP): <ulink
    34 url="&fetchmail-download-http;"/></para></listitem>
    35 <listitem><para>Download (FTP): <ulink
    36 url="&fetchmail-download-ftp;"/></para></listitem>
    37 <listitem><para>Download MD5 sum: &fetchmail-md5sum;</para></listitem>
    38 <listitem><para>Download size: &fetchmail-size;</para></listitem>
    39 <listitem><para>Estimated disk space required:
    40 &fetchmail-buildsize;</para></listitem>
    41 <listitem><para>Estimated build time:
    42 &fetchmail-time;</para></listitem></itemizedlist>
    43 </sect3>
    44 
    45 <sect3><title><application>Fetchmail</application> dependencies</title>
    46 <sect4><title>Required</title>
    47 <para><xref linkend="openssl"/> and
    48 a local MDA (<xref linkend="procmail"/>)</para>
    49 </sect4>
    50 
    51 <sect4><title>Optional</title>
    52 <para><xref linkend="python"/> and <xref linkend="tk"/></para>
    53 </sect4>
    54 </sect3>
    55 
    56 </sect2>
    57 
    58 <sect2>
    59 <title>Installation of <application>Fetchmail</application></title>
    60 
    61 <para>Install <application>Fetchmail</application> by running the following
    62 commands:</para>
    63 
    64 <screen><userinput><command>./configure --prefix=/usr --with-ssl --enable-fallback=procmail &amp;&amp;
     16  <?dbhtml filename="fetchmail.html"?>
     17 
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22 
     23  <title>Fetchmail-&fetchmail-version;</title>
     24 
     25  <indexterm zone="fetchmail">
     26    <primary sortas="a-Fetchmail">Fetchmail</primary>
     27  </indexterm>
     28 
     29  <sect2 role="package">
     30    <title>Introduction to Fetchmail</title>
     31   
     32    <para>The <application>Fetchmail</application> package contains a mail
     33    retrieval program. &quot;It retrieves mail from remote mail servers and
     34    forwards it to your local (client) machine's delivery system, so it can then be
     35    read by normal mail user agents.&quot; </para>
     36   
     37    <bridgehead renderas="sect3">Package Information</bridgehead>
     38    <itemizedlist spacing='compact'>
     39      <listitem>
     40        <para>Download (HTTP): <ulink url="&fetchmail-download-http;"/></para>
     41      </listitem>
     42      <listitem>
     43        <para>Download (FTP): <ulink url="&fetchmail-download-ftp;"/></para>
     44      </listitem>
     45      <listitem>
     46        <para>Download MD5 sum: &fetchmail-md5sum;</para>
     47      </listitem>
     48      <listitem>
     49        <para>Download size: &fetchmail-size;</para>
     50      </listitem>
     51      <listitem>
     52        <para>Estimated disk space required: &fetchmail-buildsize;</para>
     53      </listitem>
     54      <listitem>
     55        <para>Estimated build time: &fetchmail-time;</para>
     56      </listitem>
     57    </itemizedlist>
     58   
     59    <bridgehead renderas="sect3">Fetchmail Dependencies</bridgehead>
     60   
     61    <bridgehead renderas="sect4">Required</bridgehead>
     62    <para><xref linkend="openssl"/> and a local MDA (<xref linkend="procmail"/>)</para>
     63   
     64    <bridgehead renderas="sect4">Optional</bridgehead>
     65    <para><xref linkend="python"/> and <xref linkend="tk"/></para>
     66   
     67  </sect2>
     68 
     69  <sect2 role="installation">
     70    <title>Installation of Fetchmail</title>
     71   
     72    <para>Install <application>Fetchmail</application> by running the following
     73    commands:</para>
     74   
     75<screen><userinput>./configure --prefix=/usr --with-ssl --enable-fallback=procmail &amp;&amp;
    6576make &amp;&amp;
    66 make install</command></userinput></screen>
    67 
    68 </sect2>
    69 
    70 <sect2>
    71 <title>Command explanations</title>
    72 
    73 <para><option>--with-ssl</option>: This enables
    74 <acronym>SSL</acronym> if found, so that you can handle connections to
    75 secure <acronym>POP</acronym>3 and <acronym>IMAP</acronym> servers.</para>
    76 
    77 <para><parameter>--enable-fallback=procmail</parameter>: This tells
    78 <application>Fetchmail</application> to hand incoming mail to
    79 <application>Procmail</application> for delivery if your port 25 mail server is
    80 not present or not responding.</para>
    81 
    82 </sect2>
    83 
    84 <sect2>
    85 <title>Configuring <application>Fetchmail</application></title>
    86 
    87 <sect3><title>Config files</title>
    88 <para><filename>~/.fetchmailrc</filename></para>
    89 </sect3>
    90 
    91 <sect3><title>Configuration Information</title>
    92 
    93 <screen><userinput><command>cat &gt; ~/.fetchmailrc &lt;&lt; "EOF"</command>
    94 set logfile /var/log/fetchmail.log
     77make install</userinput></screen>
     78   
     79  </sect2>
     80 
     81  <sect2 role="commands">
     82    <title>Command explanations</title>
     83   
     84    <para><parameter>--with-ssl</parameter>: This enables SSL if found, so that
     85    you can handle connections to secure POP3 and IMAP servers.</para>
     86   
     87    <para><parameter>--enable-fallback=procmail</parameter>: This tells
     88    <application>Fetchmail</application> to hand incoming mail to
     89    <application>Procmail</application> for delivery if your port 25 mail server is
     90    not present or not responding.</para>
     91   
     92  </sect2>
     93 
     94  <sect2 role="configuration">
     95    <title>Configuring Fetchmail</title>
     96   
     97    <sect3 id="fetchmail-config">
     98      <title>Config files</title>
     99     
     100      <para><filename>~/.fetchmailrc</filename></para>
     101     
     102      <indexterm zone="fetchmail fetchmail-config">
     103        <primary sortas="e-AA.fetchmailrc">~/.fetchmailrc</primary>
     104      </indexterm>
     105     
     106    </sect3>
     107   
     108    <sect3>
     109      <title>Configuration Information</title>
     110     
     111<screen><userinput>cat &gt; ~/.fetchmailrc &lt;&lt; "EOF"
     112<literal>set logfile /var/log/fetchmail.log
    95113set no bouncemail
    96114set postmaster root
    97 
    98 poll SERVERNAME :
     115           
     116poll SERVERNAME : 
    99117    user <replaceable>[username]</replaceable> pass <replaceable>[password]</replaceable>;
    100     mda "/usr/bin/procmail -f %F -d %T";
    101 <command>EOF</command>
    102 
    103 <command>chmod 0600 ~/.fetchmailrc</command></userinput></screen>
    104 
    105 <para>This is an example configuration that should suffice for most people.
    106 You can add as many users and servers as you need using the same syntax.</para>
    107 
    108 <para><command>man fetchmail</command>: Look for the section near
    109 the bottom named <emphasis role="strong">CONFIGURATION EXAMPLES</emphasis>. It
    110 gives some quick examples. There are countless other config options once
    111 you get used to it.</para>
    112 </sect3>
    113 
    114 </sect2>
    115 
    116 <sect2>
    117 <title>Contents</title>
    118 
    119 <para>The <application>Fetchmail</application> package contains
    120 <command>fetchmail</command> and <command>fetchmailconf</command>.</para>
    121 
    122 </sect2>
    123 
    124 <sect2><title>Description</title>
    125 
    126 <sect3><title>fetchmail</title>
    127 <para>When executed as a user, this will source that users
    128 <filename>~/.fetchmailrc</filename> and download the appropriate mail.
    129 </para></sect3>
    130 
    131 <sect3>
    132 <title>fetchmailconf</title>
    133 
    134 <para>This program provides a <application>Tk</application>
    135 <acronym>GUI</acronym> interface to your <filename>~/.fetchmailrc</filename>
    136 file making it much easier to configure.  However, you will require
    137 <application>Python</application>, and it must have the Tkinker module
    138 available.</para>
    139 </sect3>
    140 
    141 </sect2>
    142 
     118    mda "/usr/bin/procmail -f %F -d %T";</literal>
     119EOF
     120         
     121chmod 0600 ~/.fetchmailrc</userinput></screen>
     122     
     123      <para>This is an example configuration that should suffice for most people.
     124      You can add as many users and servers as you need using the same syntax.</para>
     125     
     126      <para><command>man fetchmail</command>: Look for the section near
     127      the bottom named <emphasis role="strong">CONFIGURATION EXAMPLES</emphasis>. It
     128      gives some quick examples. There are countless other config options once
     129      you get used to it.</para>
     130     
     131    </sect3>
     132   
     133  </sect2>
     134 
     135  <sect2 role="content">
     136    <title>Contents</title>
     137   
     138    <segmentedlist>
     139      <segtitle>Installed Program</segtitle>
     140      <segtitle>Installed Libraries</segtitle>
     141      <segtitle>Installed Directories</segtitle>
     142     
     143      <seglistitem>
     144        <seg>fetchmail and fetchmailconf</seg>
     145        <seg>None</seg>
     146        <seg>None</seg>
     147      </seglistitem>
     148    </segmentedlist>
     149   
     150    <variablelist>
     151      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     152      <?dbfo list-presentation="list"?>
     153      <?dbhtml list-presentation="table"?>
     154     
     155      <varlistentry id="fetchmail-prog">
     156        <term><command>fetchmail</command></term>
     157        <listitem>
     158          <para>when executed as a user, this will source that users
     159          <filename>~/.fetchmailrc</filename> and download the appropriate mail.</para>
     160          <indexterm zone="fetchmail fetchmail-prog">
     161            <primary sortas="b-fetchmail">fetchmail</primary>
     162          </indexterm>
     163        </listitem>
     164      </varlistentry>
     165     
     166      <varlistentry id="fetchmailconf">
     167        <term><command>fetchmailconf</command></term>
     168        <listitem>
     169          <para>this program provides a <application>Tk</application>
     170            <acronym>GUI</acronym> interface to your <filename>~/.fetchmailrc</filename>
     171            file making it much easier to configure.  However, you will require
     172            <application>Python</application>, and it must have the Tkinker module
     173          available.</para>
     174          <indexterm zone="fetchmail fetchmailconf">
     175            <primary sortas="b-fetchmailconf">fetchmailconf</primary>
     176          </indexterm>
     177        </listitem>
     178      </varlistentry>
     179     
     180    </variablelist>
     181   
     182  </sect2>
     183 
    143184</sect1>
    144 
Note: See TracChangeset for help on using the changeset viewer.