## README

README — milter manager: より効果的にmilterを使うためのmilter

## 名前

milter manager

## サイト

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

## ライセンス

以下の規則に従います。

- ライセンスが明記してあるファイル: そのライセンス

- コマンド: GPL3(license/gpl.txt)

- ドキュメント: GFDL(license/fdl.txt)

- Webインターフェイス: AGPL3(license/agpl.txt)

- 画像: Public Domain

- ライブラリ: LGPL3(license/lgpl.txt)

具体的には以下の通りです。

- ライセンスが明記してあるファイル:

  - milter/core/milter-memory-profile.c: LGPL2+

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

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

- コマンド: GPL3

  - src/以下

  - tool/直下

- ドキュメント: GFDL

  - README, README.ja

  - doc/以下

- Webインターフェイス: AGPL3

  - admin/以下

- 画像: Public Domain

  - doc/*.svg, doc/*.png, html/*.svg, html/*.png

- ライブラリ: LGPL3

  - 上記以外

## milter manager

milter managerはmilter効果的に利用するためのmilterです。

milter managerを導入することにより、MTAが行っていたmilter管理をmilter managerが行うことになるため、以下のような利点があります。

- milter管理コストを減らすことができる

- milterを柔軟に組み合わせることができる

詳細は はじめに に書いてあります。

## 依存ソフトウェア

- milterをサポートしたMTA

  - Sendmail >= 8.13.8

  - Postfix >= 2.3.3（ただし、Postfixがサポートしているmilterの機能のみ利用可能）

- GLib >= 2.12.3

- Ruby >= 1.8.5

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

- UNIX系OS

  - Linux（Debian GNU/Linux, Ubuntu, CentOS）

  - FreeBSD, NetBSD

  - Solaris

### あるとよいソフトウェア

- Cutter: C言語用テスティングフレームワーク >= 1.0.6

  make checkおよびmake coverageを実行する場合は必要。

- LCOV: カバレッジ結果整形ツール

  make coverageを実行する場合は必要。

  <URL:http://ltp.sourceforge.net/coverage/lcov.php>

- RRDtool（付属のRubyバインディングもあるとなおよい）

  milter-manager-log-analyzerでmilter managerに登録されたmilterの動作のグラフを表示する場合は必要。

## インストール

インストール を見てください。

## 設定

設定 を見てください。

## 使い方

milter-managerコマンドはbin/以下ではなくsbin/以下にインストールされることに注意してください。非常に多くの場合、一般ユーザはsbin/にパスが通っていないので、フルパスで起動します。

configure時に--prefixオプションを指定していない場合は/usr/local/sbin/以下にインストールされているので以下のようになります。

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

インストールが成功していれば、使用できるオプションが表示されます。詳細は milter-manager を見てください。

## ツール

milter managerにはいくつか便利なツールが付属されていて、bin/以下にインストールされます。

- milter-test-server : MTA側のmilterプロトコルの機能を提供する。MTA無しでmilterの動作をテストするために使用することができる。

- milter-test-client : MTA側から渡ってきた情報を表示するだけのmilter。MTA側から渡っている情報を確認するために使用することができる。

- milter-performance-check : MTAの性能を計測するSMTPクライアント。

- milter-manager-log-analyzer : milter-managerのログを解析し、milter-managerに登録されたmilterの動作をグラフ化する。

## メーリングリスト

milter-manager-users-ja があり、質問・バグレポートを受け付けています。新バージョンのアナウンスもメーリングリストに告知されるので、milter managerを利用している場合はメーリングリストの購読を検討してください。

## ソースコード

最新のソースコードはGitリポジトリから入手することができます。

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

## 感謝

- おばたさん: バグを報告してくれました。

- Павел Гришинさん: バグを報告してくれました。

- となかさん:

  - バグを報告してくれました。

  - アドバイスをしてくれました。

- sgykさん: バグを報告してくれました。

- 土谷さん: バグを報告してくれました。

- 今間さん: バグを報告してくれました。

- はやみずさん:

  - テストをきれいにしてくれました。

  - Rubyでのmilter作成に有用な機能を追加してくれました。

- ゴリ丸さん: 使いやすくなるようにアドバイスをしてくれました。

- 西山さん:

  - typoを直してくれました。

  - 有用なアドバイスをしてくれました。

- Antuan Avdioukhineさん: 有用なアドバイスをしてくれました。

- さとうふみやすさん:

  - バグを報告してくれました。

  - Solarisに対応してくれました。

- ROSSOさん: バグを報告してくれました。

- やまだあきらさん:

  - バグを報告してくれました。

  - Debianパッケージの問題の修正方法を教えてくれました。

- Kenji Shionoさん:

  - バグを報告してくれました。

  - 新しい機能を提案してくれました。

- Jordaoさん

  - バグを報告してくれました。

- 荻野さん

  - バグを報告してくれました。

- 川崎さん

  - FreeBSDでの/etc/rc.conf.local読み込み対応をしてくれました。