aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2006-02-08 16:32:33 +0000
committerSergey Poznyakoff <gray@gnu.org.ua>2006-02-08 16:32:33 +0000
commit34e988e13dd8796a1ae8698929dbee0cbe4a1399 (patch)
tree6cdb2cec9c117cb56b9dc175542f1a405274ed84
parentd903b4b0be1f2c87ac8f516f43a5fe266d42e2da (diff)
downloadmailfromd-34e988e13dd8796a1ae8698929dbee0cbe4a1399.tar.gz
mailfromd-34e988e13dd8796a1ae8698929dbee0cbe4a1399.tar.bz2
Updated
git-svn-id: file:///svnroot/mailfromd/branches/v_1_0@222 7a8a7f39-df28-0410-adc6-e0d955640f24
-rw-r--r--ChangeLog20
-rw-r--r--NEWS21
-rw-r--r--README86
3 files changed, 107 insertions, 20 deletions
diff --git a/ChangeLog b/ChangeLog
index 1703e30c..a86ca84c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,23 @@
+2006-02-08 Sergey Poznyakoff <gray@gnu.org.ua>
+
+ * src/main.c (listens_on): New function
+ * src/mailfrom.h (listens_on): New prototype
+ * src/lex.l: New token "listens"
+ * src/gram.y: Implement `listens' expression.
+ * src/Makefile.am (LDADD): Use $(MILTER) instead of hardcoding
+ the library name.
+ * etc/sendmail-8.13.1.diff: New file. Patch to Sendmail to make
+ milter use sub-programs instead of threads.
+ * etc/Makefile.am (EXTRA_DIST): Add sendmail-8.13.1.diff
+ * doc/mailfromd.texi (Building): Document --with-forks.
+ (Literals): Document `listens' expression.
+ * configure.ac: Implement --with-forks option. Raise version
+ number to 1.4
+
+ * THANKS: Add Jan Rafaj
+ * README: Updated
+ * NEWS: Updated
+
2006-01-19 Sergey Poznyakoff <gray@gnu.org.ua>
* src/main.c (struct option_cache): New member `cumulative'.
diff --git a/NEWS b/NEWS
index 73eb3184..c8329fd8 100644
--- a/NEWS
+++ b/NEWS
@@ -1,9 +1,28 @@
-Mailfromd NEWS -- history of user-visible changes. 2006-01-05
+Mailfromd NEWS -- history of user-visible changes. 2006-02-08
Copyright (C) 2005, 2006 Sergey Poznyakoff
See the end of file for copying conditions.
Please send radius bug reports to <bug-mailfromd@gnu.org.ua>
+Version 1.4
+
+* Configuration
+
+Added possibility to link against the forked version of libmilter
+(--with-forks). The patch for sendmail-8.13.1 is included
+(etc/sendmail-8.13.1.diff).
+
+* Configuration file
+
+** New unary expression `listens' checks if the host listens on port 25.
+** Several `#pragma option relay' statements accumulate
+
+* Bugfixes
+
+** Fixed coredump on incorrect libmilter socket specification.
+** Fixed `poll for EMAIL as EMAIL'.
+
+
Version 1.3
* Rewritten DNS resolver functions in order to take into account CNAMEs.
diff --git a/README b/README
index 837e6aeb..ec5820ca 100644
--- a/README
+++ b/README
@@ -32,6 +32,11 @@ interface.
* Building
+Building the package is described in detail in the accompanying
+documentation (chapter `Building'). To simplify the task for those of
+you who do not have GNU info installed (you should, anyway), here is
+the copy of this chapter:
+
1. Make sure you have the necessary software installed.
To build `mailfromd' you will need to have following packages on
@@ -41,19 +46,51 @@ interface.
B. `libmilter' library.
- It comes with Sendmail, but is not built by default.
+ It comes with Sendmail, but is not built by default. To build
+ Sendmail with `libmilter' support, add following two lines to
+ your `devtools/Site/site.config.m4':
+
+ APPENDDEF(`conf_sendmail_ENVDEF', `-DMILTER')
+ APPENDDEF(`confENVDEF', `-DBROKEN_PTHREAD_SLEEP')
+
+ After running `make install', change to the directory
+ `libmilter' and run `make' there.
+
+ _Important note:_ make sure that `libmilter' is compiled with
+ `BROKEN_PTHREAD_SLEEP' defined. If this symbol is not defined,
+ `libmilter' will use `sleep' in signal-handler thread, which
+ may cause various program misbehaviors, including coredumps.
+ This problem has been asserted on (at least) GNU/Linux and
+ FreeBSD systems.
+
+ The `mailfromd' package comes with a patch to `libmilter'
+ that changes its multi-process model from "pthreads" to
+ "forks". It has been reported that `mailfromd' shows better
+ performance when linked with this modified version. If you
+ decide to try it, notice that it will be installed under the
+ name `libmilter-fork.a', so that your original version of
+ `libmilter.a' remains untouched. The patch was created for
+ Sendmail version 8.13.1 and is located in the `etc'
+ subdirectory of `mailfromd' distribution, in file
+ `sendmail-8.13.1.diff'
+
+ To apply the patch:
- IMPORTANT NOTE: make sure that libmilter is compiled with
- BROKEN_PTHREAD_SLEEP defined. If this symbol is not defined,
- libmilter will use sleep() in signal-handler thread,
- which may cause various program misbehaviors, including
- coredumps. This problem has been asserted on (at least)
- GNU/Linux and FreeBSD systems.
+ cd sendmail-8.13.1
+ patch -p0 < PATH-TO/mailfromd-1.3/etc/sendmail-8.13.1.diff
- To rebuild Sendmail with this symbol defined, add the following
- line to your devtools/Site/site.config.m4:
+ Then, proceed as described above in this section.
- APPENDDEF(`confENVDEF', `-DBROKEN_PTHREAD_SLEEP')
+ To build `mailfromd' with the modified version of `libmilter'
+ use `--with-forks' option to `configure':
+
+ ./configure --with-forks
+
+ If you installed `libmilter-fork.a' to an unusual location,
+ or renamed it, you can specify its full file name with this
+ option, e.g.:
+
+ ./configure --with-forks=/usr/local/lib/libmilter-fork.a
C. GNU mailutils version 0.6 or newer.
@@ -66,14 +103,17 @@ interface.
that you can compile `mailfromd' without DBM too, but this is
not recommended, since it will disable caching. Using
`mailfromd' without caching can lead to increase in CPU
- usage, traffic outage and other disastrous effects. You have
- been warned.
+ usage, traffic outage and other disastrous effects. Besides,
+ DBM is necessary for limiting user send rates. You have been
+ warned.
So, you want to select DBM implementation to use. The
following table will help you do that. Column `DB type' lists
types of DBM databases supported by `mailfromd'. Column
`confMAPDEF' lists the value of `confMAPDEF' Sendmail
- configuration variable corresponding to that database type
+ configuration variable corresponding to that database type.
+ It is here because it is usually wise to configure
+ `mailfromd' to use the same database type as your Sendmail
(If you don't know what `confMAPDEF' is, you probably are
wasting your time reading this. Refer to Sendmail
configuration guide first). `N/A' in this column means there
@@ -110,16 +150,23 @@ interface.
File Purpose
`PREFIX/libexec/mailfromd' Main daemon
- `PREFIX/etc/mailfromd.rc' Configuration file
+ `PREFIX/etc/mailfromd.rc' Configuration file(1)
`PREFIX/info/mailfromd.info' Documentation
+ ---------- Footnotes ----------
+ (1) The configuration file will be installed only if it is not
+ already there. Thus, if you are upgrading to a newer version of
+ `mailfromd', your old configuration file will be preserved with all
+ your changes.
+ -------------------------------
+
At startup, `mailfromd' will look up its configuration defaults in
- file `PREFIX/etc/mailutils.rc'.
+ file `PREFIX/etc/mailfromd.rc'.
It is advisable to use the same settings for file name prefixes as
those you used when configuring `mailutils'. In particular, try to
use the same `--sysconfdir', since it will facilitate configuring
- entire system.
+ the whole system.
Another important point is the location of "local state
directory", i.e. a directory where `mailfromd' will keep its data
@@ -155,9 +202,10 @@ interface.
9. Make sure `LOCALSTATEDIR/mailfromd' has right owner and mode.
- 10. Edit SYSCONFDIR/mailfromd.rc to you liking. Make sure you have
- read and understood the documentation!
-
+ 10. Examine configuration file (`SYSCONFDIR/mailfromd.etc') and edit
+ it, if necessary. If you are upgrading from an oldest copy of
+ `mailfromd', your configuration file will remain untouched.
+
* Configuring and Running
Please, see mailfromd documentation.

Return to:

Send suggestions and report system problems to the System administrator.