procmail

名前

書式

説明

シグナル

TERMINATE

直ちに終了し、メールをキューに戻す。

HANGUP

直ちに終了し、メールを送信元へ送り返す。

INTERRUPT

直ちに終了し、メールを送信元へ送り返す。

QUIT

直ちに終了し、ユーザには何も通知せずにメールを消去する。

ALARM

強制的に時間切れで終了させる ( TIMEOUT を参照されたい)。

USR1

VERBOSE=off と同じ意味。

USR2

VERBOSE=on と同じ意味。

 

オプション

-v

バージョン番号とコンパイル時の環境設定を表示して終了する。

-p

古い環境をすべて保存する。 procmail は通常、起動時に TZ を除くすべての環境変数の値を消去する。 但し、どのような場合においても: procmail が内包するあらゆるデフォルト値は同一名の既存の環境変数より優先される。 すなわち、 procmail は既に定義されている同名の環境変数には全くお構いなく、 procmail のデフォルト値にてそれらを適切に上書きする。 procmail で予め設定されている環境変数の一覧については、 procmailrc(5) を参照のこと。 -p と -m が両方指定されている場合は、予め設定する環境変数は LOGNAME、HOME、SHELL、ORGMAIL および MAILDIR だけに限定される。 (訳注: procmail の通常動作は、 TZ 以外の親プロセスの環境変数を全削除すると共に、自身の動作にかかわる環境変数を多数「上書き」設定する。 -p オプションが指定されると、 procmail は自身の動作にかかわる5つの環境変数のみを設定し、それ以外の親プロセスにて設定されている環境変数を削除しない。結果として親プロセスの環境が保持される。)

-t

procmail をフェールソフトにする。 つまり、ユーザが指定したどの配送先にも procmail がメールを配送できない場合、 メールはバウンスせず (配送エラーメールとして送り返されず) メールキューに戻る。 その後しばらくしてから再度配送を試みる。

-f fromwhom

fromwhom を送信者(sender)にして、先頭の `From ' 行を再作成する (-f の代わりに、今では使われなくなっているが -r が使用できる)。 fromwhom が `-' 1個だけの場合、procmail は `From ' 行のタイムスタンプの 更新のみ行う (これはタイムスタンプが存在する場合である。なければ新たに作成する)。

-o

誰にも `From ' 行の生成を許可させないで、単に偽物を上書きする。

-Y

従来の Berkeley mailbox フォーマットを想定し、 Content-Length: フィールドはすべて無視する。

-a 引数

このオプションは、 $1 にコマンドライン引数を設定する。 後続する -a 引数 はそれぞれ次の番号の変数 ($2、$3、他) に設定される。 このオプションで procmail にメタ情報を渡すことができる。 通常、sendmail メーラルールから $@x 情報を渡すことに用いられる。

-d recipient ...

これは明示的な配送モードを有効にする。 配送はローカルユーザ recipient へ行われる。 もちろん、これは procmail が root 権限を備える場合 (或は procmail が 受取人の euid 及び egid で動作している場合) にのみ可能である。 procmail は指定された受取人に setuid され、 受取人により引数のない状態で起動されたかのようにメールを配送する。 (すなわち、 rcfile が見つからない場合、配送は通常のメールのように 行われる)。 このオプションは -p とは互換性がない。

-m

procmail を汎用のメールフィルタにする。 このモードでは rcfile をコマンドラインで一つ指定しなければならない。 rcfile に後続する引数に制限はない。 rcfile が後方参照のない /etc/procmailrcs/ で始まる絶対パスである (すなわち、親ディレクトリが指定できない) 場合、 セキュリティの侵害がない場合のみ procmailは rcfile (またはシンボリックリンク) の所有者のユーザ属性になる。 このオプションのより詳細な使用法は下記の 例 を参照されたい。 引数に `=' が入っている場合は、すべて環境変数への値の割り当てと見なす。 デフォルト値が割り当てられた後に、この割り当てがI<全て>評価され、 その後に最初の rcfile がオープンされる。

例

Mprocmail, P=/usr/bin/procmail, F=mSDFMhun, S=11, R=21,
        A=procmail -m $h $g $u

R$*<@some.where>$*
        $#procmail $@/etc/procmailrcs/some.rc $:[email protected]$2
R$*<@$*.procmail>$*
        $1<@$2>$3       Already filtered, map back

SENDER = "<$1>" # 空の送信者アドレスを修正 SHIFT = 1 # $@ から除去

:0 # 全てのゴミメールを放り込む * ^Subject:.*junk /dev/null

:0 w # それ以外の全てのメールを通過させる ! -oi -f "$SENDER" "$@"

ファイル

/etc/passwd

受取人の LOGNAME, HOME, SHELL の各変数のデフォルトを設定する。

/var/spool/mail/$LOGNAME

システムメールボックス; システムメールボックスとそれを格納するすぐ上のディレクトリが存在しなければ、 両方とも procmail が起動する度毎に作成される。

/etc/procmailrc

初期のグローバル rcfile

/etc/procmailrcs/

rcfile に特権を与えるパス

$HOME/.procmailrc

デフォルトの rcfile

/var/spool/mail/$LOGNAME.lock

システムメールボックスのlockfile (procmail が自動的に使用することはない。 但し、変数 $DEFAULT が /var/spool/mail/$LOGNAME と等しく、且つ procmail が $DEFAULT へ配送する場合を除く。)

/usr/sbin/sendmail

デフォルトのメール転送ソフト

_????`hostname`

procmail が一時的に作成する、大きさが 0 バイトで `ファイル名が重複しない' ファイル

 

関連項目

診断 (エラーメッセージ一覧)

Autoforwarding mailbox found (自動転送メールボックスが見つかった)

システムメールボックスに suid または sgid ビットがセットされている場合、 procmail は当該メールボックスへ配送してはいけないことを示すべく、 EX_NOUSER で 終了する。

Bad substitution of "x" ("x" の不正な置換)

有効な環境変数名が指定されていない。

Closing brace unexpected (閉じ括弧が検出されない)

開き括弧に対応する閉じ括弧がない(ブロックがネストしている)。

Conflicting options (オプションが矛盾する)

有効な組み合わせになっていないオプションがある。

Conflicting x suppressed (矛盾する x は削除された)

フラグ x は当該レシピの他のフラグと併存できない。

Couldn't create "x" ("x" を作成できない)

システムメールボックスが見つからず、作成できない。または作成されない。

Couldn't create maildir part "x" (maildir "x" を作成できない)

maildir フォルダ "x" の作成に必要な1つまたは複数のサブディレクトリが なく、また procmail はそのサブディレクトリを作成できない。

Couldn't create or rename temp file "x" (一時ファイル "x" の作成または名前変更ができない)

ディレクトリフォルダ "x" への配送の仕組みにエラーが発生した。

Couldn't determine implicit lockfile from "x" ("x" から暗黙の lockfile が決定できない)

リダイレクタ `>>' がないので、単純に `$LOCKEXT' をローカルロックファイルのファイル名として使用する。

Couldn't read "x" ("x" が読めない)

procmail が rcfile を開くことができなかったか、 rcfile が通常のファイルでなかったか、 或は procmail が最大番号のファイル名のファイルを探そうとしても MH ディレクトリを開くことができなかった。

Couldn't unlock "x" ("x" のロックが解除できない)

ロックファイルが既に消滅しているか、またはロックファイルがあるディレクトリの書き込み 権限がない。

Deadlock attempted on "x" ("x" のデッドロック未遂)

当該レシピで指定されているローカルロックファイルは、 まだ有効に機能し続けている $LOCKFILE と同じである。

Denying special privileges for "x" ("x" への特別な権限を拒否)

セキュリティ侵害が見つかった (例: -p オプションまたはコマンドラインの変数割り当て)か、 procmail が不十分な権限しか持っていないので、 procmail は rcfile に付随する識別情報 (ユーザ ID 及びグループ ID) にならない。 (訳注: rcfile のユーザ ID とグループ ID に setuid / setgid しない。 setuid / setgid に関するセキュリティ上の問題に対応するエラーメッセージ。)

Descriptor "x" was not open (ファイル記述子 "x" を開けられなかった)

procmail は起動したが、 stdin, stdout または stderr と接続されなかった。 (おそらくセキュリティが破壊されそうになったためであろう。)

Enforcing stricter permissions on "x" ("x" のパーミッションをより厳しくする)

受取人のシステムメールボックスが安全でないことがわかったので、 安全性を向上させた。

Error while writing to "x" ("x" へ書き込みをする際にエラーが発生した)

サブディレクトリが存在しないか、書き込み許可がないか、パイプが壊れてしまったか、 またはディスクが一杯である。

Exceeded LINEBUF (LINEBUF 超過)

バッファオーバーフローが検出された。LINEBUF が小さすぎる。 PROCMAIL_OVERFLOW が設定された。

MAILDIR is not an absolute path (MAILDIR が絶対パスでない。)

MAILDIR path too long (MAILDIR パスが長すぎる。)

ORGMAIL is not an absolute path (ORGMAIL が絶対パスでない。)

ORGMAIL path too long (ORGMAIL パスが長すぎる。)

default rcfile is not an absolute path (デフォルトの rcfile が絶対パスでない。)

default rcfile path too long (デフォルトの rcfile へのパスが長すぎる。)

指定された項目のフルパスは、展開すると LINEBUF よりも長かったか、或は そのフルパスの先頭がファイルセパレータではなかった。

Excessive output quenched from "x" ("x" からの過剰な出力が抑止された)

プログラムまたはフィルタ "x" の出力が procmail の LINEBUF のサイズを越えたので、 溢れた残りの分は破棄され、 PROCMAIL_OVERFLOW がセットされた。

Extraneous x ignored (無関係な x は無視された)

このレシピで使用しているアクション行、または他のフラグがあるので、 フラグ x は無意味になる。

Failed forking "x" ( "x" の fork に失敗した)

プロセステーブルが一杯である (と共に NORESRETRY が使い尽くされた)。

Failed to execute "x" ("x" の実行に失敗した)

プログラムがパスにないか、実行可能ではない。

Forced unlock denied on "x" ("x" へのアンロックの強行に失敗した)

ロックファイル "x" が存在するディレクトリに書き込み許可がないか、または複数の procmail が全く同時にロックを強行しようとしている。

Forcing lock on "x" ("x" のロックを強行する)

タイムアウトしたため、 ロックファイル "x" は強制的に削除される。 ( LOCKTIMEOUT も合わせて参照されたい)

Incomplete recipe (不完全なレシピ)

レシピの開始は見つかったが、レシピの終了が見つからないまま EOF で行き詰まってしまった。

Insufficient privileges (不十分な権限)

procmail が配送モードで動作するには、procmail に root 権限が 必要であるか、 procmail の (e)uid および (e)gid が正しいものでなければならない。メールはバウンスする。

Invalid regexp "x" (無効な正規表現 "x")

正規表現 "x" にはエラーがある (多くの場合、括弧が不足していたり余計だったりする)。

Kernel-lock failed (カーネルロックが失敗した)

カーネルがサポートするロック機能を試みている間に、 それら機能呼び出しのうちの1つが失敗した (通常 OS エラーを示す)。 procmail はこのエラーを無視し、処理を続行する。

Kernel-unlock failed (カーネルアンロックが失敗した)

上記説明を参照。

Lock failure on "x" ("x" のロック失敗)

このエラーは、適切でない (そして不正な) ロックファイル名を指定しているか、 または権限が不足していたり存在しないサブディレクトリを指定したために ロックファイル が作成できなかった場合にのみ生じる。

Lost "x" ("x" が消失した)

procmail は自身のクローンを作ろうとしたが、 rcfile "x" が 見つからなかった (その rcfile が削除されたか、或は rcfile が相対パスで指定されていて、 前回 procmail がその rcfile を開いてからディレクトリを変更したかのいずれかである)。

Missing action (動作の不足)

現在のレシピが不完全であることがわかった。

Missing closing brace (閉じ括弧不足)

ネストしているブロックの開始はあるが終了が無い。

Missing name (名前の不足)

-f オプションには特別な引数が必要である。

Missing argument (引数の不足)

-a オプションが指定されたが、引数が忘れられている。

Missing rcfile (rcfile がない)

-m オプションが指定されているが、 -m オプションは引数として rcfile 名が必要である。

Missing recipient (受取人がない)

-d オプションを指定したか、または別の名前で procmail が呼び出された。 その際、引数として 1つ以上の受取人が必要である。

No space left to finish writing "x" ("x" の書き込みを終了させるだけの容量がない)

"x" を含むファイルシステムに、配送メッセージをファイルに書き込むだけの十分な空き容量がない。

Out of memory (メモリ不足)

システムにスワップスペースが不足している (そして NORESRETRY が使い尽くされた)。

Processing continued (処理が続行されている)

コマンドラインで認識されないオプションは無視され、そのまま処理を続行する。

Program failure (nnn) of "x" (プログラム "x" が失敗した (nnn))

procmail から起動されたプログラムが、EXIT_SUCCESS (=0) ではなく nnn を返した; nnn が負なら、そのプログラムが死んだことを示すシグナルである。

Quota exceeded while writing "x" ("x" の書き込み中にディスクの割当量を超過した)

"x" を含むそのファイルシステムにおける、受取人に対するファイルサイズの制限の為に、 メッセージをファイルへ配送することが許されない。

Renaming bogus "x" into "x" (間違っている名前 "x" を "x" に変更する)

受取人のシステムメールボックスが誤りだったので、 procmail は回避動作を行った。

Rescue of unfiltered data succeeded/failed (フィルタされていないデータの救出に

成功した / 失敗した) (procmail から起動した) フィルタの実行に失敗したので、procmail はメールをフィルタに渡す以前のテキストに戻そうとした。

Skipped: "x" ("x" はスキップされた)

rcfile の "x" については (文法エラーに因り) 何も行われず無視された。

Suspicious rcfile "x" (rcfile "x" は疑わしい)

rcfile の所有者が受取人もしくは root のいずれでもないか、 rcfile 自体またはこれが存在するディレクトリが誰でも書き込み可能になっているか、 この rcfile がデフォルトの rcfile ($HOME/.procmailrc) である場合はそのファイル自体または ファイルを含むディレクトリがグループ書き込み可能である (group writable) かのいずれかであった。 (したがって rcfile は使われなかった)

Terminating prematurely whilst waiting for ... (... を待っている間の中途終了)

procmail は .. を待っている間にシグナルを受信した。

Timeout, terminating "x" (時間切れ: "x" の終了)

プログラムまたはフィルタ "x" は実行中に時間切れとなった。

Timeout, was waiting for "x" ("x" を待っていたが時間切れになった)

プログラム或はフィルタの実行中、またはファイル "x" の処理中に時間切れとなった。 "x" がプログラムまたはフィルタの場合、もはや動作していないように見えた。

Truncated file to former size (ファイルを元のサイズに切り詰めた)

ファイルの配送が成功しなかったので、そのファイルは元のサイズに切り詰められた。

Truncating "x" and retrying lock ("x" の切り詰めとロックの再試行)

"x" は有効なファイル名ではないか。またはファイルが空ではない。

Unable to treat as directory "x" ("x" をディレクトリとして扱えない)

"x" の末尾が MH または maildir フォルダであることを示しているか、 或はそれらのいずれかへリンクされている二番目のフォルダとして記述されていたが、 "x" は既に存在していて、且つディレクトリではない。 (訳注: メールボックス名の末尾が "/" で終る場合は maildir として、 "/." で終る場合は MH として扱われる。詳細は procmailrc (5) を参照。)

Unexpected EOL (予期しない EOL)

引用符を閉じ忘れているか、 EOF の回避をし忘れている。 (訳注: 原文及びソース中のエラーメッセージには EOL (End Of Line: 行末) と書かれているが、ソースを参酌すると EOF (End Of File: ファイル終端) の間違いと推測する。)

Unknown user "x" (未知のユーザ "x")

指定された受取人に対応する uid がない。

 

拡張診断

[pid] time & date

procmail の pid とタイムスタンプである。 procmail が診断をログ記録する時にはいつでも生成され、 少なくとも最後のタイムスタンプから1秒は経過している。

Acquiring kernel-lock (カーネルロックの獲得)

procmail は、直前に開いたファイル (記述子) をカーネルロックしようとしている。

Assigning "x" ("x" の割り当て)

環境変数割り当て。

Assuming identity of the recipient, VERBOSE=off (受取人のユーザ属性を想定する。VERBOSE=off)

特権があればそれらをすべて破棄し、拡張診断機能を自動的に無効にする。

Bypassed locking "x" ("x" のロック回避)

procmail はメールスプールディレクトリへアクセスできなかったので、カーネルのロック機能しかあてにならなかった。

Executing "x" ("x" の実行)

プログラム "x" を起動する。 シェルを介在させずに procmail から直接 "x" を起動する場合、 procmail は引数と引数の間にカンマを挿入して引数の区切りを示す。

HOST mismatched "x" (このホストのホスト名は "x" と一致しない)

このホストのホスト名を "x" と認識した。 HOST には何か余計なものが含まれていた。 (訳注: ホスト名の検証結果に関するメッセージ。)

Locking "x" ("x" をロックする)

ロックファイル "x" を作成する。

Linking to "x" ("x" にリンクする)

ディレクトリフォルダ間にハードリンクを作成する。

Match on "x" ("x" で一致する)

条件が一致した。

Matched "x" (一致した "x")

"x" が MATCH に 割り当てられた。

No match on "x" ("x" には何も一致しない)

条件が一致せず、レシピは読み飛ばされた。

Non-zero exitcode (nnn) by "x" ("x" は 0 以外の終了コード (nnn) で終了した)

レシピの条件文として、或は `W' フラグのを用いるアクション行として procmail から起動されたプログラムは、 EXIT_SUCCESS (=0) ではない終了コード nnn を返して終了した。 この使い方は全く予期しない状態ではないことを示す。 (訳注: すなわち、プログラムの終了コードを条件分岐に用いるレシピにおいては、このメッセージが出ても必ずしも何らかの異常を示すものではない。)

Notified comsat: "$LOGNAME@offset:file" (comsat の通知: "$LOGNAME@offset:file")

`file' の `offset' の位置に、ユーザ $LOGNAME 宛てのメールが 到着したと、comsat/biff へ通知した。 (訳注: biff はメールの到着を通知するユーティリティ。 comsat は biff サーバ。各々 biff.1 及び comsat.1 を参照。)

Opening "x" ("x" を開いている)

Opening "x" ("x" のオープン) 追加のためにファイル "x" を開く (訳注: append mode: 追加モード)

Rcfile: "x"

rcfile は "x" に変更された。

Reiterating kernel-lock (カーネルロックの繰り返し)

いくつかのロック方式を試行している最中に、そのうちの一つが失敗した。 その試行のすべてが間をおかず連続して成功するまで、 procmail はカーネルロックを繰り返す。

Score: added newtotal "x" (スコア: 追加の結果、新しい合計値は "x" となった)

この条件によってスコアに点が追加された。 スコアは `新しい合計値' になった。

Unlocking "x" ("x" のロック解除)

ロックファイル "x" を再び削除する。

 

警告

バグ

その他

`\nFrom '

$LOGNAME@offset_of_message_in_mailbox :absolute_path_to_mailbox

備考

send usenet/news.answers/mail/filtering-faq

" |exec /usr/bin/procmail"

#!/bin/sh

ORGMAIL=/var/spool/mail/$LOGNAME

if cd $HOME &&
 test -s $ORGMAIL &&
 lockfile -r0 -l1024 .newmail.lock 2>/dev/null
then
  trap "rm -f .newmail.lock" 1 2 3 13 15
  umask 077
  lockfile -l1024 -ml
  cat $ORGMAIL >>.newmail &&
   cat /dev/null >$ORGMAIL
  lockfile -mu
  formail -s procmail <.newmail &&
   rm -f .newmail
  rm -f .newmail.lock
fi
exit 0

$HOME/.procmailrc のちょっとしたサンプル:

PATH=/usr/local/bin:/usr/bin:/bin
MAILDIR=$HOME/Mail      #you'd better make sure it exists
DEFAULT=$MAILDIR/mbox   #completely optional
LOGFILE=$MAILDIR/from   #recommended

:0:
* ^From.*berg
from_me

:0
* ^Subject:.*Flame
/dev/null

SOURCE

MAILINGLIST

<[email protected]>

質問/回答の投稿用アドレス。

参加申込用のアドレス。

[email protected]

著者

<[email protected]>

<[email protected]>