source: networking/mailnews/fetchmail.xml@ d719805

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since d719805 was 6d2249e, checked in by Ken Moffat <ken@…>, 7 years ago

tags

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

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