| 1 |
IMAPFilter 2.8.3 - Apr 27, 2025 |
| 2 |
- Include body transfer encoding in fetch_structure() return value. |
| 3 |
- Bug fix; minor incompatibility with Lua 5.3 and 5.4 |
| 4 |
|
| 5 |
IMAPFilter 2.8.2 - Dec 26, 2023 |
| 6 |
- Add IMAP support for UTF-8 (RFC 6855) when "charset" is set to "UTF-8" |
| 7 |
- Don't use FETCH FAST macro use for better compatibility |
| 8 |
- Bug fix; recovery mechanism error on Lua 5.1 |
| 9 |
|
| 10 |
IMAPFilter 2.8.1 - Jan 8, 2023 |
| 11 |
- Add support for non-write actions on read-only mailboxes. |
| 12 |
- Add new parameter to write process ID (PID) to file. |
| 13 |
|
| 14 |
IMAPFilter 2.8.0 - Jan 6, 2023 |
| 15 |
- New, more advanced, robust, and flexible recovery mechanism, replaces the |
| 16 |
old automatic recovery functionality. Note that, the config must be updated |
| 17 |
to use the new mechanism, otherwise no recovery will take place on errors. |
| 18 |
- Bug fix; potential failure when deleting mailbox while mailbox is selected. |
| 19 |
|
| 20 |
IMAPFilter 2.7.6 - Aug 6, 2022 |
| 21 |
- Support building with OpenSSL 3.0.0 and later. |
| 22 |
- Several minor improvements to documentation and example code. |
| 23 |
- Removed deprecated CRAM-MD5 mechanism. |
| 24 |
- Bug fix; session was destroyed incorrectly on login failures. |
| 25 |
- Bug fix; potential session management problems. |
| 26 |
|
| 27 |
IMAPFilter 2.7.5 - Dec 5, 2020 |
| 28 |
- New "hostnames" option can be used to disable hostname validation. |
| 29 |
- Bug fix; "certificates" option incorrectly controlled hostname validation. |
| 30 |
|
| 31 |
IMAPFilter 2.7.4 - Nov 18, 2020 |
| 32 |
- Bug fix; incorrect argument to regular expression compile function. |
| 33 |
|
| 34 |
IMAPFilter 2.7.3 - Nov 14, 2020 |
| 35 |
- Bug fix; incorrect free of compiled pattern. |
| 36 |
- Unexpected network errors and IMAP BYE are now logged. |
| 37 |
|
| 38 |
IMAPFilter 2.7.2 - Nov 10, 2020 |
| 39 |
- Makefile is back to being Lua version agnostic. |
| 40 |
|
| 41 |
IMAPFilter 2.7.1 - Nov 9, 2020 |
| 42 |
- Makefile now builds with Lua 5.4 and PCRE2. |
| 43 |
|
| 44 |
IMAPFilter 2.7 - Nov 8, 2020 |
| 45 |
- Lua 5.4 compatibility (the codebase can still be compiled with versions |
| 46 |
5.3, 5.2 and 5.1). |
| 47 |
- PCRE2 compatibility (version 10.00 and later) |
| 48 |
- New error code is returned if certificate verify fails. |
| 49 |
- Bug fix; add missing truststore option from brief usage message. |
| 50 |
|
| 51 |
IMAPFilter 2.6.16 - Nov 23, 2019 |
| 52 |
- Bug fix; escape the double-quote character in passwords. |
| 53 |
|
| 54 |
IMAPFilter 2.6.15 - Nov 14, 2019 |
| 55 |
- Bug fix; try to setup both a CA file and path for SSL validations. |
| 56 |
|
| 57 |
IMAPFilter 2.6.14 - Nov 1, 2019 |
| 58 |
- Bug fix; OpenSSL version mess up for SSL hostname validation. |
| 59 |
|
| 60 |
IMAPFilter 2.6.13 - Sep 17, 2019 |
| 61 |
- Support for SSL hostname validation. |
| 62 |
|
| 63 |
IMAPFilter 2.6.12 - Oct 3, 2018 |
| 64 |
- Support for Server Name Indication (SNI). |
| 65 |
- The searching methods return values are described in the config man page. |
| 66 |
- Example of using the enter_idle() function in the sample extend file. |
| 67 |
|
| 68 |
IMAPFilter 2.6.11 - Nov 19, 2017 |
| 69 |
- Support for interrupting IDLE mode with SIGUSR1/SIGUSR2. |
| 70 |
- New "persist" option to try to recover a connection indefinitely. |
| 71 |
- New "range" option to limit messages included in a range. |
| 72 |
- Bug fix; always close selected mailbox before check_status(). |
| 73 |
- Bug fix; closing of selected mailbox twice with fetch_message(). |
| 74 |
|
| 75 |
IMAPFilter 2.6.10 - Dec 16, 2016 |
| 76 |
- Bug fix; segmentation fault on some OpenSSL builds. |
| 77 |
|
| 78 |
IMAPFilter 2.6.9 - Dec 6, 2016 |
| 79 |
- Bug fix; possible problem during STARTTLS negotiation. |
| 80 |
|
| 81 |
IMAPFilter 2.6.8 - Nov 26, 2016 |
| 82 |
- Support building with OpenSSL 1.1.0. |
| 83 |
|
| 84 |
IMAPFilter 2.6.7 - Jun 7, 2016 |
| 85 |
- A dry-run mode that disables all actions that modify data. |
| 86 |
- Bug fix; handle IDLE untagged responses that are received in pieces. |
| 87 |
|
| 88 |
IMAPFilter 2.6.6 - Jan 23, 2016 |
| 89 |
- Bug fix; print an error message if "ssl" has been set to "ssl3". |
| 90 |
|
| 91 |
IMAPFilter 2.6.5 - Jan 18, 2016 |
| 92 |
- Possible to build again with OpenSSL when support for SSL 3.0 is disabled. |
| 93 |
|
| 94 |
IMAPFilter 2.6.4 - Dec 8, 2015 |
| 95 |
- Support for OAuth 2.0 and the XOAUTH2 authentication mechanism. |
| 96 |
|
| 97 |
IMAPFilter 2.6.3 - Sep 30, 2015 |
| 98 |
- Support for loading a default CA certificates file. |
| 99 |
- A new has_unkeyword() method to search messages without a keyword flag set. |
| 100 |
- Bug fix; double quotation around keyword sent by the has_flag() method. |
| 101 |
|
| 102 |
IMAPFilter 2.6.2 - Jun 30, 2015 |
| 103 |
- Bug fix; drop connection on local certificate mismatch. |
| 104 |
|
| 105 |
IMAPFilter 2.6.1 - Jun 29, 2015 |
| 106 |
- Support for loading the system's CA certificates from a file. |
| 107 |
- Bug fix; flusing of standard output/error in a some cases. |
| 108 |
|
| 109 |
IMAPFilter 2.6 - Jun 16, 2015 |
| 110 |
- Optimizations that vastly improve performance of the meta-searching |
| 111 |
functionality, by making subsequent search requests limit their scope based |
| 112 |
on the results already returned by previous requests (previously this was |
| 113 |
the case only for the match_*() methods). |
| 114 |
- Lua 5.3 compatibility (the codebase can still be compiled with versions 5.2 |
| 115 |
and 5.1). |
| 116 |
- A new "limit" option can be used as a work-around for problems that some |
| 117 |
servers have with long requests. |
| 118 |
- The documentation now clarifies how to make the client block indefinitely. |
| 119 |
- Bug fix; the check_status() method now returns 4 numbers on error as |
| 120 |
described in the documentation (just negative values in this case). |
| 121 |
- Bug fix; flushing of default output on password prompt. |
| 122 |
- Bug fix; program fault when very long requests were to be sent. |
| 123 |
|
| 124 |
IMAPFilter 2.5.7 - Nov 16, 2014 |
| 125 |
- Support for automatic validation of SSL connections, using the operating |
| 126 |
system's installed trusted CA certificates (usually from authorities that |
| 127 |
are shipped with web browsers). |
| 128 |
- A new "wakeonany" option makes it possible to end IDLE mode on any event, |
| 129 |
not just on new messages. |
| 130 |
- A new "reenter" option controls whether IDLE mode should be re-entered, |
| 131 |
after the recovery of the session, which makes it possible to continue with |
| 132 |
the execution of the next line in the configuration file. |
| 133 |
- The documentation now mentions that the contain_*() methods do |
| 134 |
case-insensitive searching (an IMAP limitation). |
| 135 |
- The documentation now has a better explanation of the arrived_*() and |
| 136 |
sent_*() methods. |
| 137 |
- Bug fix; the value returned by the copy method was incorrect in some cases. |
| 138 |
|
| 139 |
IMAPFilter 2.5.6 - Oct 27, 2013 |
| 140 |
- Possible to build again with OpenSSL older than version 1.0.1 (was a |
| 141 |
requirement for the previous release due to new protocols TLS 1.1/1.2). |
| 142 |
- Support for reading the configuration from the standard input stream. |
| 143 |
- New makefile dist target, which can be used to create distribution archives. |
| 144 |
|
| 145 |
IMAPFilter 2.5.5 - Jun 8, 2013 |
| 146 |
- Work-around for some servers that send an unexpected APPEND response. |
| 147 |
- The serial number of the certificates is taken into account, because some |
| 148 |
servers send different certificates with the same subject and issuer. |
| 149 |
- Details of the stored certificates are written to the certificates file, in |
| 150 |
order to make it easier to distinguish each of them. |
| 151 |
- Support for TLS versions 1.1 and 1.2 for secure connections. |
| 152 |
|
| 153 |
IMAPFilter 2.5.4 - Apr 9, 2013 |
| 154 |
- Some server responses are now parsed less stricly. |
| 155 |
- More detailed information is now printed when there's an error. |
| 156 |
- Bug fix; various corrections in the recovery mechanism. |
| 157 |
|
| 158 |
IMAPFilter 2.5.3 - Jul 22, 2012 |
| 159 |
- New implementation for international mailbox names. |
| 160 |
- Bug fix; wrong variable name in one of the examples on extending. |
| 161 |
- Bug fix; an OpenSSL compilation warning. |
| 162 |
|
| 163 |
IMAPFilter 2.5.2 - Feb 29, 2012 |
| 164 |
- Persistent errors or connection failures are now ignored when running in |
| 165 |
daemon mode, and a reconnection is attempted during the next loop iteration. |
| 166 |
- Bug fix; problems with failure handling during login/logout. |
| 167 |
|
| 168 |
IMAPFilter 2.5.1 - Feb 27, 2012 |
| 169 |
- Support for recovery of a session after a BYE response is received. |
| 170 |
- Option to control in which cases a terminated session will be restored. |
| 171 |
- Bug fix; a BYE response could sometimes get incorrectly ignored. |
| 172 |
|
| 173 |
IMAPFilter 2.5 - Feb 23, 2012 |
| 174 |
- Support for recovery of a session when a network failure is encountered, |
| 175 |
and other robustness improvements. |
| 176 |
- Informational messages are printed also for the fetch and append methods. |
| 177 |
- Lua 5.2 compatibility, while the codebase can still be compiled with |
| 178 |
version 5.1. |
| 179 |
- The OpenSSL library is now a mandatory build requirement. |
| 180 |
- Bug fix; unrecoverable login failures did not result in aborting of the |
| 181 |
execution of the configuration. |
| 182 |
- Bug fix; when messages were appended to a mailbox that did not exist, it |
| 183 |
failed to create the mailbox and then retry the appending. |
| 184 |
- Bug fix; misleading errors were printed on some SSL failures. |
| 185 |
- Bug fix; protected call of the commands to execute in the daemon function |
| 186 |
could hide important failures. |
| 187 |
- Bug fix; the man page had an incorrect description of the -d option. |
| 188 |
* Support for the old deprecated 1.x configuration format has been removed, |
| 189 |
and the current 2.x format can only be executed from now on. |
| 190 |
|
| 191 |
IMAPFilter 2.4.2 - Jan 19, 2012 |
| 192 |
- Bug fix; some ASCII characters in mailbox names were incorrectly converted |
| 193 |
to UTF-7. |
| 194 |
|
| 195 |
IMAPFilter 2.4.1 - Dec 8, 2011 |
| 196 |
- Bug fix; become_daemon() failure. |
| 197 |
|
| 198 |
IMAPFilter 2.4 - Dec 6, 2011 |
| 199 |
- Support for non-ASCII mailbox names. |
| 200 |
- New environment variable to set the configuration directory. |
| 201 |
- Bug fix; parsing of some server responses was broken since the previous |
| 202 |
release. |
| 203 |
- Bug fix; the match_field() method matched on the whole header field, |
| 204 |
instead of only the header field body. |
| 205 |
- Bug fix; debug file check caused printing of a misleading error message. |
| 206 |
- Bug fix; typo error in a configuration man page example. |
| 207 |
|
| 208 |
IMAPFilter 2.3 - Aug 6, 2011 |
| 209 |
- Support for appending/uploading messages to mailboxes. |
| 210 |
- Debug file option now takes filename argument. |
| 211 |
- New simplified configuration and building procedure. |
| 212 |
- Bug fix; in some cases a mailbox was incorrectly assumed selected. |
| 213 |
- Bug fix; in some cases server capabilities needed update after login. |
| 214 |
- Bug fix; timeout problem with CRAM-MD5 authentication. |
| 215 |
- Bug fix; some servers send non-ASCII characters in their responses. |
| 216 |
|
| 217 |
IMAPFilter 2.2.3 - Mar 6, 2011 |
| 218 |
- Project moved to GitHub. |
| 219 |
- Changed file and directory structure. |
| 220 |
- The next UID is returned as an additional return value of check_status(). |
| 221 |
- All processing methods now return a boolean based on their success. |
| 222 |
- Bug fix; a lost connection is now handled better by trying to reconnect. |
| 223 |
- Bug fix; in some cases in IDLE a message had arrived but was ignored. |
| 224 |
- Bug fix; in some servers the initial IDLE reply wasn't handled correctly. |
| 225 |
- Bug fix; typo errors in the documentation. |
| 226 |
|
| 227 |
IMAPFilter 2.2.2 - Jan 23, 2010 |
| 228 |
- Bug fix; a couple of errors in the extending examples file. |
| 229 |
|
| 230 |
IMAPFilter 2.2.1 - Jan 20, 2010 |
| 231 |
- A global option for the IDLE refreshing interval was added. |
| 232 |
- Bug fix; more detailed reporting when SSL socket errors occur. |
| 233 |
|
| 234 |
IMAPFilter 2.2 - Dec 30, 2009 |
| 235 |
- Support for combining searching methods in multiple mailboxes at the same |
| 236 |
or different accounts and processing of the results in bulk. |
| 237 |
- Support for meta-searching that allows searching on the previous searching |
| 238 |
results. |
| 239 |
- The processing and fetching methods were enhanced to reflect the new |
| 240 |
changes and the documentation was updated. |
| 241 |
- Global options for the message cache and the certificates were added. |
| 242 |
- Bug fix; questions for certificates are not asked while in daemon mode, but |
| 243 |
instead an error is printed. |
| 244 |
* A different format is used for the returned structures of the searching |
| 245 |
methods, due to the introduction of multiple mailbox searching and |
| 246 |
meta-searching, and thus any configuration files that rely on them should |
| 247 |
be updated. Consequently, the processing and fetching methods have been |
| 248 |
also enhanced and the relevant documentation updated, and while these |
| 249 |
changes are backwards compatible, an update of the configuration file is |
| 250 |
still recommended. |
| 251 |
|
| 252 |
IMAPFilter 2.1.2 - Dec 3, 2009 |
| 253 |
- Bug fix; cache for message parts didn't work correctly. |
| 254 |
- Bug fix; documentation error. |
| 255 |
|
| 256 |
IMAPFilter 2.1.1 - Nov 24, 2009 |
| 257 |
- Bug fix; global option timeout and enter_idle() didn't play well together. |
| 258 |
|
| 259 |
IMAPFilter 2.1 - Nov 23, 2009 |
| 260 |
- Support for the IMAP IDLE extension (RFC 2177) through the enter_idle() |
| 261 |
method. |
| 262 |
- Support for fetching of a message's body structure through the |
| 263 |
fetch_structure() method, and of a message's specific body part through the |
| 264 |
fetch_parts() method. |
| 265 |
- Addition of a global option that controls the character set used for all |
| 266 |
the searching methods. |
| 267 |
- Bug fix; fetching of non-existent messages. |
| 268 |
- Bug fix; no trailing end-of-line characters in the results of |
| 269 |
fetch_fields(). |
| 270 |
|
| 271 |
IMAPFilter 2.0.11 - Sep 20, 2009 |
| 272 |
- Bug fix; fetching of messages with empty body. |
| 273 |
- Workaround for problematic IMAP server sending non-compliant mailbox status |
| 274 |
information. |
| 275 |
|
| 276 |
IMAPFilter 2.0.10 - Feb 16, 2008 |
| 277 |
- Bug fix; failed a great number (tens of thousands) of commands were |
| 278 |
exchanged with an IMAP server. |
| 279 |
- Bug fix; failed to fetch the body of some messages in some extremely rare |
| 280 |
occasions. |
| 281 |
- Bug fix; the description for the contain_header() method was clarified. |
| 282 |
|
| 283 |
IMAPFilter 2.0.9 - Dec 26, 2007 |
| 284 |
- Bug fix; the match_*() methods failed to match messages. |
| 285 |
- Bug fix; the match_*() methods failed with an error when no messages |
| 286 |
matched. |
| 287 |
- Bug fix; note added in the documentation about the need to use double |
| 288 |
backslashes inside of regular expression patterns. |
| 289 |
|
| 290 |
IMAPFilter 2.0.8 - Dec 23, 2007 |
| 291 |
- Bug fix; on some platforms it is necessary to link against the math library. |
| 292 |
|
| 293 |
IMAPFilter 2.0.7 - Dec 22, 2007 |
| 294 |
- Bug fix; the match_*() methods failed with an error message. |
| 295 |
|
| 296 |
IMAPFilter 2.0.6 - Oct 7, 2007 |
| 297 |
- Bug fix; the search query that was sent with the select_all() method had an |
| 298 |
incorrect format and this caused an error in some mail servers. |
| 299 |
|
| 300 |
IMAPFilter 2.0.5 - Oct 4, 2007 |
| 301 |
- Bug fix; an error in the sample extensions file. |
| 302 |
- Bug fix; typo errors in the manual page. |
| 303 |
- The documentation was updated with details and examples on how to access |
| 304 |
mailboxes inside folders. |
| 305 |
- Examples were added on how to define composite filters that include |
| 306 |
multiple searching rules. |
| 307 |
|
| 308 |
IMAPFilter 2.0.4 - Sep 27, 2007 |
| 309 |
- Bug fix; the send_query() method didn't return the special form of table |
| 310 |
that the rest of the searching methods did. |
| 311 |
- An additional searching method has been added to search for keyword flags |
| 312 |
set. |
| 313 |
- A new variable that was added to the Makefile makes it possible to set an |
| 314 |
alternative environment for the installation path. |
| 315 |
|
| 316 |
IMAPFilter 2.0.3 - Jul 27, 2007 |
| 317 |
- Bug fix; part of the program's functionality didn't seem to work at all. |
| 318 |
(did nothing), due to problem when providing the results from searching |
| 319 |
methods to processing methods. |
| 320 |
|
| 321 |
IMAPFilter 2.0.2 - Jun 30, 2007 |
| 322 |
- Bug fix; message cache problem due to non-use of message UIDs. |
| 323 |
|
| 324 |
IMAPFilter 2.0.1 - Jun 29, 2007 |
| 325 |
- Bug fix; character set problem with 1.x configuration files. |
| 326 |
- Bug fix; typo errors in the documentation. |
| 327 |
|
| 328 |
IMAPFilter 2.0 - Jun 27, 2007 |
| 329 |
- New, more powerful, feature rich and yet simpler configuration file. |
| 330 |
- Easier object oriented view of accounts and mailboxes. |
| 331 |
- Simpler approach to filters, with infix logical or/and/not operators. |
| 332 |
- No more need to mess with server search queries. |
| 333 |
- More and simpler functions instead of few and complicated ones. |
| 334 |
- More feature complete interface that can now even manipulate mailboxes. |
| 335 |
- Regular expressions integrated into the searching interface. |
| 336 |
- Effective caching subsystem when fetching message parts. |
| 337 |
- Can still read old version 1.x configuration files for compatibility. |
| 338 |
- Lua 5.1 and the PCRE library are now requirements. |
| 339 |
* The configuration file format has changed. The new format is not backwards |
| 340 |
compatible, and thus it should not be mixed with the old format. |
| 341 |
Nevertheless, configuration files that employ the old, and now deprecated, |
| 342 |
format can still be read and executed as before. |
| 343 |
|
| 344 |
IMAPFilter 1.3 - Feb 13, 2007 |
| 345 |
- Perl Compatible Regular Expression (PCRE) support. |
| 346 |
- Compile against Lua 5.1 by default. |
| 347 |
- Bug fix; program fault in some cases and when namespace prefix was empty. |
| 348 |
- Bug fix; program fault on some platforms when running in verbose mode. |
| 349 |
|
| 350 |
IMAPFilter 1.2.2 - Aug 1, 2006 |
| 351 |
- Bug fix; a mix up of connections could happen in certain circumstances, |
| 352 |
when a hostname and/or username was a prefix of another hostname and/or |
| 353 |
username respectively, or when the same hostname and username was used to |
| 354 |
connect to a different port. |
| 355 |
- Bug fix; the list()/lsub() functions parsed mailboxes/folders whose names |
| 356 |
contained spaces incorrectly. |
| 357 |
- The list() function now does not return the folder itself, when listing |
| 358 |
mailboxes inside a specific folder. |
| 359 |
- It is now possible to define new user keywords for messages inside a |
| 360 |
mailbox, apart from the standard system flags. |
| 361 |
|
| 362 |
IMAPFilter 1.2.1 - Mar 9, 2006 |
| 363 |
- Buf fix; program fault when using the fetch*() family of functions. |
| 364 |
|
| 365 |
IMAPFilter 1.2 - Mar 2, 2006 |
| 366 |
- IPv6 support. |
| 367 |
- Lua 5.1 compatibility. |
| 368 |
- Bug fix; handle messages containing binary data. |
| 369 |
- Bug fix; problems with CPU utilisation when the inactivity timeout timer |
| 370 |
was set. |
| 371 |
|
| 372 |
IMAPFilter 1.1.1 - Nov 11, 2005 |
| 373 |
- Bug fix; minor memory leak. |
| 374 |
- Bug fix; on some systems, failure resulted while disconnecting from all the |
| 375 |
servers, during the shutdown phase just before exiting. |
| 376 |
|
| 377 |
IMAPFilter 1.1 - Aug 24, 2005 |
| 378 |
- Addition of the list() and lsub() commands, that make it possible to get a |
| 379 |
list of the available mailboxes or only of those that are subscribed. |
| 380 |
Implementation of the IMAP LIST/LSUB commands, with additional support for |
| 381 |
the IMAP CHILDREN (RFC 3348) and IMAP NAMESPACE (RFC 2342) extensions. |
| 382 |
- New program option to execute a string from the command line, without |
| 383 |
loading a configuration file. |
| 384 |
- New program option to enter interactive mode after executing the |
| 385 |
configuration file or the command line. |
| 386 |
- Servers that reply with multiple SEARCH responses are taken into |
| 387 |
consideration. |
| 388 |
- Bug fix; failure to parse the response to fetchfast() that some mail |
| 389 |
servers sent. |
| 390 |
- Bug fix; in some systems and when in debug mode, an empty namespace caused |
| 391 |
program fault. |
| 392 |
|
| 393 |
IMAPFilter 1.0.1 - Aug 22, 2004 |
| 394 |
- Bug fix; in some cases processing of messages with an empty body caused |
| 395 |
failure. |
| 396 |
- Bug fix; an invalid namespace prefix was inserted in mailbox names of some |
| 397 |
mail servers. |
| 398 |
- Unique message identifiers are now used by default, instead of message |
| 399 |
sequence numbers, when accessing messages in a mailbox. |
| 400 |
- Sequence set ranges are generated and sent to the mail server instead of |
| 401 |
enumerations, when this is possible. |
| 402 |
- The client now limits the length of the command lines it generates to |
| 403 |
approximately 1000 octets, by splitting the request into multiple commands. |
| 404 |
- Systems that have no limit on the number of bytes in a pathname are now |
| 405 |
considered. |
| 406 |
- Debug files are now written in $HOME/.imapfilter/ instead of /tmp/. |
| 407 |
|
| 408 |
IMAPFilter 1.0 - May 23, 2004 |
| 409 |
- Initial release of IMAPFilter with extension language Lua. |