sid-filter(8) sid-filter(8) NAME sid-filter - Sender-ID filter for sendmail SYNOPSIS sid-filter -p socketspec [-a peerlist] [-A] [-d domains][-f] [-h] [-l] [-P pidfile] [-r rlevel] [-t] [-T secs] [-u userid] [-V] DESCRIPTION sid-filter implements Microsoft, Inc.'s Sender-ID draft standard for validating the sending/relaying host of a piece of e-mail. sid-filter は Microsoft Inc. が提唱する Sender-ID draft standard を実装し e-mail を快適に使うために発信・中継サーバの妥当性をチェックするものです。 Details regarding the protocol and other issues related to the draft standard can be found at (some Microsoft URL here). 仕様についての詳細は Microsoft の Web ページから参照してください。 （訳注： http://www.microsoft.com/senderid/ （英語）など） OPTIONS -a peerlist Identifies a file of "peers" which identifies clients whose con- nections should be accepted without processing by this filter. The peerlist should contain on each line a host-name, domain name (e.g. ".example.com"), IP address, or CIDR-style IP specifica- tion (e.g. "192.168.1.0/24"). このフィルタに無関係に接続を認めてもよいクライアントを列記する peer ファイルを指定します。 この peer リストはそれぞれの行が以下の様式で記述します。 ホスト名, ドメイン名 (.example.com とか), IP アドレスまたは CIDR形式の アドレスブロック (192.168.1.0/24 とか) -A Automatically re-start on failures. Use with caution; if the filter fails instantly after it starts, this can cause a tight fork(2) loop. エラー時に自動的に再起動します。注意：もし sid-filter が起動後すぐに 落ちるようなことがあると、fork(2) システムコールを連発するループに 陥る可能性があります。（訳注：応答が悪くなったり、最悪カーネルパニック が発生する恐れがあります） -d domain[,...] A comma-separated list of domains whose mail should be ignored by this filter. このフィルタでは処理しないドメインのリスト（カンマ区切り）を指定します。 -f Normally sid-filter forks and exits immediately, leaving the service running in the background. This flag suppresses that behaviour so that it runs in the foreground. 通常 sid-filter は起動されるとすぐバックグラウンドで動作する子プロセスに 託して、自分はすぐに終了しますが、このフラグを指定するとフォアグランド のまま実行されます。 -h Causes sid-filter to add a header indicating the presence of this filter in the path of the message from injection to deliv- ery. The product's name, version, and the job ID are included in the header's contents. メールの配送ヘッダに sid-filter が動作している証を埋めこみます。 具体的には製品名、バージョン、job ID が含まれます。 -l Log via calls to syslog(3) any interesting activity. syslog(3) 経由で挙動を記録します。 -p socketspec Specifies the socket that should be established by the filter to receive connections from sendmail(8) in order to provide ser- vice. socketspec is in one of two forms: local:path which cre- ates a UNIX domain socket at the specified path, or inet:port[@host] which creates a TCP socket on the specified port. If the host is not given as either a hostname or an IP address, the socket will be listening on all interfaces. This option is mandatory. フィルタサービスのために sendmail(8) との通信を行うソケットを指定します。 socketspec は２種類の形式で指定できます。 UNIX ドメインソケットを使う場合… local:path TCP ソケットを使う場合… inet:port[@host] host が指定されない場合はそのマシンのすべてのインタフェースで通信を待ちます。 このオプションは必須指定です。 -P pidfile Writes the process ID of the filter, once started, to the file- name given. sid-filter の UID ファイルを指定します。 -r level Sets the rejection level for the filter. Valid values are: 0, which accepts all mail (but still adds a status header); 1, which rejects mail if both the Sender ID and SPF tests report "fail"; 2, which rejects mail if either the Sender ID or SPF test reports "fail"; 3, which rejects mail unless either the Sender ID or SPF test reports "pass"; or 4, which rejects mail unless both the Sender ID and SPF tests report "pass". The default is 0. フィルタによって受信拒否を行うレベルを指定します。 0 … 全メールを受信します（ただしヘッダの記録は残します）。 1 … Sender-ID でも SPF でも不可の場合には拒否します。 2 … Sender-ID か SPF どちらかが不可の場合には拒否します。 3 … Sender-ID か SPF どちらかが合格でなかったら拒否します。 4 … Sender-ID も SPF も両方合格でないなら拒否します。 デフォルトは 0 です。 -t Test mode; never reject a message, even if the responsible sender could not be determined. By default, such messages are temp-failed. テストモード。信頼できる送信者かどうかチェックができなくても メールは拒否しない。デフォルトではそのようなメッセージは「一時的に不可」 に分類される。 -T secs Sets the DNS timeout in seconds. A value of 0 causes the pack- age to wait forever for DNS replies. The default is 5. Note that this only applies if the asynchronous re-solver is in use; if the native resolver is used, no timeout facility is avail- able. See also the NOTES section below. DNS タイムアウトを秒単位で指定する。0 を指定すると DNS 応答をずーっと 待ち続ける（訳注：タイムアウトしない）。デフォルトは 5 秒です。 注：これは非同期のリゾルバに対してのみ適用されます。つまり、もし ネイティブなリゾルバが使われていれば、タイムアウトしないというのが 意味を持つ。後述する Notes セクションも読んでみてください。 -u userid Attempts to be come the specified userid before starting opera- tions. sid-filter を実行するユーザを指定します。 -V Print the version number and exit without doing anything else. バージョン情報などを表示して終了します。 OPERATION When a connection arrives, the headers are accepted and stored. At the end of the headers, the "responsible sender" is detemined based on headers as per the Sender-ID specification. The filter then attempts to extract an e-mail policy for the responsible sender domain. When the policy has been evaluated, a recommended disposition is determined based on the Sender-ID specification, and this result is added in an X- SenderID-Status: header before hte message gets delivered. sendmail と接続するとヘッダ情報を収集します。最後まで受け取ると Sender-ID の形式に従ってヘッダをチェックします。filter はそのドメインが本当にメール 受信にふさわしいかどうかポリシーに照らして分別します。ポリシーを満たせば、 Sender-ID の規格にそった処理が行われ、結果として X-SenderID-Status: という ヘッダが付加されて配送されます。 NOTES When setting timeouts (see the -T option above), be careful not to select a timeout value that exceeds the timeouts being used between sendmail and the filter. Otherwise, the MTA could give up waiting for a reply from the filter before the filter times out waiting for a DNS result. タイムアウトを指定する (前述の -T オプション) 際には、sendmail と filter 間で のタイムアウト値を設定しないように注意してください。でないと、sendmail は DNS のタイムアウトになる前にひっかかってしまいます。 VERSION This man page covers version 0.2.6 of sid-filter. COPYRIGHT Copyright (c) 2004, Sendmail, Inc. and its suppliers. All rights reserved. SEE ALSO sendmail(8) Sendmail Operations Guide RFC2821 - Simple Mail Transfer Protocol RFC2822 - Internet Messages Sender-ID Internet Draft Sendmail, Inc. sid-filter(8)