POSTMAP(1) POSTMAP(1)
名前
postmap - Postfix 検索テーブル管理
書式
postmap [-Nfinorvw] [-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 は大文字・小文字を
区別せずにマップを検索するために、小文字にマップされます。
オプション:
-N 検索キーや値の終わりのヌル文字を含みます。デフォ ル
トでは、 Postfix はホストのオペレーティングシステム
のデフォルトと同じようにします。
-c config_dir
デフォルトの設定ディレクトリの代わりに、指定され た
ディレクトリの main.cf 設定ファイルを読みます。
-d key 指定されたマップから key を検索し、マップ毎に一つの
エントリを削除します。要求された情報が見つかる と、
終了ステータスは 0 になります。
- のキーの値が指定されると、プログラムは標準入力ス
トリームから値を読みます。少なくとも一つの要求さ れ
たキーが見つかると、終了ステータスは 0 になります。
-f マップの作成時や検索時に検索キーを小文字に し ま せ
ん。
-i 増加モード。標準入力からエントリを読み込み、存在す
るデータベースは削除 し ま せ ん。 デ フォ ル ト で
は、postmap は file_name のエントリから新しいデータ
ベースを構築します。
-n 検索キーや値の終わりのヌル文字を含みません。デ フォ
ルトでは、 Postfix はホストのオペレーティングシステ
ムのデフォルトと同じようにします。
-o non-root な入力ファイルを処理する際に、root 権限 で
処 理します。デフォルトでは、postalias はルート権限
を落とし、代わりに元となるファイルの所有者として 実
行します。
-q key 指定されたマップから key を検索し、最初に見つかった
値を標準出力に書き出します。要求された情報が見つ か
ると、終了ステータスは 0 になります。
キーの値として - が指定されると、プログラムは標準入
力ストリームから値を読み込み、見つかったキーそれ ぞ
れに対して key: value を1行ずつ書き出します。少なく
とも一つの要求されたキーが見つかると、終了ステー タ
スは 0 になります。
-r テーブルの更新時に、重複したエントリを警告しません;
静かにそれを置き換えます。
-v デバッグ目的で冗長モードを使用します。複数の -v オ
プ ションを指定すると、ソフトウェアの冗長度が増しま
す。
-w テーブルの更新時に、重複したエントリを警告しません;
静かにそれを置き換えます。
引数:
file_type
生成するデータベースの種類。
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
データベース再構築時の検索テーブルの元となるファ イ
ルの名前。
診断
問題は標準エラーストリームに記録されます。出力がなければ問
題がなかったことを示します。重複エントリはスキップし、フラ
グを立てて警告します。
postmap は(postmap -q 検索の成功も含めて)実行に成功すると
終了ステータス 0 で終わり、失敗すると 0 以外の終了ステータ
スで終わります。
環境変数
MAIL_CONFIG
Postfix 設定ファイルのディレクトリ。
MAIL_VERBOSE
デバッグ目的の冗長ログを使用する。
設定パラメータ
default_database_type
出力データベースのタイプのデフォルト。多くの UNIXシ
ステムでは、デフォルトタイプは hash または dbm のど
ちらかです。 or dbm.
berkeley_db_create_buffer_size
Berkeley DB hash または btree 検索テーブルを作成す
る際に使われるバッファメモリの量。
berkeley_db_read_buffer_size
Berkeley DB hash または btree 検索テーブルを読み 込
む際に使われるバッファメモリの量。
ライセンス
The Secure Mailer license はこのソフトウェアと一緒に配布さ
れなければいけません。
作者
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
POSTMAP(1)