4.3.14:
-Fix copy and paste error that caused BrokenUIDLPOP3SSLRetriever to default
to port 110. Thanks: Daniel Burrows via Fredrik Steen.
4.4.0:
-add new POP3-over-SSL initialization class, which is automatically used
when Python 2.4 or newer is in use. This reduces the overhead involved
in retrieving messages from a POP3SSL server (reduces systime about 35%,
user time about 50%, wall time 10-30%). Thanks: Jan Vereecke.
-add getmail_fetch configuration-less commandline POP retriever, perfect
for scripting use. Development of getmail_fetch was sponsored by
Texas Communications.
-future proofing: eliminate relative imports within getmailcore package.
4.4.1:
-work around bug in Python which meant POP3-over-SSL with Python >= 2.4
could "hang" (it's exactly the same bug that affected getmail's initial
IMAP-over-SSL code).
4.4.2:
-fix logging import in corrupt messages with Python 2.3. Thanks: Marco Ferra.
-add BrokenUIDLPOP3SSLRetriever as SSL version of BrokenUIDLPOP3Retriever,
based on an idea by a user of the Debian package. Thanks: Daniel Burrows,
Fredrik Steen.
-remove deprecated "strict" argument from message/header parsing calls.
While it was possible to suppress the warning that resulted when using
Python 2.4, it appears many getmail users couldn't bother to do that
and complained to me instead.
-for multidrop retrievers, change the way the envelope recipient header
field is parsed, to prevent odd values from being interpreted as multiple
addresses when they look like an 822-style address group. Thanks: "aal".
-try to avoid parsing message bodies, in case they're corrupt or invalid.
Thanks: Michael Gold.
-change (again) handling of deleted messages vs. connection that dies.
Inability to send QUIT to POP3 server should be less problematic now.
-improve housekeeping of old message state file. Thanks: Thomas Schwinge.
-add error message for missing mboxrd file. Thanks: Marco Ferra.
-change handling of connection that dies vs. deleted messages.
Thanks: Thomas Schwinge.
* make getmail less conservative about remembering messages as
already-seen when unrelated errors occur after successfully
delivering them. Thanks: Thomas Schwinge.
Version 4.3.4
14 March 2005
-documentation changes; getmail v4 cannot run natively on Windows. Use
Cygwin if you must run on a Windows platform; this works.
-remove some Windows-specific code.
Version 4.3.3
19 February 2005
-previously, for safety, getmail would re-retrieve messages after a session
that encountered errors. However, getmail had enough information to safely
remember those messages that had been successfully delivered. This behaviour
has been changed, to avoid delivering duplicate messages where it isn't
necessary. Thanks: Thomas Schwinge.
-in output/log files, getmailrc files are now specified only by filename,
instead of by complete paths. This will prevent some overly-long output
lines.
-add Windows versions of functions to lock/unlock files, so mbox delivery
can be used on Windows. Thanks: Felix Schwarz.
-previously, if an SSL POP3 or IMAP server abruptly closed the connection
before getmail could finish logging in, getmail would exit instead of
proceeding to the next configured mail account. Fixed. Thanks: Matthias
Andree, Frank Benkstein, Thomas Schwinge.
-eliminate duplicate Return-Path: header fields. Thanks: Angles Puglisi.
python*-pth packages into meta-packages which will install the non-pth
packages. Bump PKGREVISIONs on the non-pth versions to propagate the
thread change, but leave the *-pth versions untouched to not affect
existing installations.
Sync all PYTHON_VERSIONS_AFFECTED lines in package Makefiles.
-some IMAP errors would cause getmail to raise an exception, instead of
gracefully proceeding with the next configured mail account. Fixed.
Thanks: Matthias Andree.
Version 4.2.3
18 November 2004
-documentation updates.
-getmailrc examples file updated. Thanks: Scott Robbins.
-clarify error message when user insecurely tries to deliver mail as GID 0.
Version 4.2.4
22 November 2004
-one type of filter error would cause getmail to skip to the next configured
mail account, rather than simply proceeding to the next message from the
same account. Fixed. Thanks: Adrien Beau.
-documentation updates.
Version 4.1.5
13 September 2004
-getmail would not delete messages from the server if it was configured not
to retrieve them and the delete_after directive was not in use (i.e. user
normally left messages on server but occasionally wanted to force-delete
them). Fixed. Thanks: Frankye Fattarelli.
Version 4.2.0
18 September 2004
-SECURITY: previous versions of getmail contain a security vulnerability.
A local attacker with a shell account could exploit a race condition (or a
similar symlink attack) to cause getmail to create or overwrite files in a
directory of the local user's choosing if the system administrator ran getmail
as root and delivered messages to a maildir or mbox file under the control of
the attacker, resulting in a local root exploit. Fixed in versions 4.2.0
and 3.2.5.
This vulnerability is not exploitable if the administrator does not deliver
mail to the maildirs/mbox files of untrusted local users, or if getmail is
configured to use an external unprivileged MDA. This vulnerability is
not remotely exploitable.
Thanks: David Watson. My gratitude to David for his work on finding and
analyzing this problem.
-Now, on Unix-like systems when run as root, getmail forks a child
process and drops privileges before delivering to maildirs or mbox files.
getmail will absolutely refuse to deliver to such destinations as root;
the uid to switch to must be configured in the getmailrc file.
-revert behaviour regarding delivery to non-existent mbox files. Versions
4.0.0 through 4.1.5 would create the mbox file if it did not exist; in
versions 4.2.0 and up, getmail reverts to the v.3 behaviour of refusing
to do so.
Version 4.2.1
8 October 2004
-set message attributes on corrupt container objects to prevent problems
with destinations that expect multidrop-retrieved messages.
Thanks: Harry Wearne.
-move tests for existence of file from mbox destination initialization
to delivery method, and change error from configuration to delivery error.
Thanks: David Watson.
Version 4.2.2
11 October 2004
-in child delivery processes, change real as well as effective uid/gid.
Thanks: David Watson.
-handle corrupted oldmail file better. Thanks: Matthias Andree.
-change failure of a message filter to produce at least as many mail headers
as it was provided from a non-fatal error to warning. If your filter strips
headers, getmail will now warn you about it, but will not consider it an
error.
-documentation additions.
-enhance warning diagnostics about non-accessible or non-writable maildirs.
-change method of determining name of local host; only fall back to
getfqdn() if the result of gethostname() does not contain a dot.
-documentation enhancements.
-biggest change is multiple verbosity levels. To support this from rc file,
the verbose parameter had to change from a boolean to an integer. Update
your getmail rc files: for quiet, set verbose to 0. For more output,
set it to 1 or 2. 2 includes info about messages not retrieved, etc.
-add rc filename to error messages
-change fix from 4.0.11 for email module raising exception during .flatten().
Thanks: Jürgen Nagel.
-some types of SSL error could cause getmail to exit instead of
continuing to the next mail account; fixed. Thanks: Matthias Andree.
-change oldmail file writing to save a few bytes of disk space
-documentation additions.
-Python's standard library email.Message().flatten() could barf on certain
types of badly mis-formatted messages (instead of the during instantiation,
like the /other/ buggy cases). Hope this is fixed in Python 2.4. Developed
a work-around for getmail. Thanks: Juergen Nagel.
-changes to "normal" output of getmail to make it slightly less verbose.
-cosmetic fix to output: add whitespace after timestamp when not retrieving
message. Thanks: Matthias Andree.
-include MANIFEST.in in source distribution, to assist users in building
"built distributions" from it.
-change a few output messages' level to make verbose mode slightly less
verbose, and add --debug switch to get "more verbose" behaviour.
-fix cosmetic error for IMAP mailboxes with 0 messages in them.
-change method of obtaining uidvalidity from IMAP server and remove wrapper.
-previously, connecting to an IMAP-SSL server could fail if a non-SSL
IMAP connection were attempted immediately before. This was due to
the Python bug discussed here:
http://sourceforge.net/tracker/index.php?func=detail&aid=945642&group_id=5470&atid=305470
Implemented a workaround for getmail. Thanks: Payal Rathod.
4.0.7:
-change failure of a message filter to produce at least as many mail headers
as it was provided from a fatal to a non-fatal error. The message will
be skipped. Thanks: Payal Rathod.
-a few non-conformant IMAP4 servers don't implement SEARCH, so getmail
couldn't get a list of UIDs. Changed to use FETCH instead.
Thanks: Matthias Andree.
-prevent traceback if IMAP SSL connection closed during connect().
Thanks: Payal Rathod.
-add warning if unknown parameters are supplied to a retriever, filter,
or destination.
-write subclasses of Python imaplib classes to work around missing
UIDVALIDITY select() response. Add it to the state getmail keeps.
Thanks: Matthias Andree.
-move message state saving to later, so getmail doesn't falsely remember
having handled a message. Thanks: Matthias Andree.
-change location of documentation/man pages to
<prefix>/share/{doc/getmail,man}/ to be more comformant with the FHS.
-documentation updates
4.0.8:
-add an extra error message if you ask getmail to deliver to a maildir,
but getmail can't check the contents of it due to permissions.
Thanks: Clemens Buschmann.
-fix breakage introduced in 4.0.7: getmail would forget a message was "seen"
after a cycle of not retrieving it. Thanks: Payal Rathod.
-if the connection failed in a certain way, getmail could forget which
messages it had already retrieved, and therefore retrieve them again when
the next successful connection occurred. Fixed. Thanks: Wim Uyttebroek.
--add win32 executable installer as third download option.
-add additional error handler for certain network errors with POP3-over-SSL
connections. Thanks: Frank Benkstein.
-rename retriever class for Demon UK: it should have been SDPS; my
transposition. Thanks: Paul Howarth.
-some types of socket errors would raise an exception instead of letting
getmail gracefully continue; fixed. Thanks: David.
-documentatation updates; fix two typos and add to the section on using
ClamAV with getmail.
-changes to my release process; the current version's URL will not change
when a new version is released. See, I try to help others, even when they
don't do the same...
differences from previous versions:
getmail version 4 has been completely rewritten. It is designed to
closely mimic the interface and user experience of getmail version
3, but the new architecture necessitates some differences you will
notice:
* the getmail rc file (configuration file) format has changed. If
you are upgrading from version 3, you will need to write a new
configuration file based on the contents of your old one. The
new file format resembles the old in many ways. Each account you
retrieve mail from will require a separate rc file, but getmail
can operate with multiple rc files simultaneously if you wish to
retrieve mail from multiple accounts.
* support for protocols other than POP3/SPDS. IMAP support is now
included, and other protocols can be added with relative ease.
* support for SSL-encrypted protocols. The included POP3 and IMAP
retriever classes are complemented by SSL-enabled counterparts.
* messages can be filtered or annotated by external programs like
spam filters and anti-Microsoft-worm programs. Filters can cause
messages to be dropped completely.
* a flexible, extensible architecture. Additional classes for
handling new mail protocols, filter types, or destination mailstores
can be added without needing to modify the main script at all.
Feel free to contact me if you need a custom retriever, filter,
or destination class written, or if you want commercial support
for getmail.
From the changelog:
* Add an error handler for the case where a POP3 server returns a message
that isn't even close to valid 822 format, particularly one where the
first line in the message header is a continuation line (starts with
whitespace).
Changes since 3.1.7:
* Add command_add_fromline directive to control prepending mbox-style From_
lines to command deliveries. Defaults to 1, the previous behaviour. Set
to 0 to disable.
* Add workaround for differences in Python poplib; an incompatible change
was introduced (apparently in 1.6) to Python's library, where session.retr()
previous returned raw lines, but now it returns the un-stuffed lines.
getmail now has to conditionally un-stuff lines depending on the version
of the Python interpreter in use.
* Change the "over max message size of %(max_message_size)i, skipping ..."
message from informational to warning so it can be seen when using
-q/--quiet/verbose=0. Thanks to Volker Kuhlmann for the report.
-Change error message resulting from failed APOP attempt
-getmail_mbox.py was missing an import for the string module.
Thanks to Emily Jackson for the report. This was introduced in
3.1.6.
-Argh; my change to getmail_mbox was incomplete -- not only would
getmail not put duplicate From_ lines in, it would escape the
single one that it did. This fixes it, so don't bother filing
a bug report about this one.
-Fredrik Steen reported that getmail was adding a duplicate From_
line when using getmail_mbox to deliver to mbox files. Fixed.
-Added -q and --quiet flags to getmail_mbox to suppress warning
message.
-removed the experimental message_filter code; it was unworkable.
If you want to filter messages, use a filtering MDA. getmail
works fine with maildrop, procmail, and other MDAs. Thanks to
Dan Hensley for experimenting with the message_filter functionality.
-message logging inconsistently used local time; changed to GMT
for consistency. Thanks to Markus Vetter for the report.
-address_no_brackets couldn't handle empty strings. Fixed; thanks
to Fredrik Steen for the report.
Changes:
Version 3.1.1
14 March 2003
-Add additional info to message log (msg #, msg count, size) "new msg"
status line. Thanks to Payal Rathod for the feature request.
Version 3.1.0
21 February 2003
-Rename the recipient_header directive to "envelope_recipient". There was
simply too much confusion about it. Sorry, but you'll have to update
your getmailrc file and rename this directive if you're using it. This
version was going to be 3.0.5, but this change necessitates bumping the
version up to 3.1.0.
-Include separate callable program for mbox delivery. The program,
getmail_mbox, is based on the mbox delivery code in getmail version
2.3. It assumes mboxrd format and flock locking; if other programs
on your system expect a different subtype of mbox format or use a different
locking method, you can corrupt your mbox file. Use at your own risk.
You can use this in a command delivery target from getmail
as "|/path/to/getmail_mbox /path/to/mboxfile" .
-In a similar vein, include separate callable program for maildir delivery.
The program, getmail_maildir, uses the same maildir delivery code as
getmail. You can use this in a command delivery target from getmail
as "|/path/to/getmail_maildir /path/to/maildir/" . This is mostly useful
if you want to deliver to a maildir after doing something else to the message,
and can be used in place of safecat.
-Add message filtering. You can now pass messages through arbitrary
filters before delivery; specify one or more message_filter directives,
each of which is a command and arguments. The filter(s) should read the
message from stdin, write to stdout, and exit 0 for success, 99 to drop
the message in the bitbucket, and anything else to indicate an error.
No docs for this yet.
-getmail could drop the final newline when delivering to Maildirs in
some circumstances. Thanks to Jason Mastaler for the report and testing.
Version 3.0.4
20 February 2003
-Catch a user incorrectly specifying two values for recipient_header.
Thanks to Francisco Stefano Wechsler for the report.
-Update ConfParser to version 3.3, designed to make it easier to catch
user configuration errors.
-Update configuration-handling code to use new features of ConfParser 3.3
above, report configuration errors more clearly. Thanks to Francisco
Stefano Wechsler for the report which got me looking at this.
-Add explicit check for recipient_header specifying a known-incorrect
value. Thanks to Edward Davis for the report that got me looking at this.
-Move some sanity checks around to report errors earlier.
Version 3.0.3
14 February 2003
-Missing import in getmail_utilities.py affected those who let getmail
prompt them for a password. Thanks to Francisco Stefano Wechsler for the
report.
Version 3.0.2
14 February 2003
-My editor let CR LF line endings into getmail_utilities.py ; this caused
problems for at least one person. Thanks to Francisco Stefano Wechsler
for the report. Now fixed.
Version 3.0.1
13 February 2003
-Have getmail report an error if local directives are specified but getmail
is not operating in multidrop mode (through either of the "use_*env" or
"recipient_header" directives). Thanks to Gerwin Krist for reporting that
this was not obvious.
Version 3.0.0
10 February 2003
-Updated to version 1.23 of Timothy O'Malley's timeoutsocket.py
from http://www.timo-tasi.org/python/timeoutsocket.py
-not all configuration errors were being caught in ConfParser. Updated
ConfParser as a result; thanks to Christian Pelster for reporting and testing
this.
-Move lots of code around. Much has been moved into separate files.
Much other code has been cleaned up.
-Add support for Demon's SPDS "*ENV" command for domain mailboxes.
Thanks to Paul Clifford for the request and the pointer to Demon's
explanation of this protocol extension, submission of a patch to
getmail 2.3.x for this feature, and for a testing 3.0 in its pre-release
state. Paul also submitted several patches during pre-release testing
which I accepted.
-Change main delivery loop; individual message delivery failures are
not considered fatal errors any more. The messages will be left on the
server and retried.
-Remove mbox delivery code. Use an external MDA for this; for safety
and reliability, all mbox-delivery programs on a system have to be compiled
to use the same method of mbox locking in any case. I don't use mbox
files at all.
-Simplify handling of oldmail data files.
-Domain mailboxes are now only supported with explicit configuration of
a header field which records the envelope recipient address or with *ENV.
This removes a lot of code and makes the logic simpler.
-Remove duplicate filtering option. Use an external MDA for this.
-Change maildir delivery algorithm; getmail will now try up to three times
to generate a valid, unique name in maildir/tmp/, sleeping two seconds
between tries as recommended by djb. This code is also now moved into
an independant function in getmail_utilities.py for easier use by others.
The file naming convention has changed to djb's "modern delivery
identifiers".
extension Makefile fragments, because they really don't have anything to
do with the buildlink[12] frameworks. Change all the Makefiles that use
application.buildlink.mk and extension.buildlink.mk to use application.mk
and extension.mk instead.
