POSTMAP(1) POSTMAP(1) 名前 postmap - Postfix 検索テーブル管理 書式 postmap [-Nfinoprvw] [-c config_dir] [-d key] [-q key] [file_type:]file_name ... 解説 postmap コマンドは1つもしくはそれ以上の Postfix 検索テーブルを作成した り問い合わせたり、存在するものを更新します。入力や出力ファイル形式は 次 のものと互換の形式が求められます: makemap file_type file_name < file_name 結 果のファイルが存在しなければ、元となるファイルと同じグループと other の read パーミションで作られます。 テーブルの更新中は、シグナル配送は遅延され、検索に来たプログラムを驚 か せないために、排他的 Advisory ロックがテーブル全体にかけられます。 入力ファイルの書式 検索テーブルの入力ファイルの書式は次の通りです: o テーブルのエントリは次の形式です。 key whitespace value o 空 行および空白だけの行は無視され、最初の非空白文字が `#' の行も 同様です。 o 論理行は非空白文字で始まる行です。空白で始まる行は論理行を継続し ます。 key と value は周りの空白が取り除かれることを除いて、そのまま処理されま す。Postfix のエイリアスデータベースと異なって、 `#' や空白のような特殊 文 字 を含む検索キーを保護するためには引用符を使うことができません。key は大文字・小文字を区別せずにマップを検索するために、小文字にマップさ れ ます。 コマンドライン引数 -c config_dir デフォルトの設定ディレクトリの代わりに、指定されたディレクトリの main.cf 設定ファイルを読みます。 -d key 指定されたマップから key を検索し、マップ毎に一つのエントリを 削 除 します。要求された情報が見つかると、終了ステータスは 0 になり ます。 - のキーの値が指定されると、プログラムは標準入力ストリームから値 を読みます。少なくとも一つの要求されたキーが見つかると、終了ステ ータスは 0 になります。 -f マップの作成時や検索時に検索キーを小文字にしません。 -i 増加モード。標準入力からエントリを読み込み、存在するデータベース は 削除しません。デフォルトでは、postmap は file_name のエントリ から新しいデータベースを構築します。 -N 検索キーや値の終わりのヌル文字を含みます。デフォルトでは、 Post- fix はホストのオペレーティングシステムのデフォルトと同じようにし ます。 -n 検索キーや値の終わりのヌル文字を含みません。デフォル ト で は 、 Postfix はホストのオペレーティングシステムのデフォルトと同じよう にします。 -o non-root な入力ファイルを処理する際に、root 権限で処理します。デ フォルトでは、postalias はルート権限を落とし、代わりに元となるフ ァイルの所有者として実行します。 -p 新しいファイルを作る際に、入力ファイルからファイルのアクセス権限 を継承しません。かわりに新しいファイルをデフォルトのアクセス権限 (モード 0644) で作成します。 -q key 指定されたマップから key を検索し、最初に見つかった値を標準出 力 に 書 き出します。要求された情報が見つかると、終了ステータスは 0 になります。 キーの値として - が指定されると、プログラムは標準入力ストリー ム か ら値を読み込み、見つかったキーそれぞれに対して key: value を1 行ずつ書き出します。少なくとも一つの要求されたキーが見つかると、 終了ステータスは 0 になります。 -r テーブルの更新時に、重複したエントリを警告しません; 静かにそれを 置き換えます。 -v デバッグ目的で冗長モードを使用します。複数の -v オプションを指定 すると、ソフトウェアの冗長度が増します。 -w テーブルの更新時に、重複したエントリを警告しません; 静かにそれを 置き換えます。 引数: file_type データベースの種類。サポートされている種類を知るには 、"postconf -m" コマンドを使ってください。 postmap コマンドはサポートされているどのファイル形式でも問い合わ せることができますが、以下のファイル形式しか作成することができま せん: btree 出力は file_name.db という名前の btreeファイルです。これ は db データベースをサポートしているシステムのみで使え ま す。 dbm 出力は file_name.pag と file_name.dir という名前の 2つの ファイルから構成されます。これは dbm データベースをサポー トしているシステムのみで使えます。 hash 出力は file_name.db という名前のハッシュファイルです。こ れは db データベースをサポートしているシステムのみで使 え ます。 イ ンストールされた Postfix がサポートできるデータベースの形式を 見つけるには、postconf -m コマンドを使ってください。 file_type が指定されないと、ソフトウェアは default_database_type 設定パラメータで指定されたデータベース形式を使います。 file_name データベース再構築時の検索テーブルの元となるファイルの名前。 診断 問 題は標準エラーストリームと syslogd(8) にログとして記録されます。出力 がなければ問題がなかったことを示します。重複エントリはスキップし、フ ラ グを立てて警告します。 postmap は(postmap -q 検索の成功も含めて)実行に成功すると終了ステータス 0 で終わり、失敗すると 0 以外の終了ステータスで終わります。 環境変数 MAIL_CONFIG Postfix 設定ファイルのディレクトリ。 MAIL_VERBOSE デバッグ目的の冗長ログモードを有効にします。 設定パラメータ 以下の main.cf パラメータは特にこのプログラムに関連があります。以下の文 章はパラメータの概要のみを提供します。例を含む詳細は postconf(5) を参照 してください。 berkeley_db_create_buffer_size (1677721k) Berkeley DB hash もしくは btree テーブルを作成するプログラムのた めの、テーブルごとの I/O バッファサイズ。 berkeley_db_read_buffer_size (131072) Berkeley DB hash もしくは btree テーブルを読み込むプログラムのた めの、テーブルごとの I/O バッファサイズ。 config_directory ('postconf -d' の出力を参照) Postfix main.cf および master.cf 設定ファイルのデフォルトの場 所 。 default_database_type ('postconf -d' の出力を参照) newaliases(1) や postalias(1)、postmap(1) コマンドで使う、デフォ ルトのデータベース形式。 syslog_facility (mail) Postfix ロギングの syslog facility 名。 syslog_name (postfix) 例えば "smtpd" が "postfix/smtpd" となるようにするために syslog レコードのプロセス名の前に付けられるメールシステムの名前。 関連項目 postalias(1), エイリアスデータベースの作成/更新/検索 postconf(1), サポートされたデータベースの種類。 postconf(5), 設定パラメータ。 README ファイル DATABASE_README, Postfix 検索テーブルの概要 ライセンス The Secure Mailer license はこのソフトウェアと一緒に配布されなければ い けません。 作者 Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA POSTMAP(1)