milter manager is a free software to protect you from spam mails and virus mails effectively with milter.
C Ruby Groff Shell Makefile M4 Other
Permalink
Failed to load latest commit information.
binding Fix milter-greylist default config file path for pkgsrc Jul 27, 2016
build Stop to run glib-mkenums on building with distributed archive Nov 2, 2013
data s25r: add *.mg.gitlab.com to whitelist Nov 30, 2016
doc Use proper domain Nov 25, 2016
html html blog: Use OSDN Nov 25, 2016
legacy fix typical typos. Feb 18, 2011
libev-4.19 Use bundled libev-4.19 properly Nov 17, 2015
libmilter libmilter: Add missing `@section_id` Nov 14, 2016
license license: Remove unused license file Jul 2, 2013
milter doc: Eliminate <rd> tags Oct 24, 2016
module milter-manager executable file: remove Ruby dependency May 31, 2016
package package/apt: Check package properly Nov 21, 2016
patch Added a patch to fix RRD.last(). Dec 8, 2008
po Update po/POTFILES.in Jan 21, 2014
src milter-manager executable file: remove Ruby dependency May 31, 2016
test test: Quit event loop Oct 3, 2016
tmp * tmp/milter-report-port.rb: add a sample milter. May 22, 2010
tool milter-test-server: add missing "s" Sep 30, 2016
.gitignore Add ignore patterns Nov 25, 2016
.travis.yml travis: remove needless debug print May 3, 2016
Makefile.am Add cryptographic signature for integrity Nov 21, 2016
NEWS NEWS: Fix news entry about mailing list Nov 25, 2016
NEWS.ja NEWS: Fix news entry about mailing list Nov 25, 2016
README doc: Update URLs Nov 7, 2016
README.ja doc: fix markup Nov 7, 2016
TODO [TODO] add. Jul 25, 2011
autogen.sh Be sure to create config directory before create symlink Jun 26, 2014
configure.ac doc: Update URLs Nov 7, 2016
gpg_uid package: Reduce duplicated code May 9, 2016
gtk-doc.make Follow changes in @eae5472 Jul 25, 2013
libmilter.pc.in * ./: merge milter-toolkit and milter-manager. Nov 27, 2008
milter-client.pc.in * ./: merge milter-toolkit and milter-manager. Nov 27, 2008
milter-core.pc.in * ./: merge milter-toolkit and milter-manager. Nov 27, 2008
milter-manager.pc.in * ./: merge milter-toolkit and milter-manager. Nov 27, 2008
milter-server.pc.in Use under score instead of hyphen. Jun 28, 2010
ruby-milter-client.pc.in split Ruby milter to Ruby milter {core,client,server}. Mar 7, 2011
ruby-milter-core.pc.in split Ruby milter to Ruby milter {core,client,server}. Mar 7, 2011
ruby-milter-server.pc.in split Ruby milter to Ruby milter {core,client,server}. Mar 7, 2011
ruby-milter.pc.in split Ruby milter to Ruby milter {core,client,server}. Mar 7, 2011
wercker.yml wercker: Use newer Ruby Jun 27, 2016

README

# -*- rd -*-

= README --- milter manager: a milter to use milters effectively.

== Name

milter manager

== Site

((<URL:http://milter-manager.osdn.jp/>))

== License

Use the following rules:

  * Files that describe their license: their license
  * Commands: GPL3(license/gpl.txt)
  * Documents: GFDL(license/fdl.txt)
  * Images: Public Domain
  * Libraries: LGPL3(license/lgpl.txt)

Here is a concrete list:

  * Files that describe their license:
    * milter/core/milter-memory-profile.c: LGPL2+
  * Commands: GPL3
    * src/*
    * tool/*
  * Documents: GFDL
    * README, README.ja
    * doc/*
  * Images: Public Domain
    * doc/*.svg, doc/*.png, html/*.svg, html/*.png
  * Libraries: LGPL3
    * others than those above

== milter manager

milter manager is a milter to use multiple milters
effectively.

If milter manager is introduced, milter manager
administrates milters instead of MTA. The has some
advantages:

  * reduce milter administration cost
  * combine milters flexibly

See ((<Introduction|"doc/introduction.rd">)) for more details.

== Dependencies

  * MTA that supports milter
    * Sendmail >= 8.13.8
    * Postfix >= 2.3.3
  * GLib >= 2.12.3
  * Ruby >= 1.8.5
  * UN*X OS
    * Linux(Debian GNU/Linux, Ubuntu, CentOS)
    * FreeBSD, NetBSD
    * Solaris

=== Optional dependencies

  * ((<Cutter: unit testing framework for C|URL:http://cutter.sourceforge.net/>))
    >= 1.0.6

    It is needed for 'make check' and 'make coverage'.

  * LCOV: graphical front-end for GCC's coverage testing tool gcov

    It is needed for 'make coverage'.

    ((<LCOV - the LTP GCOV extension|URL:http://ltp.sourceforge.net/coverage/lcov.php>))

  * RRDtool (It's better that bundled Ruby bindings are also installed)

    It is needed for milter-manager-log-analyzer.

    ((<RRDtool|URL:http://oss.oetiker.ch/rrdtool/>))

== Install

See ((<Install|"doc/install.rd">)).

== Configuration

See ((<Configuration|"doc/configuration.rd">)).

== Usage

milter-manager command is installed into sbin/ not
bin/. In most cases, normal user doesn't include sbin/ in
PATH. You will need to use absolute path.

If you don't specify --prefix option for configure script,
milter-manager is installed into /usr/local/sbin/. You can
run milter-manager like the following:

  % /usr/local/sbin/milter-manager --help

Available options are shown if installation is succeeded.
See ((<milter-manager|"doc/milter-manager.rd">)) for more details.

== Tools

milter manager includes some useful tools. They are
installed into bin/.

  * ((<milter-test-server|"doc/milter-test-server.rd">)): It
    talks MTA side milter protocol. It can be used for
    testing a milter without MTA.
  * ((<milter-test-client|"doc/milter-test-client.rd">)): It
    is a milter that just shows received data from MTA. It
    can be used for confirming what data is sent from MTA.
  * ((<milter-performance-check|"doc/milter-performance-check.rd">)):
    It is a SMTP client that measures MTA performance.
  * ((<milter-manager-log-analyzer|"doc/milter-manager-log-analyzer.rd">)):
    It analyzes log of milter-manager and visualizes
    behavior of milters registered to milter-manager.

== Mailing list

There is
((<milter-manager-users-en|URL:http://lists.osdn.me/mailman/listinfo/milter-manager-users-en>))
mailing list. Questions and bug reports are accepted on
it. New release announce is also done on the mailing
list. If you are using milter manager, it's a good idea that
you subscribe the mailling list.

Old: ((<milter-manager-users-en|URL:https://lists.sourceforge.net/lists/listinfo/milter-manager-users-en>))

== Source code

The latest source is available from the Git repository:

  % git clone https://github.com/milter-manager/milter-manager.git

== Thanks

  * OBATA Akio: reported a bug.
  * Павел Гришин: reported bugs.
  * Fumihisa Tonaka:
    * reported bugs.
    * suggested new features.
  * sgyk: reported bugs.
  * Tsuchiya: reported bugs.
  * Syunsuke Komma: reported a bug.
  * Yuto Hayamizu:
    * cleaned test.
    * added useful features for creating milter by Ruby.
  * gorimaru: suggested usage improvements.
  * ZnZ:
    * fixed typos.
    * reported useful advises.
  * Antuan Avdioukhine: suggestions.
  * SATOH Fumiyasu:
    * reported bugs.
    * improved Solaris support.
  * ROSSO: reported a bug.
  * akira yamada:
    * reported a bug.
    * suggested about Debian package.
  * Kenji Shiono:
    * reported bugs.
    * suggested new features.
  * Jordao:
    * reported a bug.
  * Mitsuru Ogino:
    * reported bugs.
  * moto kawasaki:
    * added /etc/rc.conf.local loading support on FreeBSD.