source: networking/mailnews/fetchmail.xml@ 4f9e6ae5

11.0 lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4f9e6ae5 was 4f9e6ae5, checked in by Douglas R. Reno <renodr@…>, 6 months ago

Update to phonon-backend-vlc-0.11.3
Update to libXaw-1.0.14 (Xorg Library)
Update to dbus-glib-0.112
Update to fetchmail-6.4.18

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

  • Property mode set to 100644
File size: 9.0 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 "36e8beb20eca5554352182977af3c25d">
10 <!ENTITY fetchmail-size "1.3 MB">
11 <!ENTITY fetchmail-buildsize "17 MB including tests">
12 <!ENTITY fetchmail-time "0.1 SBU including tests">
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>
33 The <application>Fetchmail</application> package contains a mail
34 retrieval program. It retrieves mail from remote mail servers and
35 forwards it to the local (client) machine's delivery system, so it can
36 then be read by normal mail user agents.
37 </para>
38
39 &lfs101_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing='compact'>
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&fetchmail-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&fetchmail-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &fetchmail-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &fetchmail-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &fetchmail-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &fetchmail-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Fetchmail Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
79 a local MDA (<xref linkend="procmail"/>)
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <!-- hesiod was at ftp://athena-dist.mit.edu/pub/ATHENA/hesiod/ but that
85 is dead. Debian had 3.2.1, git hub has a very old 3.1.
86 libintl is part of gettext so enabled by default on LFS -->
87 <xref linkend="mitkrb"/> and
88 <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/">libgssapi</ulink>
89 </para>
90
91 <bridgehead renderas="sect4">Optional (for running fetchmailconf)</bridgehead>
92 <para role="optional">
93 <xref linkend="python3"/>, built after
94 <xref linkend="tk"/>, with the
95 <ulink url="http://python-future.org/">py-future</ulink> package
96 </para>
97
98 <para condition="html" role="usernotes">User Notes:
99 <ulink url="&blfs-wiki;/fetchmail"/></para>
100
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of Fetchmail</title>
105
106 <para>
107 Create a dedicated user for the fetchmail program.
108 Issue the following commands as the
109 <systemitem class="username">root</systemitem> user:
110 </para>
111
112<screen role="root"><userinput>useradd -c "Fetchmail User" -d /dev/null -g nogroup \
113 -s /bin/false -u 38 fetchmail</userinput></screen>
114
115 <para>
116 Install <application>Fetchmail</application> by running the following
117 commands:
118 </para>
119
120<screen><userinput>PYTHON=python3 \
121./configure --prefix=/usr \
122 --enable-fallback=procmail &amp;&amp;
123make</userinput></screen>
124
125 <para>
126 To test the results, issue: <command>make check</command>.
127 </para>
128
129
130 <para>
131 Now, as the <systemitem class="username">root</systemitem> user:
132 </para>
133
134<screen role='root'><userinput>make install &amp;&amp;
135chown -v fetchmail:nogroup /usr/bin/fetchmail</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>
143 <parameter>PYTHON=python3</parameter>: a version of Python is
144 <emphasis>required</emphasis>, but only used to install a module to allow
145 fetchmailconf to be run. That module is unmaintained and should not be
146 used.
147 </para>
148
149 <para>
150 <parameter>--enable-fallback=procmail</parameter>: This tells
151 <application>Fetchmail</application> to hand incoming mail to
152 <application>Procmail</application> for delivery, if the port 25 mail
153 server is not present or not responding.
154 </para>
155
156 </sect2>
157
158 <sect2 role="configuration">
159 <title>Configuring Fetchmail</title>
160
161 <sect3 id="fetchmail-config">
162 <title>Config Files</title>
163
164 <para>
165 <filename>~/.fetchmailrc</filename>
166 </para>
167
168 <indexterm zone="fetchmail fetchmail-config">
169 <primary sortas="e-AA.fetchmailrc">~/.fetchmailrc</primary>
170 </indexterm>
171
172 </sect3>
173
174 <sect3>
175 <title>Configuration Information</title>
176
177<screen><userinput>cat &gt; ~/.fetchmailrc &lt;&lt; "EOF"
178<literal>
179# The logfile needs to exist when fetchmail is invoked, otherwise it will
180# dump the details to the screen. As with all logs, you will need to rotate
181# or clear it from time to time.
182set logfile fetchmail.log
183set no bouncemail
184# You probably want to set your local username as the postmaster
185set postmaster <replaceable>&lt;username&gt;</replaceable>
186
187poll SERVERNAME :
188 user <replaceable>&lt;isp_username&gt;</replaceable> pass <replaceable>&lt;password&gt;</replaceable>;
189 mda "/usr/bin/procmail -f %F -d %T";</literal>
190EOF
191
192touch ~/fetchmail.log &amp;&amp;
193chmod -v 0600 ~/.fetchmailrc</userinput></screen>
194
195 <para>
196 This is an example configuration that should suffice for most people.
197 You can add as many users and servers as you need using the same syntax.
198 </para>
199
200 <para>
201 <command>man fetchmail</command>: Look for the section near the bottom
202 named <emphasis>CONFIGURATION EXAMPLES</emphasis>. It gives some quick
203 examples. There are countless other configuration options once you get
204 used to it.
205 </para>
206
207 <para>
208 If you expect to receive very little mail you can invoke fetchmail
209 when you wish to receive any incoming mail. More commonly, it is either
210 invoked in daemon mode with the <literal>-d</literal> option either on
211 the command line, or in <filename>.fetchmailrc</filename> (see 'DAEMON
212 MODE' in man fetchmailconf), or alternatively it is invoked from a
213 cron job.
214 </para>
215
216 </sect3>
217
218 </sect2>
219
220 <sect2 role="content">
221 <title>Contents</title>
222
223 <segmentedlist>
224 <segtitle>Installed Programs</segtitle>
225 <segtitle>Installed Libraries</segtitle>
226 <segtitle>Installed Directories</segtitle>
227
228 <seglistitem>
229 <seg>fetchmail and fetchmailconf</seg>
230 <seg>None</seg>
231 <seg>None</seg>
232 </seglistitem>
233 </segmentedlist>
234
235 <variablelist>
236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
237 <?dbfo list-presentation="list"?>
238 <?dbhtml list-presentation="table"?>
239
240 <varlistentry id="fetchmail-prog">
241 <term><command>fetchmail</command></term>
242 <listitem>
243 <para>
244 when executed as a user, this will source
245 <filename>~/.fetchmailrc</filename> and download the appropriate
246 mail
247 </para>
248 <indexterm zone="fetchmail fetchmail-prog">
249 <primary sortas="b-fetchmail">fetchmail</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="fetchmailconf">
255 <term><command>fetchmailconf</command></term>
256 <listitem>
257 <para>
258 is intended to assist you in setting up and editing a
259 <filename>~/.fetchmailrc</filename> configuration file, by using
260 a <application>Tk</application> GUI interface. It is written for
261 <application>Python</application> and the Tkinter module but is
262 labelled with a WARNING that it needs to be updated
263 for fetchmail 6.4's SSL options and other recent new options
264 </para>
265 <!-- keep this description commented but fetchmailconf
266 has been updated in the last months (June 2020). It can use
267 Python 3, with the help of the "past" module.
268 <para>
269 is an unmaintained GUI command to assist in creating a
270 <filename>~/.fetchmailrc</filename> configuration file and
271 should not be used.
272 </para>-->
273 <indexterm zone="fetchmail fetchmailconf">
274 <primary sortas="b-fetchmailconf">fetchmailconf</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 </variablelist>
280
281 </sect2>
282
283</sect1>
Note: See TracBrowser for help on using the repository browser.