MILTER-MANAGER(1)

名前

milter-manager - milterを使った効果的なスパム対策・ウィルス対策

書式

milter-manager [オプション ...]

説明

milter-managerはmilterを使った効果的なスパム対策・ウィルス対策（迷惑メール対策）を実現するmilterです。

milter-managerはmilterを効果的でかつ柔軟にmilterを使うためのプラットフォームを提供します。milter-managerはRubyインタプリタを組み込んでいて、動的にmilterを適用する条件を決定することができます。この組み込まれたRubyインタプリタを使うことで、効果的でかつ柔軟にmilterを使うプラットフォームを提供することができます。

milter-managerには設定ファイルがあります。現在の設定は--show-configオプションで確認できます。
    % milter-manager --show-config

milter-manager設定ファイルで指定された設定を上書きするオプションも提供しています。

オプション

--help
    利用できるオプションを表示して終了します。

--connection-spec=SPEC
    接続を待ち受けるソケットを指定します。SPECの書式は次のうちのどれかです。

    • unix:パス

    • inet:ポート番号

    • inet:ポート番号@ホスト名

    • inet:ポート番号@[アドレス]

    • inet6:ポート番号

    • inet6:ポート番号@ホスト名

    • inet6:ポート番号@[アドレス] 例:

    • unix:/var/run/milter/milter-manager.sock

    • inet:10025

    • inet:10025@localhost

    • inet:10025@[127.0.0.1]

    • inet6:10025

    • inet6:10025@localhost

    • inet6:10025@[::1] 設定ファイル中の「manager.connection_spec」の値を上書きします。

--config-dir=DIRECTORY
    設定ファイルのあるディレクトリを指定します。milter-managerは、まず、DIRECTORY/milter-manager.confの読み込みを試みます。もし、見つからなかった場合はシステム標準の場所にあるmilter-manager.confを読み込みます。

--pid-file=FILE
    milter-managerのプロセスidをFILEに保存します。 設定ファイル中の「manager.pid_file」の値を上書きします。

--user-name=NAME
    milter-managerをNAMEユーザの権限で実行します。milter-managerはroot権限で起動しなければいけません。 設定ファイル中の「security.effective_user」の値を上書きします。

--group-name=NAME
    milter-managerをNAMEグループの権限で実行します。milter-managerはroot権限で起動しなければいけません。 設定ファイル中の「security.effective_group」の値を上書きします。

--socket-group-name=NAME
    milter-managerが接続を受け付けるUNIXドメインソケットのグループをNAMEグループに変更します。グループは実効ユーザの補助グループでなければいけません。 設定ファイル中の「manager.unix_socket_group」の値を上書きします。

--daemon
    端末を切り離し、バックグラウンドでデーモンプロセスとして動作します。運用時はデーモンプロセスで動作させることをお勧めします。 設定ファイル中の「manager.daemon」の値を上書きします。

--no-daemon
    このオプションより前に指定した--daemonオプションを無効にします。

--show-config
    設定内容を表示して終了します。設定内容はそのまま設定ファイルに使える書式で表示されます。登録されているmilterを確認する場合や、milter-managerの問題を報告する場合などで有用です。

--verbose
    実行時のログをより詳細に出力します。ログはsyslogのmailファシリティで出力します。デーモンプロセスになっていない場合は標準出力にもログが出力されます。 「MILTER_LOG_LEVEL=all」というように環境変数を設定している場合と同じ効果があります。

--version
    バージョンを表示して終了します。

終了ステータス

MTAからの接続を受け付ける状態になった場合は0になり、そうでない場合は0以外になります。milter-managerはソケットの書式が間違っている場合か、ソケットまわりの問題が起こると接続を受け付ける状態になれません。そけっとまわりの問題とは、例えば、ポートがすでに使用されているとか、UNIXドメインソケットを作成するパーミッションがない、などです。

ファイル

/usr/local/etc/milter-manager/milter-manager.conf
    デフォルトの設定ファイルです。

例

以下はmilter-managerの挙動をデバッグするときの例です。この場合、milter-managerはフォアグラウンドで動作し、標準出力にログを吐きます。
    % milter-manager --no-daemon --verbose

関連項目

milter-test-server (1),.BR milter-test-client (1),.BR milter-performance-check (1),.BR milter-manager-log-analyzer (1)