source: networking/mailnews/fetchmail.xml@ c225bfa

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since c225bfa was 79434a7, checked in by Ken Moffat <ken@…>, 7 years ago

Tags

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

  • Property mode set to 100644
File size: 6.7 KB
RevLine 
[bfe245f]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[bfe245f]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[8dfc5c3]7 <!ENTITY fetchmail-download-http "&sourceforge-dl;/fetchmail/fetchmail-&fetchmail-version;.tar.xz">
[ae0f6ec0]8 <!ENTITY fetchmail-download-ftp " ">
[c48bc3ba]9 <!ENTITY fetchmail-md5sum "61b66faad044afa26e142bb1791aa2b3">
[06f76d2c]10 <!ENTITY fetchmail-size "1.2 MB">
[c48bc3ba]11 <!ENTITY fetchmail-buildsize "14 MB">
[d8a1fe81]12 <!ENTITY fetchmail-time "0.1 SBU">
[bfe245f]13]>
14
[31784c8]15<sect1 id="fetchmail" xreflabel="fetchmail-&fetchmail-version;">
[3bac165]16 <?dbhtml filename="fetchmail.html"?>
[481b3e8]17
[3bac165]18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
[481b3e8]22
[3bac165]23 <title>Fetchmail-&fetchmail-version;</title>
[481b3e8]24
[3bac165]25 <indexterm zone="fetchmail">
26 <primary sortas="a-Fetchmail">Fetchmail</primary>
27 </indexterm>
[481b3e8]28
[3bac165]29 <sect2 role="package">
30 <title>Introduction to Fetchmail</title>
[481b3e8]31
[3bac165]32 <para>The <application>Fetchmail</application> package contains a mail
[876ad7f]33 retrieval program. It retrieves mail from remote mail servers and
34 forwards it to the local (client) machine's delivery system, so it can then be
35 read by normal mail user agents.</para>
[481b3e8]36
[79434a7]37 &lfs81_checked;
[06f76d2c]38
[3bac165]39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing='compact'>
41 <listitem>
42 <para>Download (HTTP): <ulink url="&fetchmail-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&fetchmail-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &fetchmail-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &fetchmail-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &fetchmail-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &fetchmail-time;</para>
58 </listitem>
59 </itemizedlist>
[481b3e8]60
[a4f37269]61 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
62 <itemizedlist spacing="compact">
63 <listitem>
[428fb71]64 <para>Required patch: <ulink
65 url="&patch-root;/fetchmail-&fetchmail-version;-disable_sslv3-1.patch"/></para>
[a4f37269]66 </listitem>
67 </itemizedlist>
68
[3bac165]69 <bridgehead renderas="sect3">Fetchmail Dependencies</bridgehead>
[481b3e8]70
[d92abe56]71 <bridgehead renderas="sect4">Recommended</bridgehead>
72 <para role="recommended">
[f3429309]73 <xref linkend="openssl"/> and
[c48bc3ba]74 a local MDA (<xref linkend="procmail"/>)
75 </para>
[481b3e8]76
[3bac165]77 <bridgehead renderas="sect4">Optional</bridgehead>
[c48bc3ba]78 <para role="optional">
[f3429309]79 <xref linkend="python2"/> and
[c48bc3ba]80 <xref linkend="tk"/>
81 </para>
[481b3e8]82
[061ec9d]83 <para condition="html" role="usernotes">User Notes:
84 <ulink url="&blfs-wiki;/fetchmail"/></para>
85
[3bac165]86 </sect2>
[481b3e8]87
[3bac165]88 <sect2 role="installation">
89 <title>Installation of Fetchmail</title>
[481b3e8]90
91 <para>Install <application>Fetchmail</application> by running the following
[3bac165]92 commands:</para>
[481b3e8]93
[428fb71]94<screen><userinput>patch -Np1 -i ../fetchmail-&fetchmail-version;-disable_sslv3-1.patch &amp;&amp;
[a4f37269]95./configure --prefix=/usr --with-ssl --enable-fallback=procmail &amp;&amp;
[46441976]96make</userinput></screen>
97
98 <para>This package does not come with a test suite.</para>
99
100 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
101
102<screen role='root'><userinput>make install</userinput></screen>
[481b3e8]103
[3bac165]104 </sect2>
[481b3e8]105
[3bac165]106 <sect2 role="commands">
[e3353b3]107 <title>Command Explanations</title>
[481b3e8]108
[876ad7f]109 <para><parameter>--with-ssl</parameter>: This enables SSL support, so that
[3bac165]110 you can handle connections to secure POP3 and IMAP servers.</para>
[481b3e8]111
[3bac165]112 <para><parameter>--enable-fallback=procmail</parameter>: This tells
113 <application>Fetchmail</application> to hand incoming mail to
[876ad7f]114 <application>Procmail</application> for delivery, if the port 25 mail server is
[3bac165]115 not present or not responding.</para>
[481b3e8]116
[3bac165]117 </sect2>
[481b3e8]118
[3bac165]119 <sect2 role="configuration">
120 <title>Configuring Fetchmail</title>
[481b3e8]121
[3bac165]122 <sect3 id="fetchmail-config">
[e3353b3]123 <title>Config Files</title>
[481b3e8]124
[3bac165]125 <para><filename>~/.fetchmailrc</filename></para>
[481b3e8]126
[3bac165]127 <indexterm zone="fetchmail fetchmail-config">
128 <primary sortas="e-AA.fetchmailrc">~/.fetchmailrc</primary>
129 </indexterm>
[481b3e8]130
[3bac165]131 </sect3>
[481b3e8]132
[3bac165]133 <sect3>
134 <title>Configuration Information</title>
[481b3e8]135
[3bac165]136<screen><userinput>cat &gt; ~/.fetchmailrc &lt;&lt; "EOF"
137<literal>set logfile /var/log/fetchmail.log
[bfe245f]138set no bouncemail
139set postmaster root
[481b3e8]140
141poll SERVERNAME :
[061ec9d]142 user <replaceable>&lt;username&gt;</replaceable> pass <replaceable>&lt;password&gt;</replaceable>;
[3bac165]143 mda "/usr/bin/procmail -f %F -d %T";</literal>
144EOF
[481b3e8]145
[e3353b3]146chmod -v 0600 ~/.fetchmailrc</userinput></screen>
[481b3e8]147
148 <para>This is an example configuration that should suffice for most people.
[3bac165]149 You can add as many users and servers as you need using the same syntax.</para>
[481b3e8]150
[c48bc3ba]151 <para><command>man fetchmail</command>: Look for the section near the
152 bottom named <emphasis>CONFIGURATION EXAMPLES</emphasis>. It gives some
153 quick examples. There are countless other configuration options once you
154 get used to it.</para>
[481b3e8]155
[3bac165]156 </sect3>
[481b3e8]157
[3bac165]158 </sect2>
[481b3e8]159
[3bac165]160 <sect2 role="content">
161 <title>Contents</title>
[481b3e8]162
[3bac165]163 <segmentedlist>
[832d359b]164 <segtitle>Installed Programs</segtitle>
[3bac165]165 <segtitle>Installed Libraries</segtitle>
166 <segtitle>Installed Directories</segtitle>
[481b3e8]167
[3bac165]168 <seglistitem>
169 <seg>fetchmail and fetchmailconf</seg>
170 <seg>None</seg>
[46441976]171 <seg>None</seg>
[3bac165]172 </seglistitem>
173 </segmentedlist>
[481b3e8]174
[3bac165]175 <variablelist>
176 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
177 <?dbfo list-presentation="list"?>
178 <?dbhtml list-presentation="table"?>
[481b3e8]179
[3bac165]180 <varlistentry id="fetchmail-prog">
181 <term><command>fetchmail</command></term>
182 <listitem>
[876ad7f]183 <para>when executed as a user, this will source
184 <filename>~/.fetchmailrc</filename> and download the appropriate mail.
185 </para>
[3bac165]186 <indexterm zone="fetchmail fetchmail-prog">
187 <primary sortas="b-fetchmail">fetchmail</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
[481b3e8]191
[3bac165]192 <varlistentry id="fetchmailconf">
193 <term><command>fetchmailconf</command></term>
194 <listitem>
[876ad7f]195 <para>it will assist you in setting up and editing a
196 <filename>~/.fetchmailrc</filename> configuration file, by using
197 a <application>Tk</application> GUI interface. It requires
198 <application>Python</application> and it must have the Tkinker module
[3bac165]199 available.</para>
200 <indexterm zone="fetchmail fetchmailconf">
201 <primary sortas="b-fetchmailconf">fetchmailconf</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
[481b3e8]205
[3bac165]206 </variablelist>
[481b3e8]207
[3bac165]208 </sect2>
[481b3e8]209
[f45b1953]210</sect1>
Note: See TracBrowser for help on using the repository browser.