.\" README.POP -  -*- Indented-Text -*-
.\" Last Edited: Mon Feb 17 18:40:50 1997 by fuku (FUKUSHIMA Osamu) on psyche

POP でメイルを取得するための設定について

-----------------------------------------------------------------------
* 概要
-----------------------------------------------------------------------

この文書は、POP (Post Office Protocol) によってメイルサーバから
メイルを取得する際に必要な cmail の設定に関して解説するものです。

    * 必要な環境
    * POP アカウントの確認
    * cmail の設定
    * トラブル
    * movemail のコンパイル方法

-----------------------------------------------------------------------
* 必要な環境
-----------------------------------------------------------------------

POP 経由でメイルを取得するには、POP 対応になっている movemail が
インストールされている必要があります。

[ GNU Emacs 19.29 以降 ]

GNU Emacs 19.29 以降がベースになっている Mule では、コンパイル時
に --with-pop をつけて configure が実行されていれば、movemail は
POP に対応しています。

[ GNU Emacs 19.29 以前 ]

Mule-2.3 など、emacs-19.29 以前の GNU Emacs をベースにした環境で
は、以下の条件が必要になります。

  * メイルサーバ側が RPOP に対応している
  * movemail が -DMAIL_USE_POP をつけてコンパイルされている
  * movemail が root に setuid されている

そうでない場合は、条件に合うように環境を整えるか、あるいは
emacs-19.3x 以降のソースを入手して、それに付属する movemail をコ
ンパイル・インストールすることになります。これに関しては、別項の 
"movemail のコンパイル方法" を参照してください。

-----------------------------------------------------------------------
* POP アカウントの確認
-----------------------------------------------------------------------

メイルサーバに POP アカウントでログインできることを telnet で、
POP3 のポートにアクセスして確認します。

サーバプログラムによってメッセージが異なりますが、だいたい以下の
ような手順で確認できるはずです。

>   (example) % telnet "メイルホスト名" 110
    Trying 100.100.100.1..
    Connected to mailhost.somedomain.
    Escape character is '^]'.
    +OK QPOP (version 2.2) at mailhost.somedomain starting.
>   user fuku                   <-- あなたの POP アカウント名
    +OK Password required for fuku.
    pass XXXXXXXX               <-- POP アカウントのパスワード
>   +OK fuku has 10 messages (41420 octets).
>   quit
    (example) %

-----------------------------------------------------------------------
* cmail の設定
-----------------------------------------------------------------------

通常の cmail の設定に加えて、

  (setenv "MAILHOST" "メイルホスト名")
  (setq cmail-spool-directory "po:POPアカウント名")

を追加します。

前項にあるように movemail が適切にインストールされていれば、
cmail を起動するだけで、movemail が POP 経由でメイルサーバにアク
セスします。

ミニ・バッファでパスワードを質問されますので、入力してください。
アカウント名とパスワードが認証されると、movemail はメイルを取得
し、cmail がそれを受け取って表示します。


複数のPOPサーバにアクセスすることも出来ます。
cmail-spool-directoryにリストを指定することにより、POP経由で
複数のメイルサーバにアクセスすることができます。

リストは以下の形式で指定します。

	(setq cmail-spool-directory
	      '(("po:POPアカウント名" "メイルホスト名" "オプション" "パスワード")
	        ...))

メイルホスト名とオプションは、それぞれMAILHOST、MOVEMAILの環境変数に設定
されます。オプションが有効となるためには、ご使用のmovemailが環境変数から
オプションを取得することに対応している必要があります。

-----------------------------------------------------------------------
* トラブル
-----------------------------------------------------------------------

(Q1) メイルサーバにメイルは届いているが、cmail を起動しても取得で
    きない

(A1) いくつか原因が考えられます。

1. movemail が POP 対応になっていないケース。

       → [対策 1] movemail を POP 対応にしてインストールする 
                   ("movemail のコンパイル方法" を参照) 。

2. RPOP しか対応していない movemail (たとえば Mule-2.3 に付
   属のもの) を使っているが、root に setuid されていないケー
   ス。

       → [対策 1] movemail に setuid ビットを設定する
                   (root 管理者の権限が必要)。
       または、

       → [対策 2] emacs-19.3x 以降の movemail をインストールす
                   る (一般ユーザの権限内で可能。"movemail のコ
		   ンパイル方法" を参照) 。

3. RPOP しか対応していない movemail (たとえば Mule-2.3 に付
   属のもの) を使っているが、POP サーバプログラムが RPOP に
   対応していないケース。

       → [対策 1] emacs-19.3x 以降の movemail をインストールす
                   る (一般ユーザの権限内で可能。"movemail のコ
		   ンパイル方法" を参照) 。

いずれのケースも、emacs-19.3x 以降の movemail を、自分でインストー
ルすることによって回避可能なので、トラブルが生じた場合は、まずこ
の方法をとることを推奨します。

(Q2) 上記の対策をしたが、まだメイルを取得できない。

(A2) 古い movemail がシステムに残っていて、新しくインストールし
     た movemail が起動されていない可能性があります。which コマ
     ンドで、どの movemail が起動されたのか、確認してください。

-----------------------------------------------------------------------
* movemail のコンパイル方法
-----------------------------------------------------------------------

movemail を再コンパイルする必要がある場合の手順を簡単に解説しま
す。まず、emacs-19.3x 以降のソースを入手し、展開します。

    (example) % gzip -d < emacs-19.3x.tar.gz | tar xvf -
    (example) % cd ./emacs-19.3x

ソースを展開したディレクトリで etc/MACHINES というファイルを参照
し、お使いの OS に一致する機種名を確認した上で、

    (example) % ./configure "機種名" --with-pop

を実行します (このあと emacs 本体も作成するなら、そのためのオプ
ションも付加します)。その後、lib-src ディレクトリに移動し、

    (example) % cd ./lib-src
    (example) % make movemail

として、movemail をコンパイルしてください。コンパイルが終了した
ら、movemail という実行ファイルを、自分の $PATH の通ったディレク
トリ (たとえば $HOME/bin など) にコピーした上で、

    (example) % which movemail

として、その movemail が実行可能な状態になっていることを確認して
ください。

なお、管理者としてシステムを変更できる権限がある場合は、emacs の
exec-path にインストールしてしまってもかまいません。
