masqmail

view NEWS @ 433:81c438e1891b

Marks version number as development.
author markus schnalke <meillo@marmaro.de>
date Sat, 07 Feb 2015 11:40:21 +0100
parents 193013200396
children
line source
1 This NEWS file lists changes which may be important for you, especially
2 in regard to compatiblity in upgrades.
4 See ChangeLog file for more details and technical changes that don't
5 affect users directly.
7 The manual pages describe newly added options. Take them for reference.
10 0.3.5
12 - Adds a glob-pattern based aliasing mechanism.
14 - Adds route selection based on the From header.
16 - Changes the paths for PID files and lock files. Both are configurable.
19 0.3.4
21 - Reworked the route concept to be more general and have better
22 names: ``online_routes'' is now known as ``query_routes'' and the
23 ``local_net_route'' in now named ``permanent_routes''. Removed the idea
24 of the localnet because it is only part of the more general concept:
25 permanent routes. `local_nets' are now represented by `allowed_recipients'
26 in a permanent route. (See: examples/localnet.route) Now, there is no
27 more abiguity between `local' and `local net'. Run admin/config-transition
28 on your config to learn how to update it.
30 - Switched the default group for masqmail from `trusted' to `mail'.
32 - Fixed a problem with psb->remote_host, introduced in version 0.3.2
33 (changeset 412385b57dc4).
35 - Fixed a bug in matching of allowed recipients. Thanks to Juergen
36 Daubert for finding and reporting the issue.
38 - Configure options: Enabled auth support per default. Removed support
39 for openssl linking. It had been rarely used and could have caused
40 legal problems. We don't miss functionality here, because we already
41 have builtin MD5 support. Removed ident support, which is hardly useful
42 for masqmail.
44 - `local_hosts' now understands glob patterns like `*example.org'.
47 0.3.3
49 - Fixed a possible security problem, reported by John Lightsey. Unwanted
50 identity changes to the user root could have appeared.
52 - Fixed local-part only address patterns in route conditions, as already
53 described in the man page.
56 0.3.2
58 - Fixed an important bug with folded headers! In earlier versions mail
59 to many recipients may, in unpredictable cases, only have been
60 delivered to the ones on the first line. This is fixed now. Sorry for
61 the inconvenience.
63 - Reworked allowed and denied addrs for routes to be more consistent
64 and allow more flexible matching:
65 o allowed_mail_locals + allowed_return_paths -> allowed_senders
66 o not_allowed_mail_locals + not_allowed_return_paths -> denied_senders
67 o allowed_rcpt_domains -> allowed_recipients
68 o not_allowed_rcpt_domains -> denied_recipients
69 See man page masqmail.route(5).
71 - Reworked online_detect to the simpler online_query. Only pipe is
72 supported now. Use
73 online_query="/bin/cat /path/to/file"
74 instead of
75 online_detect=file
76 online_file=/path/to/file
77 and
78 online_query="/path/to/some/script foo"
79 instead of
80 online_detect=pipe
81 online_pipe="/path/to/some/script foo"
82 See man page masqmail.conf(5) and admin/config-transition.
84 - Removed protocol option from route config because it was somehow
85 redundant. Now, if `pipe' is set, the protocol will be pipe, otherwise
86 it'll be smtp.
88 - Now the Received headers are much friendlier to read. The header for
89 locally (i.e. non-SMTP) received mail is changed to the format postfix
90 uses.
92 - Several improvements to the man pages.
94 - Updated autoconf.
97 0.3.1
99 - Changed the SMTP greeting behavior to match RFC 2821 (always try EHLO
100 first). Now always an EHLO greeting is sent first, no matter what kind of
101 greeting text the server had sent. If the EHLO failes, an HELO greeting
102 is tried as fall back. This change will fix setups in which it hadn't
103 been possible to send mail because the server required AUTH but hadn't
104 said ``ESMTP'' in its greeting message. Thanks to inne for pointing me
105 on that. This fixes also Debian bug #349211.
107 - The postmaster address is now matched caseless, as required by RFC.
109 - -qo (without argument) is now considered obsolete. Its behavior (online
110 detect and send over the available route) is included in -q. One may
111 simply use -q instead. In the -qo case no local mail is sent, but why
112 would be not want to do so? -qo (without arg) is still working but will
113 likely change its behavior to something more useful in the future.
115 - Command line address arguments are now added to the recipient
116 list instead of substracted, when -t is used. This coveres a rare
117 corner-case. It is a change from exim's behavior to postfix's.
119 - Several changes were made related to the operation modes: The situation
120 within the modes was made clear (see man page of masqmail(8)). If more
121 than one mode is specified then masqmail aborts. For the default operation
122 mode ``accept messages on stdin'' the command line switch -bm was added
123 (similar to othe MTAs). If masqmail is called without arguments, the
124 version information is printed now.
126 - The command line option -m is recognized now (although ignored).
127 Unknown -oXXX options are ignored. Some software (like spost of nmh)
128 calls the MTA with -m. This is mainly a relict of old sendmail times
129 but needed for compatibility.
131 - The implementation of the command line option -oem had been
132 weird. Now specifying -oem or -oee results in a (some kind of dumb but)
133 logical behavior. Common users will probably not notice any difference.
134 The changes affect only the exit code of the corner-case: Calling masqmail
135 with -oem but without -oi/-i while submitting messages on stdin.
137 - Fixed the recognition of lists of unqualified addresses in headers
138 when using -t. E.g. `To: alice, bob'.
140 - Renamed the config file option `alias_local_caseless' to
141 `caseless_matching' because the option affects any address matching.
143 - Renamed the default route for the local network to
144 `default local_net_route'. This is only of interest for log/debug file
145 studies.
147 - Improved and updated the man page for masqmail(8), especially in
148 respect to -oem which appears to be wrongly implemented. Minor
149 improvements of debug messages.
152 0.3.0
154 - Start of the new development branch. Attention: Backward
155 compatibility with 0.2.x versions will *NOT* be maintained. Upgrading
156 from 0.2.x to 0.3.x will probably require manual adjustment of the
157 configuration. The script admin/config-tansition can be used to check
158 the config files for obsolete options.
160 - Removed POP3 support (also pop-before-smtp/smtp-after-pop). Use some
161 other POP3 client instead.
163 - Removed maildir support. Use an MDA, like procmail, to deliver to
164 maildir.
166 - Removed the built-in mserver functionality. Use the mservdetect
167 program instead. See masqmail.conf(5) under `online_pipe' for details.
169 - Removed --disable-smtp-server and --with-glib-static configure
170 options. We see no more need to not compile the SMTP server function.
171 For static linking, see docs/howto-static-linking.
173 - `host_name' is the only mandatory config option now. If you only set
174 host_name, then masqmail will:
175 o accept mail on the command line
176 o listen on the local port 25 for incoming mail
177 o deliver mail locally
178 o not know how to handle mail for remote destinations
179 Therefore you should set up at least one route configuration.
181 - Default values are available for: listen_addresses, local_hosts,
182 log_dir, spool_dir, mail_dir. See masqmail.conf(5) for the values.
184 - Mservdetect works much better now.
186 - Improved the documentation:
187 o Added setup guides
188 o Improved and simplified the example config
189 And removed the old manual because it is really outdated now.
191 - Renamed misc/ to devel/ and contrib/ to admin/. devel/ contains
192 stuff for developers of masqmail, admin/ contains stuff for people who
193 install, upgrade, and configure masqmail.
196 0.2.28
198 - Added STARTTLS support with external wrappers like OpenSSL. See
199 `wrapper' and `instant_helo' in masqmail.route(5) for examples how to
200 use it. `instant_helo' is a new route config option.
203 0.2.27
205 - Replaced contributed code with possible licensing problems with
206 alternatives. The MD5 implementation changed from the reference
207 implementation of RFC 1321 to the Public Domain implementation of
208 Solar Designer. The HMAC-MD5 implementation changed from the reference
209 implementation of RFC 2104 to an own implementation (ISC License).
211 - Added the authors of contributed parts to the AUTHORS file.
214 0.2.26
216 - Write a log message when the daemon starts up. Thanks to Juergen
217 Daubert.
219 - Fix handling of --with-liblockfile=no or --without-liblockfile for
220 configure script. Thanks to Nico Roeser.
222 - Improved the INSTALL file and some man pages. Thanks to Nico Roeser
223 Improved the documentation of the wrapper option of route files.
226 0.2.25
228 - Added server-side SMTP SIZE support. Thanks to Paolo.
230 - Masqmail will from now on:
231 o always remove Bcc: headers
232 o never create headers from envelope recipients
233 o add ``To: undisclosed-recipients:;'' if no recipient header (To:
234 or Cc:) is present in the mail
236 - Colons (`:') don't need to be quoted in the config file anymore.
237 Thanks to Paolo.
239 - Added checks for too long addresses in SMTP dialog. Thanks to Paolo.
241 - Moved rmail to sbin and added a man page for it.
243 - Added warnmsg.tpl.it. Thanks to Paolo.
245 - The tests do not get installed any longer. All on install created
246 dirs are removed on uninstall, except they contain generated data like
247 logs, spooled files, or configuration.
249 - Documented some, yet undocumented, config options. Several typo
250 fixes in man pages and code comments.
253 0.2.24
255 - This version keeps on logging after an restart of the deamon, for
256 instance when sending SIGHUP to the daemon process for rereading its
257 config.
259 - Now the daemon keeps the same process id when it receives SIGHUP to
260 reread the config.
262 - Mail messages with lines longer than 4096 characters do not get
263 truncated anymore.
265 - Fixed checking of the trusted group. Primary groups are now
266 detected too.
268 - Mservdetect's man page is now in section 1.
270 - An `rmail' command is now included and gets installed with
271 masqmail. See docs/uucp-setup for more information.
273 - Docs and thelike, that masqmail installs, is removed on uninstall
274 now.
277 0.2.23
279 - This release fixes a major bug in 0.2.22 which made online detection
280 by file unusable. Thanks to Juergen Daubert for reporting and providing
281 a patch.
283 - Masqmail installs to /usr/local by default now. Previously it
284 installed to /usr. To regain the old behavior, add
285 --prefix=/usr
286 to the configure call.
288 - Man pages get installed again; in 0.2.22 they were not. Again thanks
289 to Juergen Daubert. Docs and examples do get installed now too.
291 - Updated the docs. Moved the man pages from docs/ to man/. Added the
292 old manual from the old website to the distribution. Added a bug
293 reporting howto.
296 0.2.22
298 - Hello, I'm meillo, the new maintainer and developer of masqmail. Oku
299 handed masqmail over to me, because he wasn't active anymore.
301 - This release includes various fixes for problems in 0.2.21, mainly
302 based on bugs from Debian.
304 - Distribution specific data has been excluded from the distribution,
305 but is separately available on the project's website.
307 - Man pages will not be generated from xml sources in future, but the
308 nroff sources will be maintained directly.
310 - The default online status file is now
311 /var/run/masqmail/masqmail-route, as it already was in the Debian
312 package.
315 0.2.21
317 - Retrospective: Probably, this version was not published in the usual
318 way by oku. I (meillo) grabbed it from Debian's package archive. It does
319 not introduce new functions but fixes security problems, such as writing
320 log files as user `mail'. It also changes the location for pid files;
321 they are stored in /var/run/masqmail/ now.
324 0.2.18
326 - delivery warnings and failures are now also implemented if the
327 connection to a server fails. Because masqmail is designed for dialup
328 networks, a connection failure will merely generate a warning by default.
329 If you deliver in a local network and use the default local_net route,
330 this would generte a failure. You can change this behaviour by setting
331 'connect_error_fail' to either true or false in the route configurations.
333 0.2.17
335 - delivery warnings have been finally implemented: if delivery of a mail
336 fails temporarily, warning mail will be generated, informing the sender
337 of the problem. After some time, the mail will be handled as failing
338 permanently, and be bounced. New options: 'warn_intervals',
339 'max_defer_time' and 'warnmsg_file'.
341 - the message templates for failures and warnings will now be installed
342 into /usr/share/masqmail/tpl/, and no longer to /etc/masqmail/tpl/. The
343 default for the search path (options 'errmsg_file' and 'warnmsg_file'
344 has been changed accordingly.
346 - new option 'last_route'. See man 5 masqmail.route.
348 0.2.12
349 two new options have been added:
350 - do_pipelining will be used only in broken mail setups. Actually, I
351 implemented it only to test such a setup.
353 - helo_name for routes sets the helo_name. This may be useful for
354 eg. ssh tunneling, or if do_correcthelo does not work, because you are
355 behind a firewall.
357 - the old 'remote_port' option should not be used any more. Set the
358 port with mail_host="foo.bar.com:1234" in the route file instead.
360 0.2.11
362 - two new options have been added: do_save_envelope_to for the main
363 configuration and map_h_mail_followup_to_addresses for the route
364 files. See the man pages on purpose and usage.
366 - the route files can now be mode 0400, owned by root. Previous
367 versions had problems when sendmail was called directly by a
368 non-priviledged user, because the route files could not be read.
370 0.2.10
372 - this version should work on FreeBSD. At least I care now if it does not.
374 - masqmail now writes pid files to /var/run/, one for the smtp/queue
375 daemon and one for the get daemon. So you now know whom to kill ;-)
377 - much effort has been put into the Debian package, which now uses debconf.
379 0.2.7
381 - sorry for my reluctany in the last months...
382 - my email address is oku@masqmail.cx. I hope that I keep this for the rest
383 of my life...
385 0.2.6
387 - you can configure the prefered local delivery mechanism for each user. See
388 man page masqmail.conf (5), options mbox_default, mbox_users, mda_users and
389 maildir_users. BIT FAT NOTE: if you used an mda, set mbox_default = "mda"
390 (or use the mda_users option). Just setting mda is not enough any more.
392 - there are the allowed_return_paths and not_allowed_return_paths for the
393 route configurations, this enables better checking for return path addresses
394 than allowed_mail_locals. You can also use this to enable or disable messages
395 from null sender addresses (<>) using "<>".
396 note: this option has been there for quite a time... I just forgot to document it.
398 0.2.5
400 - simple relay checking: if you set do_relay=false in masqmail.conf, users
401 with a return path that is not local will get a 550 reply if they try to
402 deliver to a not local address. This is for users to force them to have a
403 proper configuration. It is _not_ to prevent spammers from using your MTA
404 as a relay, it can be easily forged! masqmail is not designed to be an always
405 accessible MTA for an internet site.
407 - added Maildir support. To use it, add --enable-maildir as ./configure
408 optiom. Currently, if enabled, all local deliveries are to Maildir
409 (in ~user/Maildir), and none to mailbox. This is preliminary, future versions
410 will be configurable (probably together with mda delivery).
412 0.2.4
414 - added -v option, this logs to stdout, so you see what happens when
415 calling masqmail from command line. This is not yet finished, and only
416 for fetching mails completed.
418 0.2.3
420 - new option lock_dir where locks will be put to. Defaults to the spool
421 dir with '/lock/' appended (if spool_dir is /var/spool/masqmail/, lock_dir
422 is /var/spool/masqmail/lock/).
424 - You can use the 'do_uidl_dele' option more reliably. The uidl list
425 will be written immediately after a message was fetched, so if you use the
426 do_uidl and do_uidl_dele option you can safely interrupt masqmail when it is
427 getting mail via pop3, and do not get the message again next time.
429 - there are a lot of new options for ./configure to customize masqmail
430 to your needs. See INSTALL.
432 - Uli Funcke sent a patch with the new options 'local_addresses' and
433 'not_local_addresses' for masqmail.conf. With these, you can declare single
434 email addresses as local, though they normally are not, and vice versa,
435 declare addresses as not local though normally they are (determined with
436 local_hosts). These options are not yet documented.
438 0.2.2
439 - with -go5m you can now run a get daemon, the command 'masqmail -go5m' will fetch
440 mail every five minutes, using the detected online configuration.
442 0.2.1
444 - there is a new option for the main conf: online_gets. Using this option,
445 you can retrieve mail with just calling masqmail -go, masqmail will detect
446 whether it is online (similar to connect_routes (which is now called
447 online_routes)).
449 0.2.0
451 This is the first release of he development branch of masqmail
453 - the default configuration is now /etc/masqmail/masqmail.conf
454 (as it already was for the debian package). The --with-conffile
455 option for configure has been replaced by the --with-confdir option.
457 - added delivery failure notices:
458 o you can customize your own delivery failure report, its
459 default location is /etc/masqmail/tpl/failmsg.tpl
460 o if a delivery via a route fails permanently (the server replied with a 5xx status)
461 the message will be bounced, if it is bounced, no further delivery will be attempted.
462 This is different to previous versions, where failed messages were kept in the queue until
463 it was finally delivered, deleted or forever.
465 - there is a new online detection method: pipe. This allows you more
466 flexibility to detect the current online status, eg. the DHCP status on notebooks.
468 This method will once replace the 'mserver' option,
469 you can already use the program mservdetect to use it:
471 online_method=pipe
472 online_pipe="/usr/bin/mservdetect localhost 222"
474 instead of
476 online_detect=mserver
477 mserver_iface="localhost:222"
479 0.1.9
481 - you can use pipes in routes to implement gateways to uucp, fax, sms etc.
482 The setup is similar to mda transport. See man pages.
484 - for each connection (connect_routes), you can now give a list of
485 route files, which will be used in the order given. You can use the
486 filter rules (allowed_* and not_allowed_* rules) within each route.
488 0.1.8
490 - for pop retrieval and smtp sending you can use a wrapper for eg. ssl
491 tunneling. See man pages.
493 - a user can delete his mail from the spool with -Mrm if received
494 locally, and if you configure with --enable-ident and set
495 ident_trusted_nets also if received via smtp.
497 - a backslash now works to escape characters in the configuration, so
498 you can now use quotes inside quotes. All other characters with a
499 leading backslash will be converted to itself (\a becomes a, \\
500 becomes \).
502 - you can now use an mda for local mails. The mda will be called
503 *after* alias expansion. See documentation for more.
505 0.1.0
506 - masqmail can now retrieve mail with pop3. See the manual on how to do that.
507 - supports now ESMTP AUTH as a client.
508 - when called with -qo (without a connection name), the online status
509 will be checked with the configured method.
511 0.0.10
512 - there is now alias support. Give the location of the alias file (usually /etc/aliases) with eg.
513 alias_file = "/etc/aliases"
514 - delivery to pipes is now possible, but only if it appears in an alias file. Example:
515 pipe: |/usr/bin/command
516 will expand the address pipe to "|/usr/bin/command" which invokes '/usr/bin/command'
517 as the user and group masqmail is running as.
518 - entries starting with '\' in alias files will not be exanded further
520 - changed permissions for queue runs again: got to be root, mail or in group trusted.
522 - some configuration parameters can be read from files, these are
523 allowed_mail_locals, not_allowed_mail_locals, allowed_rcpt_domains, not_allowed_rcpt_domains,
524 map_return_path_addresses, map_h_from_addresses, map_h_reply_to_addresses
525 any entry in these list beginning with a '/' are regarded as
526 filenames, the content of these will be put at that location. Entries
527 in these files are separated by new lines. Example:
528 in the route file you have:
529 map_h_from_addresses = "/etc/masqmail/hfrom.map"
530 and hfrom.map contains:
532 john: John Smith <jsmith@mail.academic.edu>
533 cmiller: "Charlie Miller" <cmiller@foo.com>
535 UPDATE (Jan 2000): The new home location of MasqMail is
536 http://www.innominate.org/~oku/masqmail/, the new email adress of the
537 author is Oliver Kurth <kurth@innominate.de>.
539 0.0.9
540 - see ChangeLog.
542 NOTE: The home location of MasqMail at
543 http://merlin.uni-sw.gwdg.de/~okurth/masqmail/ is uncertain from the
544 beginning of Nov. 1999! See http://www.freshmeat.net for new
545 announcements. I leave the university and begin a new job on Nov. 1st 1999
546 in Berlin :-).
548 0.0.8:
549 - there is now a FAQ page. See docs/faq.html.
550 - added allowed_rcpt_domains option for routes.
551 - added allowed_mail_locals and not_allowed_mail_locals options for routes.
552 - mailq now gives information about the time mails spent in the queue,
553 the message size and the received host.
555 0.0.7:
556 -bug fix release: for statements in two adjacent lines, the second was not recognized.
558 0.0.6:
559 - bug fix release: some MUAs (cucipop) saw the locally delivered mails
560 concatenated. (cucipop is not a MUA but a pop server, but it has to read the
561 mails).
563 0.0.5:
564 - fixed a bug that caused the headers to be lost under some circumstances.
565 - added expand_h_sender_domain option for routes.
566 - rewrote the libresolv part in configure. Should work better now.
568 0.0.4:
569 - MM should now recognize whether libresolv should be linked.
570 - added --with-logdir=LOGDIR and --with-spooldir=SPOOLDIR to set directories.
571 These will be created if not already existent.
572 - added --with-user=USER, --with-group=GROUP options to set user and group id
573 for MasqMail.
575 0.0.3:
576 - MasqMail can now deliver mails that are received at online
577 time immediately to the internet. See the options detect_online,
578 mserver_iface and online_file.
579 - You can define a route configuration for the local net. See option
580 local_net_route.