Pileus Git - ~andy/fetchmail/blob - indexgen.sh

   1 #!/bin/sh
   2 #
   3 # indexgen.sh -- generate current version of fetchmail home page.
   4 #
   5 goldvers="5.3.0"
   6 goldname="5.3.0"
   7 version=`sed -n <Makefile.in "/VERSION *= */s/VERSION *= *\([^  ]*\)/\1/p"`
   8 date=`date "+%d %b %Y"`
   9
  10 set -- `timeseries | grep -v "%" | head -1`
  11 subscribers=$4
  12 set -- `ls -ks fetchmail`
  13 fetchmailsize=$1
  14 set -- `(cd /lib; ls libc-*)`
  15 glibc=`echo $1 | sed 's/libc-\(.*\)\.so/\1/'`
  16 glibc="glibc-$glibc"
  17
  18 rm -f index.html
  19
  20 # Compute MD5 checksums for security audit
  21 rm -f checksums
  22 for file in fetchmail-$version.tar.gz fetchmail-$version-1.i386.rpm fetchmail-$version-1.src.rpm
  23 do
  24     md5sum $file >>checksums
  25 done
  26
  27 if [ $version != $goldvers ]
  28 then
  29     for file in fetchmail-$goldvers.tar.gz fetchmail-$goldvers-1.i386.rpm fetchmail-$goldvers-1.src.rpm
  30     do
  31         md5sum $file >>checksums
  32     done
  33 fi
  34
  35 cat >index.html <<EOF
  36 <!doctype HTML public "-//W3O//DTD W3 HTML 3.2//EN">
  37 <HTML>
  38 <HEAD>
  39 <TITLE>Fetchmail Home Page</TITLE>
  40 <link rev=made href=mailto:esr@snark.thyrsus.com>
  41 <meta name="description" content="The fetchmail home page.">
  42 <meta name="keywords" content="fetchmail, POP, POP3, IMAP, IMAP2bis, IMAP4, IMAP4rev1, ETRN, OTP, RPA">
  43 </HEAD>
  44 <BODY>
  45 <table width="100%" cellpadding=0><tr>
  46 <td width="30%">Back to
  47 <a href="http://$WWWVIRTUAL/~esr/software.html">Software</a>
  48 <td width="30%" align=center>Up to <a href="http://$WWWVIRTUAL/~esr/sitemap.html">Site Map</a>
  49 <td width="30%" align=right>$date
  50 </table>
  51 <HR>
  52 <center>
  53 <table border="10">
  54 <tr>
  55 <td>
  56 <center><img src="bighand.png"></center>
  57 </td>
  58 </tr>
  59 </table>
  60 <H1>The fetchmail Home Page</H1>
  61 </center><P>
  62
  63 <H1>What fetchmail does:</H1>
  64
  65 Fetchmail is a full-featured, robust, well-documented
  66 remote-mail retrieval and forwarding utility intended to be used over
  67 on-demand TCP/IP links (such as SLIP or PPP connections). It supports
  68 every remote-mail protocol now in use on the Internet: POP2, POP3,
  69 RPOP, APOP, KPOP, all flavors of <a
  70 href="http://www.imap.org">IMAP</a>, and ESMTP ETRN. It can even
  71 support IPv6 and IPSEC.<P>
  72
  73 Fetchmail retrieves mail from remote mail servers and forwards it via
  74 SMTP, so it can then be be read by normal mail user agents such as <a
  75 href="http://www.mutt.org/">mutt</a>, elm(1) or BSD Mail.
  76 It allows all your system MTA's filtering, forwarding, and aliasing
  77 facilities to work just as they would on normal mail.<P>
  78
  79 Fetchmail offers better security than any other Unix remote-mail
  80 client.  It supports APOP, KPOP, OTP, Compuserve RPA, Microsoft NTLM,
  81 and IMAP RFC1731 encrypted authentication methods to avoid sending
  82 passwords en clair. It can be configured to support end-to-end
  83 encryption via tunneling with <a href="http://www.cs.hut.fi/ssh/">ssh,
  84 the Secure Shell</a><p>
  85
  86 Fetchmail can be used as a POP/IMAP-to-SMTP gateway for an entire DNS
  87 domain, collecting mail from a single drop box on an ISP and
  88 SMTP-forwarding it based on header addresses. (We don't really
  89 recommend this, though, as it may lose important envelope-header
  90 information.  ETRN or a UUCP connection is better.)<p>
  91
  92 Fetchmail can be started automatically and silently as a system daemon
  93 at boot time.  When running in this mode with a short poll interval,
  94 it is pretty hard for anyone to tell that the incoming mail link is
  95 not a full-time "push" connection.<p>
  96
  97 Fetchmail is easy to configure.  You can edit its dotfile directly, or
  98 use the interactive GUI configurator (fetchmailconf) supplied with the
  99 fetchmail distribution.  It is also directly supported in linuxconf
 100 versions 1.16r8 and later.<P>
 101
 102 Fetchmail is fast and lightweight.  It packs all its standard
 103 features (POP3, IMAP, and ETRN support) in ${fetchmailsize}K of core on a
 104 Pentium under Linux.<p>
 105
 106 Fetchmail is <a href="http://www.opensource.org">open-source</a>
 107 software.  The openness of the sources is your strongest possible
 108 assurance of quality and reliability.<P>
 109
 110 <H1>Where to find out more about fetchmail:</H1>
 111
 112 See the <a href="fetchmail-features.html">Fetchmail Feature List</a> for more
 113 about what fetchmail does.<p>
 114
 115 See the on-line <a href="fetchmail-man.html">manual page</a> for
 116 basics. (Sorry about the flat presentation, but
 117 the man2html shipped with RH6.0 chokes and dies on the fetchmail man page.<p>
 118
 119 See the <a href="fetchmail-FAQ.html">HTML Fetchmail FAQ</A> for
 120 troubleshooting help.<p>
 121
 122 See the <a href="design-notes.html">Fetchmail Design Notes</a>
 123 for discussion of some of the design choices in fetchmail.<P>
 124
 125 <H1>How to get fetchmail:</H1>
 126
 127 You can get any of the following leading-edge resources here:
 128 <UL>
 129 <LI> <a href="fetchmail-$version.tar.gz">
 130         Gzipped source archive of fetchmail $version</a>
 131 <LI> <a href="fetchmail-$version-1.i386.rpm">
 132         Intel binary RPM of fetchmail $version (uses $glibc)</a>
 133 <LI> <a href="fetchmail-$version-1.src.rpm">
 134         Source RPM of fetchmail $version</a>
 135 </UL>
 136
 137 MD5 <a href="checksums">checksums</a> are available for these files.<p>
 138 EOF
 139
 140 if [ $version != $goldvers ]
 141 then
 142     cat >>index.html <<EOF
 143
 144 Or you can get the last \`gold' version, $goldname:
 145 <UL>
 146 <LI> <a href="fetchmail-$goldvers.tar.gz">
 147         Gzipped source archive of fetchmail $goldname</a>
 148 <LI> <a href="fetchmail-$goldvers-1.i386.rpm">
 149         Intel binary RPM of fetchmail $goldname (uses glibc)</a>
 150 <LI> <a href="fetchmail-$goldvers-1.alpha.rpm">
 151         Alpha binary RPM of fetchmail $goldname (uses glibc)</a>
 152 <LI> <a href="fetchmail-$goldvers-1.src.rpm">
 153         Source RPM of fetchmail $goldname</a>
 154 </UL>
 155 For differences between the leading-edge $version and gold $goldname versions,
 156 see the distribution <a href="NEWS">NEWS</a> file.<p>
 157 EOF
 158 fi
 159
 160 cat >>index.html <<EOF
 161 (Note that the binary RPMs don't have the POP2, OTP, IPv6, Kerberos,
 162 GSSAPI, Compuserve RPA, Microsoft NTLM, or GNU gettext
 163 internationalization support compiled in.  To get any of these you
 164 will have to build from sources.)<p>
 165
 166 The latest version of fetchmail is also carried in the
 167 <a href="http://metalab.unc.edu/pub/Linux/system/mail/pop/!INDEX.html">
 168 Metalab remote mail tools directory</a>.
 169
 170 <H1>Getting help with fetchmail:</H1>
 171
 172 There is a fetchmail-friends list for people who want to discuss fixes
 173 and improvements in fetchmail and help co-develop it.  It's at <a
 174 href="mailto:fetchmail-friends@ccil.org">fetchmail-friends@ccil.org</a>.
 175 There is also an announcements-only list, <em>fetchmail-announce@ccil.org</em>.<P>
 176
 177 Both lists are SmartList reflectors; sign up in the usual way with a
 178 message containing the word "subscribe" in the subject line sent to
 179 <a href="mailto:fetchmail-friends-request@ccil.org?subject=subscribe">
 180 fetchmail-friends-request@ccil.org</a> or
 181 <a href="mailto:fetchmail-announce-request@ccil.org?subject=subscribe">
 182 fetchmail-announce-request@ccil.org</a>. (Similarly, "unsubscribe"
 183 in the Subject line unsubscribes you, and "help" returns general list help) <p>
 184
 185 Note: before submitting a question to the list, <strong>please read
 186 the <a href="fetchmail-FAQ.html">FAQ</a></strong> (especially item <a
 187 href="http:fetchmail-FAQ.html#G3">G3</a> on how to report bugs).  We
 188 tend to get the same three newbie questions over and over again.  The
 189 FAQ covers them like a blanket.<P>
 190
 191 Fetchmail was written and is maintained by <a
 192 href="../index.html">Eric S. Raymond</a>.  There are some designated
 193 backup maintainers (<a href="mailto:funk+@osu.edu">Rob Funk</a>, <a
 194 href="http://www.dallas.net/~fox/">David DeSimone aka Fuzzy Fox</a>,
 195 <a href="mailto:imdave@mcs.net">Dave Bodenstab</a>).  Other backup
 196 maintainers may be added in the future, in order to ensure continued
 197 support should Eric S.  Raymond drop permanently off the net for any
 198 reason.<P>
 199
 200 <H1>Who uses fetchmail:</H1>
 201
 202 Fetchmail entered full production status with the 2.0.0 version in
 203 November 1996 after about five months of evolution from the ancestral
 204 <IT>popclient</IT> utility. It has since come into extremely wide use
 205 in the Internet/Unix/Linux community.  The Red Hat, Debian and
 206 S.u.S.e. Linux distributions and their derivatives all include it.  A
 207 customized version is used at Whole Earth 'Lectronic Link. Several
 208 large ISPs are known to recommend it to Unix-using SLIP and PPP
 209 customers.<p>
 210
 211 Over seven hundred people have participated on the fetchmail beta list
 212 (at time of current release there were $subscribers on the friends and
 213 announce lists).  While it's hard to count the users of open-source
 214 software, we can estimate based on (a) population figures at the WELL
 215 and other known fetchmail sites, (b) the size of the Linux-using ISP
 216 customer base, and (c) the volume of fetchmail-related talk on USENET.
 217 These estimates suggest that daily fetchmail users number well into
 218 the tens of thousands, and possibly over a hundred thousand.<p>
 219
 220 <H1>The sociology of fetchmail:</H1>
 221
 222 The fetchmail development project was a sociological experiment as well
 223 as a technical effort.  I ran it as a test of some theories about why the
 224 Linux development model works.<P>
 225
 226 I wrote a paper, <A
 227 HREF="http://www.tuxedo.org/~esr/writings/cathedral-bazaar/">The
 228 Cathedral And The Bazaar</A>, about these theories and the project.
 229 I developed the line of analysis it suggested in two later essays.
 230 These papers became quite popular and (to my continuing astonishment) may
 231 have actually helped change the world.  Chase the title link, above,
 232 for links to all three papers.<P>
 233
 234 I have done some analysus on the information in the project NEWS file.
 235 You can view a <a href="history.html">statistical history</a> showing
 236 levels of participation and release frequency over time.<p>
 237
 238 <H1>Recent releases and where fetchmail is going:</H1>
 239
 240 Fetchmail is now sufficiently stable and effective that I'm getting
 241 very little pressure to fix things or add features.  Development has
 242 slowed way down, release frequency has dropped off, and we're
 243 basically in maintainance mode.  Barring any urgent bug fixes, my
 244 intention is to leave 5.0.0 alone for several months.<p>
 245
 246 Major changes or additions therefore seem unlikely until there are
 247 significant changes in or additions to the related protocol RFCs.  One
 248 development that would stimulate a new release almost instantly is the
 249 deployment of a standard lightweight encrypted authentication method
 250 for IMAP sessions.<p>
 251
 252 <H1>Where you can use fetchmail:</H1>
 253
 254 The fetchmail code was developed under Linux, but has also been
 255 extensively tested under 4.4BSD, SunOS, Solaris, AIX, and NEXTSTEP.  It
 256 should be readily portable to other Unix variants (it requires only
 257 POSIX plus BSD sockets, and uses GNU autoconf).<P>
 258
 259 Fetchmail is supported only for Unix by its official maintainers.
 260 However, it is reported to build and run correctly under AmigaOS,
 261 Rhapsody, and QNX as well. <p>
 262
 263 <H1>Related resources</H1>
 264
 265 Jochen Hayek is developing a set of
 266 <a href="http://www.ACM.org/~Jochen_Hayek/JHimap_utils/">
 267 IMAP tools in Python</a> that read your .fetchmailrc file and are
 268 designed to work with fetchmail.   Jochen's tools can report selected
 269 header lines, or move incoming messages to named mailboxes based on
 270 the contents of headers.<p>
 271
 272 Scott Bronson has written a fetchmail plugin (actually, a specialist
 273 MDA) called <a
 274 href="http://www.trestle.com/linux/trestlemail/">trestlemail</a> that
 275 helps redirect multidrop mail.<p>
 276
 277 Hugo Rabson has written a script called \`hotmole' that can retrieve
 278 Hotmail mail via the web using Lynx.  The script was available on <a
 279 href="http://www.jin-sei-kai.demon.co.uk/hugo/linux.html"> Hugo
 280 Rabson's Linux page</a>, but we are informed the project is now dead.<P>
 281
 282 <H1>Fetchmail's funniest fan letter:</H1>
 283
 284 <A HREF="funny.html">This letter</A> still cracks me up whenever I reread it.
 285
 286 <H1>The fetchmail button:</H1>
 287
 288 If you use fetchmail and like it, here's a nifty fetchmail button you
 289 can put on your web page:<P>
 290
 291 <center><img src="fetchmail.png"></center><P>
 292
 293 Thanks to <a href="http://www.gl.umbc.edu/~smatus1/">Steve
 294 Matuszek</a> for the graphic design.  The hand in the button (and the
 295 larger top-of-page graphic) was actually derived from a color scan of
 296 the fetchmail author's hand. <P>
 297
 298 <H1>Fetchmail mirror sites:</H1>
 299
 300 There is a FTP mirror of the fetchmail FTP directory (not this WWW
 301 home site, just the current sources and RPM) in Japan at
 302 <a href="ftp://ftp.win.or.jp/pub/network/mail/fetchmail">
 303 ftp://ftp.win.or.jp/pub/network/mail/fetchmail</a>.<P>
 304
 305 <H1>Reviews and Awards</H1>
 306
 307 Fetchmail was DaveCentral's Best Of Linux winner for
 308 <a href="http://linux.davecentral.com/bol_19990630.html">June 30 1999</a>.
 309
 310 <HR>
 311 <table width="100%" cellpadding=0><tr>
 312 <td width="30%">Back to
 313 <a href="http://$WWWVIRTUAL/~esr/software.html">Software</a>
 314 <td width="30%" align=center>Up to <a href="http://$WWWVIRTUAL/~esr/sitemap.html">Site Map</a>
 315 <td width="30%" align=right>$date
 316 </table>
 317
 318 <P><ADDRESS>Eric S. Raymond <A HREF="mailto:esr@thyrsus.com">&lt;esr@snark.thyrsus.com&gt;</A></ADDRESS>
 319 </BODY>
 320 </HTML>
 321 EOF
 322
 323 # The following sets edit modes for GNU EMACS
 324 # Local Variables:
 325 # mode:html
 326 # truncate-lines:t
 327 # End: