* keyfile and certfile parameters to SSL retrievers are now expanded
for leading "~/" and "~username/" as well as environment
variables, just like other path parameters. Thanks: Fredrik Steen.
- add delete_dup_msgids option to non-multidrop POP3 retrievers.
Thanks: Matthias Andree.
- suppress stack trace in getmail_fetch error message when
configuration error detected. Thanks: Dave Jarvis.
- documentation updates.
- build and development environment changes. The plaintext versions
of the documentation are now generated with links instead of lynx.
- explicitly log the reason for not retrieving a message (seen or
oversized). Thanks: Payal Rathod.
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
