## milter-test-client

milter-test-client — milter側のmilterプロトコルを実装したプログラム

## 名前

milter-test-client - milter側のmilterプロトコルを実装したプログラム

## 書式

`milter-test-client` [ オプション ... ]

## 説明

milter-test-clientはMTA側から渡ってきた情報を表示するだけのmilterです。マクロも含めてMTA側から渡っている情報を表示するので、MTA側のmilterの設定を確認するために利用できます。

Postfixのアーカイブの中にも同様のツールがあります。src/milter/内にあるtest-milter.cがそれで、Postfixのmilterの実装のテストにも使っているようです。ただし、test-milterはマクロまでは表示してくれません。もし、マクロを利用しているmilterが期待通りに動かない場合の問題調査を行うのであれば、milter-test-clientが役立つでしょう。

## オプション

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

--connection-spec=SPEC

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

- unix:パス

- inet:ポート番号

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

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

- inet6:ポート番号

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

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

例:

- unix:/tmp/milter-test-client.sock

- inet:10025

- inet:10025@localhost

- inet:10025@[127.0.0.1]

- inet6:10025

- inet6:10025@localhost

- inet6:10025@[::1]

--verbose | 実行時のログをより詳細に出力します。 「milter_log_level=all」というように環境変数を設定している場合と同じ効果があります。
--syslog | Syslogにもログを出力します。
--no-report-request | MTAから受け取った情報を表示しません。

--report-memory-profile

milterセッションが終了する毎にメモリ使用量を表示します。

MILTER_MEMORY_PROFILE環境変数をyesに設定するとより詳細な情報を表示します。

例:

    % MILTER_MEMORY_PROFILE=yes milter-test-client -s inet:10025

--daemon | デーモンプロセスとして起動します。
--user=USER | 実効ユーザをUSERとします。root権限が必要です。
--group=GROUP | 実効グループをGROUPとします。root権限が必要です。
--unix-socket-group=GROUP | SPECで「unix:パス」を指定したときにUNIXドメインソケットのグループを変更します。
--n-workers=N_WORKERS | メールを処理するプロセスを `N_WORKERS` 個起動します。指定できる値は0以上、1000以下です。0のときにワーカープロセスを使用しません。 注意: この項目は実験的な機能扱いです。
--event-loop-backend=BACKEND | イベントループのバックエンドを指定します。 `BACKEND` に指定できる値は、 glib か libev のいずれかです。 注意: この項目は実験的な機能扱いです。
--packet-buffer-size=SIZE | end-of-message時に送信パケットをバッファリングするためのバッファサイズを指定します。パケットの量が `SIZE` バイト以上になるとまとめてパケットを送信します。0を指定するとバッファリングしません。 既定値は0KBで、バッファリングしません。
--version | バージョンを表示して終了します。

## 終了ステータス

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

## 例

以下の例では、10025番ポートでMTAからの接続を待つmilterを起動します。

    % milter-test-client -s inet:10025

## 関連項目

milter-test-server.rd.ja (1), milter-performance-check.rd.ja (1)