diff options
author | Graham Wilson <graham@mknod.org> | 2004-08-30 01:34:48 +0000 |
---|---|---|
committer | Graham Wilson <graham@mknod.org> | 2004-08-30 01:34:48 +0000 |
commit | c3a80da98846c21a5d3f32a91669d78774a0aa6a (patch) | |
tree | 72bee6836c468c8527560821cd65618f2c7b115d /dist-tools/indexgen.sh | |
parent | fd2543489b53fe34a18b7204d6803bf527c0d198 (diff) | |
download | fetchmail-c3a80da98846c21a5d3f32a91669d78774a0aa6a.tar.gz fetchmail-c3a80da98846c21a5d3f32a91669d78774a0aa6a.tar.bz2 fetchmail-c3a80da98846c21a5d3f32a91669d78774a0aa6a.zip |
Move a handful of scripts (used for releases, testing, etc.) to dist-tools, so that they are not released in the tarball.
svn path=/trunk/; revision=3934
Diffstat (limited to 'dist-tools/indexgen.sh')
-rwxr-xr-x | dist-tools/indexgen.sh | 386 |
1 files changed, 386 insertions, 0 deletions
diff --git a/dist-tools/indexgen.sh b/dist-tools/indexgen.sh new file mode 100755 index 00000000..0fac4259 --- /dev/null +++ b/dist-tools/indexgen.sh @@ -0,0 +1,386 @@ +#!/bin/sh +# +# indexgen.sh -- generate current version of fetchmail home page. +# +goldvers="6.2.0" +goldname="6.2.0" +version=`sed -n <Makefile.in "/VERSION *= */s/VERSION *= *\([^ ]*\)/\1/p"` +date=`date "+%d %b %Y"` + +set -- `timeseries | grep -v "[%#]" | head -1` +subscribers=$4 +make fetchmail +set -- `ls -ks fetchmail` +fetchmailsize=$1 +set -- `(cd /lib; ls libc-*)` +glibc=`echo $1 | sed 's/libc-\(.*\)\.so/\1/'` +glibc="glibc-$glibc" + +rm -f index.html + +# Compute MD5 checksums for security audit +rm -f checksums +for file in fetchmail-$version.tar.gz fetchmail-$version-1.*.rpm +do + md5sum $file >>checksums +done + +if [ $version != $goldvers ] +then + for file in fetchmail-$goldvers.tar.gz fetchmail-$goldvers-1.*.rpm + do + md5sum $file | sed -e "s: .*/: :" >>checksums + done +fi + +# Cryptographically sign checksums +gpg --clearsign checksums +mv checksums.asc checksums + +cat >index.html <<EOF +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<link rev="made" href="mailto:esr@snark.thyrsus.com" /> +<link rel="stylesheet" href="/~esr/sitestyle.css" type="text/css"/> +<meta name="description" content="Home page of the fetchmail project" /> +<meta name="keywords" content="" /> +<meta name="MSSmartTagsPreventParsing" content="TRUE" /> +<title>The fetchmail home page</title> +</head> +<body> + +<div id="Header"> +<table width="100%" cellpadding="0" summary="Canned page header"> +<tr> +<td>The fetchmail home page</td> +<td align="right">$date</td> +</tr> +</table> +</div> + +<div id="Menu"> + <hr/> + <a href="/~esr" title="My home page">Home Page</a><br /> + <a href="/~esr/sitemap.html" title="Map of the site">Site Map</a><br /> + <a href="/~esr/software.html" title="Software I maintain">Software</a><br /> + <a href="/~esr/projects.html" title="My projects">Projects</a><br /> + <a href="/~esr/faqs/" title="My FAQ documents">HOWTOs</a><br /> + <a href="/~esr/writings/" title="Essays and ruminations">Essays</a><br /> + <a href="/~esr/personal.html" title="Portrait of the author">Personal</a><br /> + <a href="http://www.ibiblio.org/esrblog/">Weblog</a><br/> + <a href="/~esr/netfreedom/">Freedom!</a><br /> + <a href="/~esr/guns/">Firearms!</a><br /> + <hr/> +</div> + +<div id="Content"> + +<h1>The fetchmail Home Page</h1> +</center> + +<p><b>Note: if you are a stranded fetchmail.com user, we're sorry but +we have nothing to do with that site and cannot help you. It's just an +unfortunate coincidence of names.</b></p> + +<h1>What fetchmail does:</h1> + +<p>Fetchmail is a full-featured, robust, well-documented +remote-mail retrieval and forwarding utility intended to be used over +on-demand TCP/IP links (such as SLIP or PPP connections). It supports +every remote-mail protocol now in use on the Internet: POP2, POP3, +RPOP, APOP, KPOP, all flavors of <a +href="http://www.imap.org">IMAP</a>, ETRN, and ODMR. It can even +support IPv6 and IPSEC.</p> + +<p>Fetchmail retrieves mail from remote mail servers and forwards it via +SMTP, so it can then be read by normal mail user agents such as <a +href="http://www.mutt.org/">mutt</a>, elm(1) or BSD Mail. +It allows all your system MTA's filtering, forwarding, and aliasing +facilities to work just as they would on normal mail.</p> + +<p>Fetchmail offers better security than any other Unix remote-mail +client. It supports APOP, KPOP, OTP, Compuserve RPA, Microsoft NTLM, +and IMAP RFC1731 encrypted authentication methods including CRAM-MD5 +to avoid sending passwords en clair. It can be configured to support +end-to-end encryption via tunneling with <a +href="http://www.openssh.com/">ssh, the Secure Shell</a>.</p> + +<p>Fetchmail can be used as a POP/IMAP-to-SMTP gateway for an entire DNS +domain, collecting mail from a single drop box on an ISP and +SMTP-forwarding it based on header addresses. (We don't really +recommend this, though, as it may lose important envelope-header +information. ETRN or a UUCP connection is better.)</p> + +<p>Fetchmail can be started automatically and silently as a system daemon +at boot time. When running in this mode with a short poll interval, +it is pretty hard for anyone to tell that the incoming mail link is +not a full-time "push" connection.</p> + +<p>Fetchmail is easy to configure. You can edit its dotfile directly, or +use the interactive GUI configurator (fetchmailconf) supplied with the +fetchmail distribution. It is also directly supported in linuxconf +versions 1.16r8 and later.</p> + +<p>Fetchmail is fast and lightweight. It packs all its standard +features (POP3, IMAP, and ETRN support) in ${fetchmailsize}K of core on a +Pentium under Linux.</p> + +<p>Fetchmail is <a href="http://www.opensource.org">open-source</a> +software. The openness of the sources is your strongest possible +assurance of quality and reliability.</p> + +<h1>Where to find out more about fetchmail:</h1> + +<p>See the <a href="fetchmail-features.html">Fetchmail Feature List</a> for more +about what fetchmail does.</p> + +<p>See the on-line <a href="fetchmail-man.html">manual page</a> for +basics.</p> + +<p>See the <a href="fetchmail-FAQ.html">HTML Fetchmail FAQ</a> for +troubleshooting help.</p> + +<p>See the <a href="design-notes.html">Fetchmail Design Notes</a> +for discussion of some of the design choices in fetchmail.</p> + +<p>See the project's <a href="todo.html">To-Do list</a> for indications +of known problems and requested features.</p> + +<h1>How to get fetchmail:</h1> + +<p>You can get any of the following leading-edge resources here:</p> +<ul> +<li> <a href="fetchmail-$version.tar.gz"> + Gzipped source archive of fetchmail $version</a> +<li> <a href="fetchmail-$version-1.i386.rpm"> + Intel binary RPM of fetchmail $version (uses $glibc)</a> +<li> <a href="fetchmail-$version-1.src.rpm"> + Source RPM of fetchmail $version</a> +</ul> + +<p>MD5 <a href="checksums">checksums</a> are available for these files; the +checksum file is cryptographically signed and can be verified with the +command:</p> + +<pre> +gpg --verify checksums +</pre> + +EOF + +if [ $version != $goldvers ] +then + cat >>index.html <<EOF + +<p>Or you can get the last \`gold' version, $goldname:</p> +<ul> +<li> <a href="fetchmail-$goldvers.tar.gz"> + Gzipped source archive of fetchmail $goldname</a> +<li> <a href="fetchmail-$goldvers-1.i386.rpm"> + Intel binary RPM of fetchmail $goldname (uses glibc)</a> +<li> <a href="fetchmail-$goldvers-1.alpha.rpm"> + Alpha binary RPM of fetchmail $goldname (uses glibc)</a> +<li> <a href="fetchmail-$goldvers-1.src.rpm"> + Source RPM of fetchmail $goldname</a> +</ul> + +<p>The <a href="fetchmail-$goldvers.tar.gz.asc">detached GPG +signature</a> for the binary tarball can be used to check it for +correctness, with the command</p> + +<pre> +gpg --verify fetchmail-$goldvers.tar.gz.asc fetchmail-$goldvers.tar.gz +</pre> + +<p>For differences between the leading-edge $version and gold $goldname versions, +see the distribution <a href="NEWS">NEWS</a> file.</p> +EOF +fi + +cat >>index.html <<EOF +<p>(Note that the binary RPMs don't have the POP2, OTP, IPv6, Kerberos, +GSSAPI, Compuserve RPA, Microsoft NTLM, or GNU gettext +internationalization support compiled in. To get any of these you +will have to build from sources.)</p> + +<p>The latest version of fetchmail is also carried in the +<a href="http://metalab.unc.edu/pub/Linux/system/mail/pop/!INDEX.html"> +Metalab remote mail tools directory</a>.</p> + +<h1>Getting help with fetchmail:</h1> + +<p>There is a fetchmail-friends list for people who want to discuss +fixes and improvements in fetchmail and help co-develop it. It's a +MailMan list, which you can sign up for at <a +href="http://lists.ccil.org/mailman/listinfo/fetchmail-friends"> +fetchmail-friends@ccil.org</a>. There is also an announcements-only +list, <a +href="http://lists.ccil.org/mailman/listinfo/fetchmail-announce"> +fetchmail-announce@lists.ccil.org</a>.</p> + +<p>Note: before submitting a question to the list, <strong>please read +the <a href="fetchmail-FAQ.html">FAQ</a></strong> (especially item <a +href="fetchmail-FAQ.html#G3">G3</a> on how to report bugs). We +tend to get the same three newbie questions over and over again. The +FAQ covers them like a blanket.</p> + +<p>Fetchmail was written and is maintained by <a +href="../index.html">Eric S. Raymond</a>. There are some designated +backup maintainers (<a href="mailto:rfunk@funknet.net">Rob Funk</a>, <a +href="http://www.dallas.net/~fox/">David DeSimone aka Fuzzy Fox</a>, +<a href="mailto:imdave@mcs.net">Dave Bodenstab</a> and <a +href="mailto:shetye@bombay.retortsoft.com">Sunil Shetye</a>). Other backup +maintainers may be added in the future, in order to ensure continued +support should Eric S. Raymond drop permanently off the net for any +reason.</p> + +<h1>You can help improve fetchmail:</h1> + +<p>I welcome your code contributions. But even if you don't write code, +you can help fetchmail improve.</p> + +<p>If you administer a site that runs a post-office server, you may be +able help improve fetchmail by lending me a test account on your site. +Note that I do not need a shell account for this purpose, just a +maildrop. Nor am I interested in collecting maildrops per se -- +what I'm collecting is different <em>kinds of servers</em>.</p> + +<p>Before each release, I run a test harness that sends date-stamped +test mail to each site on my regression-test list, then tries to +retrieve it. Please take a look at my <a href="testservers.html"> +list of test servers</a>. If you can lend me an account on a kind +of server that is <em>not</em> already on this list, please do.</p> + +<h1>Who uses fetchmail:</h1> + +<p>Fetchmail entered full production status with the 2.0.0 version in +November 1996 after about five months of evolution from the ancestral +<code>popclient</code> utility. It has since come into extremely wide use +in the Internet/Unix/Linux community. The Red Hat, Debian and +Suse Linux distributions and their derivatives all include it. A +customized version is used at Whole Earth 'Lectronic Link. Several +large ISPs are known to recommend it to Unix-using SLIP and PPP +customers.</p> + +<p>Somewhere around a thousand people have participated on the fetchmail +beta lists (at time of current release there were $subscribers on the +friends and announce lists). While it's hard to count the users of +open-source software, we can estimate based on (a) population figures +at the WELL and other known fetchmail sites, (b) the size of the +Linux-using ISP customer base, and (c) the volume of fetchmail-related +talk on USENET. These estimates suggest that daily fetchmail users +number well into the hundreds of thousands, and possibly over a million.</p> + +<h1>The sociology of fetchmail:</h1> + +<p>The fetchmail development project was a sociological experiment as well +as a technical effort. I ran it as a test of some theories about why the +Linux development model works.</p> + +<p>I wrote a paper, <a +href="http://www.catb.org/~esr/writings/cathedral-bazaar/">The +Cathedral And The Bazaar</a>, about these theories and the project. +I developed the line of analysis it suggested in two later essays. +These papers became quite popular and (to my continuing astonishment) may +have actually helped change the world. Chase the title link, above, +for links to all three papers.</p> + +<p>I have done some analysis on the information in the project NEWS file. +You can view a <a href="history.html">statistical history</a> showing +levels of participation and release frequency over time.</p> + +<h1>Recent releases and where fetchmail is going:</h1> + +<p>Fetchmail is now sufficiently stable and effective that I'm getting +very little pressure to fix things or add features. Development has +slowed way down, release frequency has dropped off, and we're +basically in maintainance mode.</p> + +<p>Major changes or additions therefore seem unlikely until there are +significant changes in or additions to the related protocol RFCs.</p> + +<h1>Where you can use fetchmail:</h1> + +<p>The fetchmail code was developed under Linux, but has also been +extensively tested under 4.4BSD, SunOS, Solaris, AIX, and NEXTSTEP. It +should be readily portable to other Unix variants (it requires only +POSIX plus BSD sockets, and uses GNU autoconf).</p> + +<p>Fetchmail is supported only for Unix by its official maintainers. +However, it is reported to build and run correctly under BeOS, +AmigaOS, Rhapsody, and QNX as well. There is a CygWin port.</p> + +<h1>Related resources:</h1> + +<p>Jochen Hayek is developing a set of +<a href="http://www.ACM.org/~Jochen_Hayek/JHimap_utils/"> +IMAP tools in Python</a> that read your .fetchmailrc file and are +designed to work with fetchmail. Jochen's tools can report selected +header lines, or move incoming messages to named mailboxes based on +the contents of headers.</p> + +<p>Donncha O Caoihm has written a Perl script called +<a href="http://cork.linux.ie/projects/install-sendmail/">install-sendmail</a> +that assists you in installing sendmail and fetchmail together.</p> + +<p>Peter Hawkins has written a script called <a +href="http://linux.cudeso.be/linuxdoc/gotmail.php">gotmail</a> that +can retrieve Hotmail. Another script, <a +href="http://yosucker.sourceforge.net">yosucker</a>, can retrieve +Yahoo webmail.</p> + +<p>There's a program called +<http://mailfilter.sourceforge.net/'>mailfilter</a> which can be used +to do span filtering, that works particularly well called from fetchmail's +<code>preconnect</code> directive,</p> + +<p>A hacker identifying himself simply as \`Steines' has written a +filter which rewrites the to-line with a line which only includes +receipients for a given domain and renames the old to-line. It also +rewrites the domain-part of addresses if the offical domain is +different from the local domain. You can find it <a +href="http://www.steines.com/mailf/">here</a>.</p> + +<h1>Fetchmail's funniest fan letter:</h1> + +<a href="funny.html">This letter</a> still cracks me up whenever I reread it. + +<h1>The fetchmail button:</h1> + +<p>If you use fetchmail and like it, here's a nifty fetchmail button you +can put on your web page:</p> + +<center><img src="fetchmail.png" alt="fetchmail logo" /></center> + +<p>Thanks to <a href="http://www.gl.umbc.edu/~smatus1/">Steve +Matuszek</a> for the graphic design. The hand in the button (and the +larger top-of-page graphic) was actually derived from a color scan of +the fetchmail author's hand.</p> + +<h1>Fetchmail mirror sites:</h1> + +<p>There is a FTP mirror of the current sources and RPMs in Japan at +<a href="ftp://ftp.win.ne.jp/pub/network/mail/fetchmail"> +ftp://ftp.win.ne.jp/pub/network/mail/fetchmail</a>. + +<h1>Reviews and Awards</h1> + +<p>Fetchmail was DaveCentral's Best Of Linux winner for +<a href="http://linux.davecentral.com/bol_19990630.html">June 30 1999</a>.</p> + +<p>Fetchmail was a five-star Editor's Pick at Softlandindia.</p> + +</div> + +</body> +</html> +EOF + +# The following sets edit modes for GNU EMACS +# Local Variables: +# mode:html +# truncate-lines:t +# End: |