## README

README — milter manager: a milter to use milters effectively.

## Name

milter manager

## Site

<URL:http://milter-manager.sourceforge.net/>

## License

Use the following rules:

- Files that describe their license: their license

- Commands: GPL3(license/gpl.txt)

- Documents: GFDL(license/fdl.txt)

- Web interface: AGPL3(license/agpl.txt)

- Images: Public Domain

- Libraries: LGPL3(license/lgpl.txt)

Here is a concrete list:

- Files that describe their license:

  - binding/ruby/lib/milter/compatible.rb: Ruby's

  - admin/vendor/plugins/restful-auth/: MIT

- Commands: GPL3

  - src/*

  - tool/*

- Documents: GFDL

  - README, README.ja

  - doc/*

- Web interface: AGPL3

  - admin/**/*

- 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 for more details.

## Dependencies

- MTA that supports milter

  - Sendmail >= 8.13.8

  - Postfix >= 2.3.3

- GLib >= 2.12.3

- Ruby >= 1.8.5

- Ruby/GLib2 (Ruby-GNOME2) >= 0.16.0

- UN*X OS

  - Linux >= 2.6.18

  - FreeBSD

### Optional dependencies

- Cutter: unit testing framework for C >= 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

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

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

  RRDtool

## Get

tar.gz: <URL:http://downloads.sourceforge.net/milter-manager/milter-manager-1.0.0.tar.gz>

Subversion:

    % svn co https://milter-manager.svn.sourceforge.net/svnroot/milter-manager/milter-manager/trunk milter-manager

## Install

See Install .

## Configuration

See Configuration .

## 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 for more details.

## Tools

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

- milter-test-server : It talks MTA side milter protocol. It can be used for testing a milter without MTA.

- milter-test-client : 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 : It is a SMTP client that measures MTA performance.

- milter-manager-log-analyzer : It analyzes log of milter-manager and visualizes behavior of milters registered to milter-manager.

## Thanks

- OBATA Akio: reported a bug.

- Павел Гришин: reported bugs.

- Fumihisa Tonaka:

  - reported bugs.

  - suggested new features.

- sgyk: reported bugs.