]> Pileus Git - ~andy/fetchmail/blob - website/index.html
Update documents/scripts after SVN -> Git move.
[~andy/fetchmail] / website / index.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2     "http://www.w3.org/TR/html4/loose.dtd">
3 <html>
4 <head>
5 <link rel="stylesheet" href="sitestyle.css" type="text/css">
6 <meta name="description" content="The Fetchmail Project">
7 <meta name="keywords" content="fetchmail, pop3, imap, email, mail">
8 <meta name="MSSmartTagsPreventParsing" content="TRUE">
9 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
10 <title>Fetchmail</title>
11 </head>
12 <body>
13
14 <div id="Header">
15 <table width="100%" cellpadding="0" summary="Canned page header">
16 <tr>
17 <td>Fetchmail</td>
18 <td align="right"><!-- update date -->2010-02-05</td>
19 </tr>
20 </table>
21 </div>
22
23 <div id="Menu">
24         <hr>
25         <a href="index.html" title="Main">Main</a><br>
26         <a href="fetchmail-features.html">Features</a><br>
27         <a href="fetchmail-man.html">Manual</a><br>
28         <a href="fetchmail-FAQ.html" title="Fetchmail FAQ">FAQ</a><br>
29         <a href="fetchmail-FAQ.pdf" title="Fetchmail FAQ as PDF">FAQ (PDF)</a><br>
30         <a href="design-notes.html">Design Notes</a><br>
31         <a href="http://developer.berlios.de/project/showfiles.php?group_id=1824">Download</a><br>
32         <a href="http://gitorious.org/fetchmail/fetchmail/">Development Code</a><br>
33         <a href="http://developer.berlios.de/projects/fetchmail/">Project Page</a><br>
34         <hr>
35 </div>
36
37 <div id="Content">
38
39 <img src="bighand.png" width="100" height="71" alt="logo: a hand presenting an envelope" align="right">
40
41 <h1>Fetchmail</h1>
42
43 <div style="background-color:#c0ffc0;color:#000000;">
44     <h1>NEWS: FETCHMAIL 6.3.14 RELEASE</h1>
45     <p>On 2010-02-05, <a
46         href="http://developer.berlios.de/project/showfiles.php?group_id=1824">fetchmail-6.3.14
47         has been released (this is the download link),</a> fixing a security
48       issue (see below) and some IMAP client bugs. Notably, IMAP2 functionality
49       has been restored and servers that refuse the SEARCH command are now
50       supported.
51
52     It is a recommended update for all users. <a
53         href="http://developer.berlios.de/project/shownotes.php?group_id=1824&amp;release_id=17213">Click
54         here to see the change details.</a>
55     </p>
56 </div>
57
58 <div style="background-color:#ffe0c0;color:#000000;font-size:85%"> <h1>SECURITY ALERTS</h1>
59     <p style="font-size:100%">These security issues (listed immediately below) have become
60     known to the fetchmail maintainer to the date mentioned above. Note
61     that fetchmail 6.2.X and older are no longer supported and contain
62     some of the problems mentioned below, even if they aren't mentioned
63     in the security announcements:</p>
64     <ul>
65         <li>CVE-XXXX-XXXX: Fetchmail <a href="fetchmail-SA-2010-01.txt">would overrun the heap when displaying X.509 TLS/SSL certificates with characters with high bit set in verbose mode on platforms where char is a signed type.</a> This bug was introduced in release 6.3.11 and has been fixed in release 6.3.14.</li>
66         <li><a name="cve-2009-2666" href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2009-2666">CVE-2009-2666:</a> Fetchmail <a href="fetchmail-SA-2009-01.txt">was found to validate SSL/TLS X.509 certificates improperly and allow man-in-the-middle-attacks to go undetected.</a> This bug has been fixed in release 6.3.11. For previous versions, use the <a href="fetchmail-SA-2009-01.txt">patch contained in the security announcement.</a></li>
67         <li><a name="cve-2008-2711" href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-2711">CVE-2008-2711:</a> Fetchmail can <a href="fetchmail-SA-2008-01.txt">crash in verbose mode when logging long message headers.</a> This bug has been fixed in release 6.3.9. For 6.3.8, use the <a href="fetchmail-SA-2008-01.txt">patch contained in the security announcement.</a></li>
68         <li><a name="cve-2007-4565" href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-4565">CVE-2007-4565:</a> Fetchmail can <a href="fetchmail-SA-2007-02.txt">crash when the SMTP server refuses a warning message generated by fetchmail.</a> This bug was introduced in fetchmail 4.6.8 and has been fixed in release 6.3.9. For 6.3.8, use the <a href="fetchmail-SA-2007-02.txt">patch contained in this security announcement.</a></li>
69         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-1558">CVE-2007-1558:</a> Fetchmail's APOP client was found to <a href="fetchmail-SA-2007-01.txt">validate APOP challenges insufficiently, making man-in-the-middle attacks on APOP secrets unnecessarily easier than need be.</a> This bug was long-standing, fetchmail 6.3.8 and newer validate the APOP challenge more strictly.</li>
70         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-5974">CVE-2006-5974:</a> Fetchmail was found to <a href="fetchmail-SA-2006-03.txt">crash when refusing a message that was bound to be delivered by an MDA.</a> This bug was introduced into fetchmail 6.3.5 and fixed in 6.3.6.</li>
71         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-5867">CVE-2006-5867:</a> Fetchmail was found to <a href="fetchmail-SA-2006-02.txt">omit TLS or send the password in clear text despite the configuration stating otherwise.</a> This was a long-standing bug reported by Isaac Wilcox, fixed in fetchmail 6.3.6. There will be no 6.2.X releases to fix this bug in 6.2.X.</li>
72         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-0321">CVE-2006-0321:</a> Fetchmail was found to <a href="fetchmail-SA-2006-01.txt">crash after bouncing a message with bad addresses. This bug was introduced with fetchmail 6.3.0 and fixed in fetchmail 6.3.2.</a></li>
73         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2005-4348">CVE-2005-4348:</a> Fetchmail was found to contain <a href="fetchmail-SA-2005-03.txt">a bug (null pointer dereference) that can be exploited to a denial of service attack</a> when fetchmail runs in multidrop mode. 6.2.5.5 and 6.3.1 have this bug fixed.</li>
74         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2005-3088">CVE-2005-3088:</a> Fetchmailconf was found to <a href="fetchmail-SA-2005-02.txt">open the configuration files world-readable, writing data to them, and only then tightening up permissions</a>, which may cause password information to be visible to other users. This bug affected fetchmail 6.2.0, 6.2.5 and 6.2.5.2.  The bug is fixed in fetchmail 6.2.5.4 and 6.3.0.</li>
75         <li><a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2005-2335">CVE-2005-2335:</a> Fetchmail was found to contain a <a href="fetchmail-SA-2005-01.txt">remotely exploitable code injection vulnerability (potentially privileged code)</a> in the POP3 code, affecting both the 6.2.0 and 6.2.5 releases. 6.2.5.2, 6.2.5.4 and 6.3.0 have got this bug fixed. (Other versions have not been checked if they contain this bug.)</li>
76 </ul>
77
78 <p style="font-size:100%"><strong>Please <a
79         href="http://developer.berlios.de/project/showfiles.php?group_id=1824">update
80         to the newest fetchmail version</a>.</strong></p>
81
82 </div>
83
84 <h1>What fetchmail does:</h1>
85
86 <p>Fetchmail is a full-featured, robust, well-documented
87 remote-mail retrieval and forwarding utility intended to be used over
88 on-demand TCP/IP links (such as SLIP or PPP connections). It supports
89 every remote-mail protocol now in use on the Internet: POP2, POP3,
90 RPOP, APOP, KPOP, all flavors of <a
91 href="http://www.imap.org">IMAP</a>, ETRN, and ODMR. It can even
92 support IPv6 and IPSEC.</p>
93
94 <p>Fetchmail retrieves mail from remote mail servers and forwards it via
95 SMTP, so it can then be read by normal mail user agents such as <a
96 href="http://www.mutt.org/">mutt</a>, elm(1) or BSD Mail.
97 It allows all your system MTA's filtering, forwarding, and aliasing
98 facilities to work just as they would on normal mail.</p>
99
100 <p>Fetchmail offers better protection against password-sniffing than any
101 other Unix remote-mail client.  It supports APOP, KPOP, OTP, Compuserve
102 RPA, Microsoft NTLM, and IMAP RFC1731 encrypted authentication methods
103 including CRAM-MD5 to avoid sending passwords en clair. It can be
104 configured to support end-to-end encryption via tunneling with <a
105 href="http://www.openssh.com/">ssh, the Secure Shell</a>.</p>
106
107 <p>Fetchmail can be used as a POP/IMAP-to-SMTP gateway for an entire DNS
108 domain, collecting mail from a single drop box on an ISP and
109 SMTP-forwarding it based on header addresses. (We don't really
110 recommend this, though, as it may lose important envelope-header
111 information.  ETRN or a UUCP connection is better.)</p>
112
113 <p>Fetchmail can be started automatically and silently as a system daemon
114 at boot time.  When running in this mode with a short poll interval,
115 it is pretty hard for anyone to tell that the incoming mail link is
116 not a full-time "push" connection.</p>
117
118 <p>Fetchmail is easy to configure.  You can edit its dotfile directly, or
119 use the interactive GUI configurator (fetchmailconf) supplied with the
120 fetchmail distribution.  It is also directly supported in linuxconf
121 versions 1.16r8 and later.</p>
122
123 <p>Fetchmail is fast and lightweight.  It packs all its standard
124 features (POP3, IMAP, and ETRN support) in 196K of core on a
125 Pentium under Linux.</p>
126
127 <p>Fetchmail is <a href="http://www.opensource.org">open-source</a>
128 and <a href="http://www.gnu.org/philosophy/free-sw.html">free
129 software</a>.</p>
130
131 <h1>Where to find out more about fetchmail:</h1>
132
133 <p>See the <a href="fetchmail-features.html">Fetchmail Feature List</a> for more
134 about what fetchmail does.</p>
135
136 <p>See the on-line <a href="fetchmail-man.html">manual page</a> for
137 basics.</p>
138
139 <p>See the <a href="fetchmail-FAQ.html">HTML Fetchmail FAQ</a> for
140 troubleshooting help.</p>
141
142 <p>See the <a href="design-notes.html">Fetchmail Design Notes</a>
143 for discussion of some of the design choices in fetchmail.</p>
144
145 <p>See the project's <a href="todo.html">To-Do list</a> for indications
146 of known problems and requested features.</p>
147
148 <p>The developers use <a href="http://git-scm.com/">Git</a> for revision
149 control.  To browse the repository or to get the latest development version,
150 find the instructions at <a href="http://gitorious.org/fetchmail/fetchmail">http://gitorious.org/fetchmail/fetchmail</a>.</p>
151
152 <p>See the <a href="http://developer.berlios.de/projects/fetchmail/">project
153 page</a> for more, including <a
154 href="http://developer.berlios.de/project/showfiles.php?group_id=1824">downloads</a>.</p>
155
156 <h1>Getting help with fetchmail:</h1>
157
158 <p>Before submitting a question anywhere, <strong>please read the <a
159 href="fetchmail-FAQ.html">FAQ</a></strong> (especially item <a
160 href="fetchmail-FAQ.html#G3">G3</a> on how to report problems).  We tend to get
161 the same three newbie questions over and over again.  The FAQ covers them like
162 a blanket.</p>
163
164 <p>There is a fetchmail-users list for help and other user discussion
165 of fetchmail.  It's a MailMan list, which you can sign up for at <a
166 href="http://lists.berlios.de/mailman/listinfo/fetchmail-users">
167 fetchmail-users@lists.berlios.de</a>. 
168 <br>There is also a
169 fetchmail-devel list for people who want to discuss fixes and
170 improvements in fetchmail and help co-develop it.  That one is at <a
171 href="http://lists.berlios.de/mailman/listinfo/fetchmail-devel">
172 fetchmail-devel@lists.berlios.de</a>.
173 <br>Finally, there is an announcements-only list, <a
174 href="http://lists.berlios.de/mailman/listinfo/fetchmail-announce">
175 fetchmail-announce@lists.berlios.de</a>.</p>
176
177 <h1>Maintainer History</h1>
178 <p>Fetchmail originated as a program called <i>popclient</i>, written
179 by Carl Harris.  In 1996, <a href="http://www.catb.org/~esr/">Eric
180 S. Raymond</a> took over; he soon renamed the program to fetchmail after
181 adding IMAP support.</p>
182 <p>In 2004 a new team took over, led by <a
183 href="http://developer.berlios.de/users/rfunk/">Rob Funk</a>, <a
184 href="http://developer.berlios.de/users/bob/">Graham Wilson</a>, and <a
185 href="http://developer.berlios.de/users/m-a/">Matthias Andree</a>. Since then,
186 Graham Wilson has retreated, and <a
187 href="http://developer.berlios.de/users/shetye/">Sunil Shetye</a> has
188 contributed several important pieces of code.</p>
189
190 <h1>You can help improve fetchmail:</h1>
191
192 <p>We welcome your code contributions.  But even if you don't write code,
193 you can help fetchmail improve.</p>
194
195 <p><strong>If you administer a site that runs a post-office server, you may be
196 able help improve fetchmail by lending us a test account on your site.
197 Note that we do not need a shell account for this purpose, just a 
198 mailbox and a mail address.  Nor are we interested in collecting maildrops per
199 se -- what we're collecting is different <em>kinds of servers</em>.</strong></p>
200
201 <p>Before each release, we run a test harness that sends date-stamped 
202 test mail to each site on our regression-test list, then tries to
203 retrieve it.  Please take a look at the <a href="testservers.html">
204 list of test servers</a>.  If you can lend us an account on a kind
205 of server that is <em>not</em> already on this list, please do.</p>
206
207 <h1>Where you can use fetchmail:</h1>
208
209 <p>The fetchmail code was developed under Linux, but has also been
210 extensively tested under 4.4BSD, SunOS, Solaris, AIX, and NEXTSTEP.  It
211 should be readily portable to other Unix variants (it requires only
212 POSIX plus BSD sockets, and uses GNU autoconf).</p>
213
214 <p>Fetchmail is supported only for Unix by its official maintainers.
215 However, it is reported to build and run correctly under BeOS,
216 AmigaOS, Rhapsody, and QNX as well.  There is a CygWin port.</p>
217
218 <h1>Related works</h1>
219
220 <h2>Similar software</h2>
221
222 <p><strong>fdm:</strong> A recently appeared software package that integrates basic filtering is <a href="http://fdm.sourceforge.net/">Nicholas Marriott's fdm</a>.
223
224 <p><strong>getmail:</strong> When fetchmail's development was
225 stalled before the latest team took over, <a
226 href="http://pyropus.ca/software/getmail/">Charles Cazabon's getmail</a> came
227 along as an intended replacement.  It still doesn't do everything that
228 fetchmail does, and often suffers from Python library shortcomings, for
229 instance when it comes to SSL, but it's close enough to give us a bit of
230 competition.</p>
231
232 <p><strong>animail:</strong> Another contender with integrated filtering is <a href="http://juanjoalvarez.net/animaileng">Juanjo Álvarez Martínez's Animail</a>.</p>
233
234 <h2>Complementary and extension software</h2>
235
236 <p>Jochen Hayek is developing a set of
237 <a href="http://www.b.shuttle.de/hayek/JHimap_utils/">
238 IMAP tools in Python</a> that read your .fetchmailrc file and are
239 designed to work with fetchmail.   Jochen's tools can report selected
240 header lines, or move incoming messages to named mailboxes based on
241 the contents of headers.</p>
242
243 <!-- no longer true
244 <p>Donncha O Caoihm has written a Perl script called 
245 <a href="http://blogs.linux.ie/xeer/install-sendmail/">install-sendmail</a>
246 that assists you in installing sendmail and fetchmail together.</p>
247 -->
248
249 <p>Peter Hawkins has written a script called <a
250 href="http://linux.cudeso.be/linuxdoc/gotmail.php">gotmail</a> that
251 can retrieve Hotmail. Another script, <a
252 href="http://yosucker.sourceforge.net">yosucker</a>, can retrieve
253 Yahoo webmail.</p>
254
255 <p>There's a program called
256 <a href="http://mailfilter.sourceforge.net/">mailfilter</a> which can be used
257 to do spam filtering, that works particularly well called from fetchmail's
258 <code>preconnect</code> directive.</p>
259
260 <p>A hacker identifying himself simply as 'Steines' has written a
261 filter which rewrites the to-line with a line which only includes
262 receipients for a given domain and renames the old to-line. It also
263 rewrites the domain-part of addresses if the offical domain is
264 different from the local domain. You can find it <a 
265 href="http://www.steines.com/mailf/">here</a>.</p>
266
267 </div>
268
269 <p align="right">
270 <a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01 Transitional" height="31" width="88"></a>
271 <a href="http://jigsaw.w3.org/css-validator/"> <img style="border:0;width:88px;height:31px" src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"> </a>
272 <a href="http://developer.berlios.de"> <img src="http://developer.berlios.de/bslogo.php?group_id=1824&amp;type=1" width="124" height="32" border="0" alt="BerliOS Logo"></a> 
273 </p>
274 </body>
275 </html>