CANONICAL(5)                                                      CANONICAL(5)



名前
       canonical - Postfix カノニカルテーブルの書式

書式
       postmap /etc/postfix/canonical

       postmap -q "string" /etc/postfix/canonical

       postmap -q - /etc/postfix/canonical <inputfile

解説
       オ プションの canonical(5) テーブルにはローカルおよび外部アドレスのアド
       レスマッピングを指定します。このマッピングは cleanup(8) デーモンに よっ
       て使われます。アドレスマッピングは再帰的です。

       通常、canonical(5) テーブルには postmap(1) コマンドへの入力として使われ
       るテキストファイルが指定されます。dbm または db 形式でインデックス化 さ
       れ た結果はメールシステムが高速に検索するために使われます。テキストファ
       イルを変更した後は、インデックスファイルを再構築する た め に  "postmap
       /etc/postfix/canonical" コマンドを実行してください。

       テ ーブルが NIS や LDAP, SQL のような他の方法で提供される場合、通常のイ
       ンデックス化したファイルと同様の検索がなされます。

       代わりに、パターンが正規表現で与えられるような正規表現マップをテーブ ル
       に使ったり、検索を TCP ベースのサーバに向けることもできます。その場合、
       以下の "正規表現テーブル" や "TCP ベースのテーブル" で述べるように、 少
       し異なる方法で検索がなされます。

       デフォルトでは canonical(5) マッピングはメッセージヘッダアドレス (すなわち
       メッセージ内に現れるアドレス)とメッセージエンベロープア ド レ ス( 例 え
       ばSMTP プロトコルコマンドで使われるアドレス) の両方に作用します。これは
       canonical_classes で制御されます。

       注  意:   Postfix  バー  ジョ  ン2.2 以 降 で は、 ク ラ イ ア ン ト が
       local_header_rewrite_clients   パ ラ メー タ に  マッ  チ  す  る  か、
       remote_header_rewrite_domain 設定パラメータが空でない値を指定している場
       合にのみ、リモートSMTPクライアントからのメッセージヘッダを書き 換 え ま
       す。Postfix  2.2 以前の動作を得るには、 "local_header_rewrite_clients =
       static:all" を指定します。

       典型的には、 canonical(5) テーブルをログイン名か ら  Firstname.Lastname
       に 置き換えるためや、古いメールシステムで作られたアドレスをきれいにする
       ために使います。

       canonical(5) マッピングと virtual domain サポートと混同してはいけ ま せ
       ん。その目的のためには virtual(5) マップを使います。

       canonical(5) マッピングとローカルエイリアスを混同してはいけません。その
       目的のためには aliases(5) マップを使います。

大文字・小文字の統一
       検 索 文 字列はデータベース検索前に小文字に統一されます。 Postfix 2.3で
       は、検索文字列は regexp: や pcre: など、検索フィールドが大文字と小文 字
       の 両方にマッチするデータベースタイプでは小文字への統一はおこなわれませ
       ん。

テーブルの書式
       postmap(1) コマンドへの入力の書式は以下の通りです:

       pattern result
              pattern がメールアドレスにマッチすると、対応する result で置き換
              えます。

       空行とコメント
              空行 や空白だけの行は無視され、行頭の非空白文字が `#' で始まる行
              も同様です。

       複数行テキスト
              論理行は非空白字文字で始まります。空白で始まる行は前の論理行を継
              続します。

テーブルの検索順序
       DB や DBM のようなインデックスファイル、もしくは NIS や LDAP、 SQL のよ
       うなネットワーク上のテーブルでは、パターンは次に示す順で試行されます:

       user@domain address
              user@domainaddress で置き換えます。この形式は最高の優先度 を
              持ちます。

              こ れ は古いメールシステムで作られたアドレスを整理するのに便利で
              す。また、Firstname.Lastname 形式のアドレスを作るのに使うこと も
              できますが、更に簡単な解決法は下を見てください。

       user address
              site  が $myorigin と等しいか、$mydestination に挙げられていると
              き、$inet_interfaces または $proxy_interfaces に挙げられていると
              きに、user@siteaddress で置き換えます。

              この形式はログイン名を Firstname.Lastname で置き換えるのに便利で
              す。

       @domain address
              domain 内のその他のアドレスを address で置き換えます。これは最も
              低い優先度です。

結果アドレスの書き換え
       検索結果のアドレスは書き換えられます:

       o      結 果 が @otherdomain の形の場合、結果は otherdomain の同じ user
              になります。

       o      "append_at_myorigin=yes" の場合、"@domain" のない ア ド レ ス に
              "@$myorigin" を付け加えます。

       o      "append_dot_mydomain=yes"   の 場 合、".domain" のないアドレスに
              ".$mydomain" を付け加えます。

拡張アドレス
       メールアドレスのローカル部分がオプションの受信者デリミタを含んでいる と
       ( す な わ ち  user+foo@domain) 、 検 索 順 序 は 次 の ようになります:
       user+foo@domain, user@domain, user+foo, user, および @domainpropagate_unmatched_extensions パラメータは、マッチしなかった拡張アドレ
       ス (+foo) が検索テーブルの結果に展開されるかどうかを制御します。

正規表現テーブル
       こ のセクションではテーブルが正規表現形式で与えられた際にどのようにテー
       ブル検索が変化するかを記述しています。正規表現検索テーブルの文法につ い
       ては、regexp_table(5) もしくは pcre_table(5) を参照してください。

       そ れぞれのパターンは検索されるアドレス全体に適用される正規表現です。従
       って、user@domain メールアドレスが user@domain という構成要素に分割
       されたり、user+foouserfoo に分割されることはありません。

       パ ターンは検索文字列にマッチするまで、テーブルに指定された順で適用され
       ます。

       アクションはインデックス化されたファイル検索と同様であり、それに加え て
       $1, $2 などをパターンのカッコで括られた部分文字列に書き換えることが可能
       です。

TCP ベースのテーブル
       この章は検索が TCP ベースのサーバに向けられたときに、テーブル検索がどの
       ように変わるかを記述しています。TCP クライアント/サーバ検索プロトコルの
       記述は tcp_table(5) を参照してください。この機能は  Postfix   バー ジョ
       ン2.3を含めたこれまでのバージョンで使えません。

       ど の検索操作も問い合わせ文字列全体を一度だけ使います。つまり、親ドメイ
       ンや親ネットワーク検索が実行することはできず、 user@domain メールアドレ
       ス が  user@domain といった構成要素に分解されたり、user+foouserfoo に分解されることはありません。

       結果はインデックス化されたファイルの検索のときと同じです。

バグ
       テーブルフォーマットは慣例的な引用符を理解しません。

設定パラメータ
       以下の main.cf パラメータは特にこのプログラムに関連があります。以下の文
       章はパラメータの概要のみを提供します。例を含む詳細は postconf(5) を参照
       してください。

       canonical_classes
              カノニカルアドレスマッピングを受けるアドレス。

       canonical_maps
              カノニカルマップテーブルのリスト。

       recipient_canonical_maps
              エンベロープとヘッダの受信者アドレス用のアドレスマッピング検索テ
              ーブル。

       sender_canonical_maps
              エンベロープとヘッダの送信者アドレス用のアドレスマッピング検索テ
              ーブル。

       propagate_unmatched_extensions
              元のアドレスから結果に拡張アドレスを展開する、アドレス書き換えや
              転送などのメカニズムのリスト。canonicalvirtualaliasfor-
              wardincludegeneric からゼロ個以上指定します。

       他の関連したパラメータ:

       inet_interfaces
              このシステムがメールを受け取るネットワークインターフェースのアド
              レ ス 。このパラメータを変更したら、Postfix を stop および start
              する必要があります。

       local_header_rewrite_clients
              これらのクライアントからのメールにあるメッセージヘッダアドレスを
              書き換え、不完全なアドレスを $myorigin または $mydomain のドメイ
              ンに更新します; その他のクライアントからのメッセージヘッダを書き
              換 え たり、不完全なアドレスを remote_header_rewrite_domain パラ
              メータで指定されているドメインに書き換えることはありません。

       proxy_interfaces
              proxy エージェントやネットワークアドレス変換を通してこのマシンが
              メールを受け取る、他のインターフェース。

       masquerade_classes
              マ ス カ レ ードを受けるアドレスクラスのリスト: envelope_sender,
              envelope_recipient, header_sender, header_recipient の 0 もし く
              はそれ以上。

       masquerade_domains
              サブドメイン構造を隠すドメインのリスト。

       masquerade_exceptions
              アドレスマスカレードを行なわないユーザ名のリスト。

       mydestination
              このメールシステムがローカルだとみなすドメインのリスト。

       myorigin
              ローカルで送信されたメールに追加されるドメイン。

       owner_request_special
              owner-xxxxxx-request アドレスを特別扱いします。

       remote_header_rewrite_domain
              こ の パラメータが空の場合、リモートクライアントからのメッセージ
              ヘッダを一切書き換えません; それ以外の場合、メッセージヘッダを書
              き換えて、不完全なアドレスに指定されたドメインを追加します。

関連項目
       cleanup(8), メールのカノニカル化およびキュー投入
       postmap(1), マッピングテーブルの作成
       postconf(5), 設定パラメータ
       virtual(5) バーチャルエイリアシング

README ファイル
       DATABASE_README, Postfix 検索テーブルの概要
       ADDRESS_REWRITING_README, アドレス書き換えのガイド

ライセンス
       The Secure Mailer license はこのソフトウェアと一緒に配布されなければ い
       けません。

作者
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA



                                                                  CANONICAL(5)