pbs4qについて

English page

pbs4qとは

　pbs4q は、 qmail で POP before SMTP を行なうためのソフトです。名前の由来は、 POP before SMTP for qmail です。
　特徴は、以下の通りです。

小さいプログラムです
qmail への patch が不要です
使い方が簡単です
中継を許可する接続元からの使用であれば、多くなっても負荷がかかりません

　使用方法は簡単で、展開して make; make install を行ない、 qmail の qmail-smtpd や qmail-popup を呼び出すためのスクリプトに pbs4q を挟み込むだけです。

ダウンロード(5728byte)
version 0.2.1 updated on 2002/07/05

ダウンロード(5642byte)
version 0.2.0 updated on 2002/02/04

"pbs4q"(ver. 0.2.0) を CourierIMAPD と組み合わせて動作させるには
 patch: pbs4q-0.2.0-ipv6.patch
ちはる氏御提供

ダウンロード(5440byte)
version 0.1.0 updated on 31 Dec 2001

ダウンロード(4846byte)
version 0.0.4 updated on 28 Jul 2000

注意

　pbs4q を利用する際に、設定を間違えると、認証に失敗しても接続元の IP が保存されてしまうということがあります。 pbs4q1 が呼び出されるのは、必ず認証に成功した後になるようにご注意ください。

　qmail-smtpd と pbs4q_su の動作ユーザID が異なってしまった結果、 POP before SMTP が正常に動作しないということがあるようです。その原因としては、

qmail-smtpd の動作ユーザIDが qmaild では無かったり、
id -u qmaild というコマンドの STDOUT への出力結果によって qmaild の動作ユーザID を取得することが出来なかったり

したということが考えられます。こういった場合、

Makefile の 5行目の 'id -u qmaild' の部分を qmail-smtpd の実行ユーザ ID に書き換え、
Makefile の 70,73,83,89行目の qmaild の部分を qmail-smtpd の実行ユーザ ID に書き換え、

そのあと、 make; su; make install をやり直して下さい。時間が取れ次第、こういうトラブルを起こりにくくするように Makefile を書き換え、新しいバージョンをリリースしようと思います。

---以下の記述は、"pbs4q-0.2.1" に関するものです。 "pbs4q-0.0.x", "pbs4q-0.1.x" , "pbs4q-0.2.0" では違う点があります。---

インストールされるファイル

　pbs4q1, pbs4q2, pbs4q2_smtp, pbs4q_su, pbs4qclean_su の5つです。 pbs4q_su, pbs4qclean_su は、持ち主が qmaild としてインストールされ、 setuid されます。

インストール方法

まずはじめに、 qmail と tcpserver がインストールされていることを確認してください。
pbs4qをダウンロードします。現在のバージョンは、 0.2.1 です。
ファイルを展開します。
```
gzip -dc pbs4q-0.2.1.tar.gz | tar xvf -
```
ソースコードをコンパイルしてインストールします。

cd pbs4q 
vi Makefile
make ; make install

qmail で qmail-smtpd や qmail-popup を呼び出す部分のスクリプトを編集します。
POP3:

/usr/local/bin/tcpserver -c 40 -u 0 -g 0 \
  -x /var/qmail/control/tcprules.cdb \    ← 追加(SMTPのものと同じにする)
/var/qmail/bin/qmail-popup \
  YOUR_HOST'S_NAME \
/bin/checkpassword \
/usr/local/bin/pbs4q1 \                  ← 追加
/var/qmail/bin/qmail-pop3d Maildir &

SMTP:

/usr/local/bin/tcpserver \
  -c 40 -u ID_NO_OF_qmail_USER -g ID_NO_OF_nofiles_GROUP \
  -x /var/qmail/control/tcprules.cdb \
  YOUR_HOST'S_NAME smtp \
/usr/local/bin/pbs4q2_smtp \                  ← 追加
/var/qmail/bin/qmail-smtpd &

FTP:

　FTP daemon を呼び出すスクリプト中の "/usr/sbin/in.ftpd" と
書いてある部分を "/usr/local/bin/pbs4q2 /usr/sbin/in.ftpd"
に書き換える。
　但し、 pbs4q は、 tcpserver が設定する 'TCPREMOTEIP' と
いう環境変数に依存しますので、 FTP daemon の呼び出しに 
tcpserver を設定する必要があります。

もし、あなたのシステムに /etc/cron.hourly があれば、そこにリンクができますが、そうではない場合、 /usr/local/bin/pbs4qclean_su が定期的に実行されるように crontab を編集してください。
```
$ crontab -e
(以下のような行を追加してください。)
# run pbs4qclean_su every hour 
0 * * * *       /usr/local/bin/pbs4qclean_su
```

各々のファイルの働き

pbs4q1:
　* 環境変数: RELAYCLIENT があるかを調べます。
　　* 無かった場合だけ、 pbs4q_su を呼び出し、接続元の IP を保存します。
　* 引数として与えられたプログラムを実行します。
　* そのプログラムが終了するのを待ちます。

pbs4q2:
　* まず、環境変数: RELAYCLIENT があるかを調べます。
　　* 無ければ、同じ IP からの POP/APOP/IMAP への接続が30分以内にあったかを調べます。
　　　* 無ければ終了します。（引数として与えられたプログラムは実行しません。）
　* 引数として与えられたプログラムを実行して終了します。

pbs4q2_smtp:
　* まず、環境変数: RELAYCLIENT があるかを調べます。
　　* 無ければ、同じ IP からの POP/APOP/IMAP への接続が30分以内にあったかを調べます。
　　　* あれば環境変数に RELAYCLIENT="" を追加します。
　* 引数として与えられたプログラムを実行して終了します。

pbs4q_su: (owner: qmaild, mode: 4755)
　qmaild の権限で動作し、接続元 IP を名前とするファイルを
/var/pbs4q/ip/ に作り、その中に、時刻を保存します。

pbs4qclean_su: (owner: qmaild, mode: 4755)
　qmaild の権限で動作し、 /var/pbs4q/ip/ に保存されているファイルのう
ち、現時点より30分以上古い時刻を保存しているものを削除します。

変更履歴

ver. 0.2.0 -> 0.2.1

メール受信時の動作の順を、
＊　pbs4q呼び出し→POP/APOP/IMAP呼び出し→終了後 IP 保存
から
＊　pbs4q 呼び出し→IP 保存→POP/APOP/IMAP呼び出し
に変更した。その理由は、これまでの仕様では、以下の条件が成り立つ場合にクライアントがメールを送信することが出来ないので、これに対処するため。
＊クライアントがメールの受信を終了してから送信を開始するまでの時間が短い。
＊サーバで、POP の終了の信号(QUIT)を受けてから pop 用のプログラムが終了するまでにかかる時間が長い。
＊クライアントが一度メールの送受信を行うたびに、その IP address が変化する。
参照：http://www.rimarts.com/ml/becky-ml/14700/14701.html

ver. 0.1.x -> 0.2.0

POP before SMTP のみならず POP/IMAP/etc...(*1) before SMTP/FTP/TELNET/etc... (*2) を実現
* pbs4q を pbs4q1 (*1 用) と pbs4q2_smtp (SMTP用) と pbs4q2(*2 用)に分けました。

ver. 0.0.x -> 0.1.x

メール受信時の動作の順を、
＊　pbs4q呼び出し→IP 保存→POP/APOP/IMAP呼び出し
から
＊　pbs4q呼び出し→POP/APOP/IMAP呼び出し→終了後 IP 保存
に変更した。これにより、メールの受信に30分以上かかった場合も新たにメールを受信しなおすことなく POP before SMTP がメール受信終了後30分間有効になります。
file lock を使用しなくなった。そのかわり、 data の一意性は、 file system への書き込み時に、
＊　まず、unique な name で temporary file を作って書き込み、
＊　それが終わった時点でファイル名を必要に応じたものに変更する
という手順を踏むことで維持するようにしました。
pbs4q 本体が他のプログラムを呼び出した場合、そのプログラムが終了するのを wait(NULL) するようにしたことで、 zombi の発生を無くした。
syslog の level が一部間違っていたので訂正しました。

質問、御意見など

ログがエラーっぽい … すみません。
ログで、中継したのか弾いたのかの区別が付かない … qmail が出したログを御覧下さい。
ログに残すメッセージを選べるようにして欲しい … そのうちにその機能を追加します。
名前がいまいち … すいません。

return

written by YAKAMI Masahiro.
e-mail: masahiro@mambo.kuhp.kyoto-u.ac.jp