                                                        -*- Indented-text -*-
# CML Documents.
# Copyright 1993-2004 (C) SAITO Yasuhiro.
# All rights reserved.

はじめに
========

*この文書の目的を教えてください。


CMLについて
===========

*CMLってなんですか？
*CMLの著作者は誰？
*CMLは UNIX 用しかないのでしょうか？
*CMLの最新バージョンは？
*CMLはどこから入手できますか？
*CMLのメーリングリストについて知りたいのですが。


インストール
============

*CMLをインストールするには何が必要ですか？
*CMLのインストールについての説明はどこにありますか？
*CMLを動作させるには何が必要ですか？
*HDDの残りが２０ＭＢしかありません。
*パッケージ展開後のファイル構成を教えてください。
*ed コマンドが無いらしく Configure が途中で止ってしまいます。
*sendmail のバージョンによる相性はありますか？
*smtpfeed は使えますか？
*Postfix は使えますか？
*qmail は使えますか？


ＭＬの作成
==========

*ＭＬを作るにはどうすればいいですか？
*すでにあるメンバーリストを使いたいのですが。
*他のＭＬドライバで運営していたＭＬをCMLで管理したいのです。
*ＭＬごとに細かい設定をしたいのですが。
*ＭＬに流れた記事を保存することはできますか？
*古くなった記事は必要ないのですが。
*保存された記事はMLメンバー以外に見られたくありません
*オリジナルのメールについている Reply-To: を尊重したいのですが
*Subject: にＭＬ名と通し番号はふれますか？
*Subject: に入るＭＬ名を短いニックネームにしたいのです。
*メンバー以外からの投稿ははじきたいのですが。
*その場合、投稿用のアドレスを別に登録できますか？
*特定のアドレスからしか投稿できなくしたいのですが。
*管理者の登録の仕方を教えてください。
*$ML/$ML-post-admins の記述フォーマットは？
*メールヘッダに独自の行を追加できますか？
*登録依頼メールが本人の物か確認してから自動登録したいのですが。
*メンバーの脱会をMLメンバーに毎回知らせるのは冗長では？
*メンバーの配送モードの変化を他のメンバーに毎回知らせるのは冗長では？
*まとめ送りの機能はありますか？
*まとめ送りのタイミングはいつですか？
*NIFTY のメールボックスは３０００行を超えるメールを受信できないようです。
*新しいバージョンには、MYHEADER 変数が config.default にないようですが？
*メンバーからのアーカイブのとりだし量を制限できませんか？
*システムメッセージを日本語以外にしたいのですが。
*メンバーリストを公開したくありません。
*CHECK コマンドって危険じゃありませんか？
*MLに流される記事の大きさに制限をかけたいのですが。

トラブルシューティング
======================

*マシンを Sony の NEWS に移したら動かなくなりました。
*MIMEエンコードされたヘッダがついていると処理できないようです。
*停電でマシンが落ちてしまったんですが、大丈夫でしょうか？
*マシンをリブートしたら、メールが流れなくなりました。
*sendmail がエラーを出して処理されません。
*X-Authentication-Warning: とかいう変なヘッダが付加されるのですが。
*CMLにいわゆる 2000年問題はありますか？

ＭＬの管理
==========

*遠隔地からメールでＭＬを管理したいのですが。
*メールではなく、ブラウザで管理できますか？
*メンバーリスト等をテキストエディタで修正しても大丈夫？
*ＭＬを廃止しました。不要なファイルを消してしまいたいのですが。
*会員が１０００人になろうとしています。大丈夫でしょうか？
*すると、１万人を越えることはできないのですか？
*記事番号が１０万を超えそうです。大丈夫でしょうか。
*記事番号が１０００万を超えそうです。大丈夫でしょうか？
*巨大な添付ファイル付きのメールが送信されてメンバーから苦情がでています。
*MLにメールが流れないので調べてみると /tmp が溢れていました。

著作権や利用に関する話題
========================

*CML は無料ですか？
*CML のスクリプトを参考にしてあるツールを作りました。
*CML を私の ftp サーバも配布したいのです。


その他の話題
============

*改善の要望は受け付けてもらえますか？
*私の知りたい問題がこのリストには載っていないようです。

	〜〜〜〜〜

はじめに
========

*この文書の目的を教えてください。

　ちまたのアプリケーションに添付されている FAQ がそうであるように、この文書
も CML に関して頻繁に尋ねられる質問とその解答を網羅することを目的としていま
す。FAQ は本来同じ質問が何度も繰り返されるのを避けるために作られたものです
が、最近は有用な情報源と見なされるようになってきています。

　この FAQ をできる限り有用なものにしたいと考えています。この FAQ に関して、
もし何か改善案が浮かんだら、ぜひ著作者までメールを送ってください。


CMLについて
===========

*CMLってなんですか？

　sendmail や Postfix でメールを配送しているシステム上で、メイリングリスト
を作成／運営するためのスクリプト群の総称です。UNIX の基本コマンドのみで構成
されていいるため(perl すら必要ありません!)ほとんどの UNIX マシンで何か特別
なコマンドを make することなく実行可能です。もしかすると、古くなってマシン
ルームの片隅に廃棄されている UNIX マシンですら動くかも知れません:-)


*CMLの著作者は誰？

　ForUs の齋藤 泰洋 (site@forus.or.jp) です。


*CMLは UNIX 用しかないのでしょうか？

　CML の開発は UNIX 上で行われています。このため、動作確認も UNIX 上でのみ
行われています。しかし、最近 Windows 上で UNIX をエミュレーションするコマン
ドや、sendmail が動いているという情報があるので、もしかすると、UNIX 以外の
環境で動作するかもしれません。もし、それに成功したなら、ぜひ著作者にメール
をお願いします。


*CMLの最新バージョンは？

　4.1-Release が最新バージョンで、2001年 11月にリリースされました。

　2004年4 月現在、4.2 が開発されており、テストバージョンが配布されています。


*CMLはどこから入手できますか？

　CML の公式配布先は、ftp://ftp.wkj.forus.or.jp/pub/CML/ です。また、
CMLに関する情報が、http://www.wkj.forus.or.jp/CML/ にあります。


*CMLのメーリングリストについて知りたいのですが。

　CMLユーザの情報交換の場として、CML ユーザメイリングリストが運営されていま
す。cml-users-control@wkj.forus.or.jp 宛に、append という題名のメールを送信
してください。本文に自己紹介もお忘れなく:-)


インストール
============

*CMLをインストールするには何が必要ですか？

　CML は tar + gnuzip でパッケージされています。したがって、この２つのアプ
リケーションがインストールされている必要があります。bornshell(/bin/sh)が最
低限インストールに必要です。


*CMLのインストールについての説明はどこにありますか？

　CMLのパッケージを展開すると、Doc/ というディレクトリができます。この配下
に、install というファイルがあり、ここにインストールに関する説明が記述され
ています。


*CMLを動作させるには何が必要ですか？

　UNIX の基本コマンドと sendmail が必要です。必要なコマンドがそろっているか
否かについては、Configure コマンドが調査しますので、あなたが手動でその存在
を調べる必要はありません。


*HDDの残りが２０ＭＢしかありません。

　CML自体は非常に小さなパッケージですので、十分インストールが可能です。ただ
し、ＭＬの過去の記事を残すような設定を行う場合は、HDD の容量を考慮しなけれ
ばならないでしょう。


*パッケージ展開後のファイル構成を教えてください。

　パッケージに含まれる、MANIFEST というファイルに記述されています。


*ed コマンドが無いらしく Configure が途中で止ってしまいます。

　TurboLinux には、default の状態では ed が入っていないようです。バイナリパッ
ケージ ed-0.2-16.i386.rpm を http://www.turbolinux.co.jp/update/ からインス
トールしたら動作したとの報告を受けています。


*sendmail のバージョンによる相性はありますか？

　相性の悪い組み合わせというのはありませんが、バージョンによって注意すべき
点はあります。詳しくは、Doc/sendmail に記述してあります。


*smtpfeed は使えますか？

　問題ありません。CML 側で特に何か設定を変更する必要もありません。


*Postfix は使えますか？

　基本的に問題ありません。
　設定ファイル main.cf などに、

	allow_mail_to_commands = alias,forward,include

(include を含むことが重要です)を記述しておけば、CML側で特に何か設定を変更す
る必要はありません。

　ただし、Postfixの仕様(?)として、ヘッダに、

	Delivered-To: $ML-dist@$DOMAIN
	                 ^^^^^
という行が付与されてしまい、メンバーファイルを指す宛先が見えてしまうようで
す。


*qmail は使えますか？

　現在のところオフィシャルにはサポートしていませんが、qmail でCMLを動かすプ
ロジェクトがパッチを提供してくださっています。　

　contrib/Patch-kit-for-qmail/ 配下にパッチキットを収録していますので、ご参考
になさってください。


ＭＬの作成
==========

*ＭＬを作るにはどうすればいいですか？

　ドキュメント Doc/make-ML を参照してください。


*すでにあるメンバーリストを使いたいのですが。
*他のＭＬドライバで運営していたＭＬをCMLで管理したいのです。

　それぞれ、ドキュメント、Doc/about-shift を参照してください。


*ＭＬごとに細かい設定をしたいのですが。

　addml で ML を作成すると、ML の名前のディレクトリができます。このディレク
トリに config.defaut を config.MLの名前 というファイルでコピーし編集するこ
とで、ML ごとに細かな設定をすることが出来ます。


*ＭＬに流れた記事を保存することはできますか？

　もちろん可能です。config ファイル(~cml/config.default または、~cml/ML名/
config.ML名：以下同様) に『ARCHIVE=DO』を定義してください。config ファイル
の変数に関する説明は、Doc/install を参照してください。


*古くなった記事は必要ないのですが。

　「最新の○○通を保存する」という機能があります。config ファイルで、
『KEEP=保存したい通数』を定義してください。

　なお、現在の所、経過日数で古い記事を削除する機能はありません。


*保存された記事はMLメンバー以外に見られたくありません

　config ファイルにおいて、『ACCESSFREE=DONT』を定義すると、会員番号と暗証
番号で認証をかけることが出来ます。


*オリジナルのメールについている Reply-To: を尊重したいのですが

　config ファイルで、『REPLYSW=2』を定義することにより実現できます。


*Subject: にＭＬ名と通し番号はふれますか？

　config ファイルの『SUBSTYLE』変数でお好みの形にできるでしょう。遠し番号の
有効桁数を可変にするために、『FIGURE』変数も用意されています。


*Subject: に入るＭＬ名を短いニックネームにしたいのです。

　config ファイルの『OTHERNAME』変数に任意の文字列を定義することが出来ます。


*メンバー以外からの投稿ははじきたいのですが。

　もっともな要求です。config ファイルの『NOTMEMBER』変数を2 か 3 に定義して
ください。2 と 3の違いは、はじいたことをML管理者にも知らせるかどうかの違い
です。


*その場合、投稿用のアドレスを別に登録できますか？

　複数のプロバイダと契約をしていたり、会社と自宅でメールアドレスが違う等、
はよくあるケースです。制御コマンドを用いて、任意の投稿アドレスを登録するこ
とが可能です。


*特定のアドレスからしか投稿できなくしたいのですが。

　『ADMINONLY』変数に DO を設定すると、MLの管理者からしか投稿できなくなりま
す。

　CMLを用いてメールマガジン的なものを運用する場合にはこの設定が有効かもしれ
ません。


*管理者の登録の仕方を教えてください。

 setadmin コマンドを用いて登録できます。setadmin で管理者を登録すると、メン
バーの登録削除など、MLの管理業務全てを行うことができるようになります。

　ADMINONLY=DO を設定し、単純に「投稿する目的」のみの管理者を登録したいよう
な場合、$ML/$ML-post-admins を適当なテキストエディタで編集してもかまいませ
ん。$ML/$ML-admins は、CML が自動で編集しますので、手動編集はしないでくださ
い。


*$ML/$ML-post-admins の記述フォーマットは？

　１行に１つずつ、『<管理者アドレス>』を記述してください。
　たとえば、foo@bar.jp さんと、hoge@hogehoge.com さんを登録するとすると、

	<foo@bar.jp>
	<hoge@hogehoge.com>

というように記述します。


*メールヘッダに独自の行を追加できますか？

　メールヘッダには "X-" で始まる文字列を付加することができます。config ファ
イルの『XHEADERS』変数に定義をしてください。


*登録依頼メールが本人の物か確認してから自動登録したいのですが。

　他人に知らないMLに勝手に登録されていたという事を避けるために、この動作は
必要でしょう。config ファイルに『CONFIRM=DO』を定義すると、登録依頼メールを
受信したときに、本当かどうかを登録予定のアドレスに対して再確認する動作にな
ります。


*メンバーの脱会をMLメンバーに毎回知らせるのは冗長では？

　config ファイルで、『DLVMSG=DONT』を定義すれば、お知らせメールは送信され
ません。


*メンバーの配送モードの変化を他のメンバーに毎回知らせるのは冗長では？

　config ファイルで、『AUTOMSG=DONT』を定義すれば、お知らせメールは送信され
ません。


*まとめ送りの機能はありますか？

　はい。配送モードを DGST にすれば、RFC934 で定義された、ダイジェスト形式で
送信することができます。


*まとめ送りのタイミングはいつですか？

　まとめ送りの時間は、~cml/ML名/batchtime というファイルに記述することが出
来ます。特に記述のない場合は、デフォルト値として、03:00 が選択されます。
　また、流量の多い ML 等の場合は、指定の行数やバイト数を越えたときに強制送
信するという指定も可能です。これらを定義したい場合は、config ファイルの
『DIGESTMAX』『DIGESTLEN』の各変数にそれぞれ好みの値を設定してください。


*NIFTY のメールボックスは３０００行を超えるメールを受信できないようです。

　そうなんです。NIFTY 側でなんとか改善してくれないものかと思っているのです
が。


*新しいバージョンには、MYHEADER 変数が config.default にないようですが？

　『MYHEADER』変数は廃止しました。もちろん、指定すれば使えますが、できれば
より機能を充実させた『XHEADERS』変数を使ってください。


*メンバーからのアーカイブのとりだし量を制限できませんか？

　『LISTLIMIT』『GETLIMIT』変数でそれぞれ、LIST の取出し制限、アーカイブの
取出し制限をすることができます。


*システムメッセージを日本語以外にしたいのですが。

　CML 自体は日本語のメッセージしか持ち合わせていませんが、このメッセージファ
イル群を翻訳することにより、変更することができます。
　詳しくは、Doc/about-multilingual を参照してください。


*メンバーリストを公開したくありません。

　ML会員が MEMBER コマンドを用いて会員一覧を取出すことが出来なくするには、
config ファイルに、『USEMEMBER=DONT』を定義してください。


*CHECK コマンドって危険じゃありませんか？

　CHECK コマンドの結果は ML に登録されているアドレスからしか実行できないの
で、おそらく問題ないと思うのですが、やっぱり使わせたくないという場合は、
『USECHECK=DONT』を定義すれば、CHECK コマンドを殺すことができます。


*MLに流される記事の大きさに制限をかけたいのですが。

　CMLDMAXLINE変数や、CMLDMAXBYTE変数を用いてMLで処理するメールサイズの上限
を設定することができます。


トラブルシューティング
======================

*マシンを Sony の NEWS に移したら動かなくなりました。

　NEWS OS に添付されている grep コマンドが、CML が期待している動作をしない
ため発生することが報告されています。Doc/about-NewsOS を参照してください。


*MIMEエンコードされたヘッダがついていると処理できないようです。

　一部の処理系で、mime デコーダである b64decode コマンドが動作しないという
報告を受けています。Doc/about-b64decode を参照してください。


*停電でマシンが落ちてしまったんですが、大丈夫でしょうか？

　UNIX 的に被害を受けていないようであれば、CML 的には、ロックファイルがシス
テム起動時にきれいに消えているかだけが問題です。Doc/about-down を参照してく
ださい。


*マシンをリブートしたら、メールが流れなくなりました。

　停電時におこり得る状況と同じように、CML が使っている幾つかのロックファイ
ルが消えていない可能性が高いです。Doc/about-down を参照してください。


*sendmail がエラーを出して処理されません。

　エラーメールのメッセージを慎重に調べてみてください。sendmail がエラーを吐
くおおよその理由については、わかっている物が多いです。Doc/sendmail を参照し
てみてください。このドキュメントに記述されていないエラーが発生しているよう
であれば、著作者にご連絡下さい。解決をお約束はできませんが、一緒に原因を調
査することはできるでしょう。


*X-Authentication-Warning: とかいう変なヘッダが付加されるのですが。

　Doc/sendmail を参照してください。


*CMLにいわゆる 2000年問題はありますか？

　CML の用いるタイマで年を考慮している部分はありません。したがって 2000年問
題が発生するとすれば、CML を運用している OS に依存すると考えます。


ＭＬの管理
==========

*遠隔地からメールでＭＬを管理したいのですが。

　ML 管理人のメールアドレスを登録することにより、可能です。
　詳しくは、Doc/about-remote-conf を参照してください。


*メールではなく、ブラウザで管理できますか？

　すべてのプラットフォームでの動作は保証されていませんが、CMLを運用している
サーバで CGI の動作を許可された web server が起動していれば可能です。
　詳しくは、Doc/cmad.cgi を参照してください。


*メンバーリスト等をテキストエディタで修正しても大丈夫？

　コマンドメールを有効にしている ML においては、手動での修正はおすすめでき
ません。もちろん、不可能ではありませんが、CML の動作について、十分な知識が
ないと、その後 ML が正しく動作しなくなるかもしれません。


*ＭＬを廃止しました。不要なファイルを消してしまいたいのですが。

　delml コマンドを用いることによって、不要になったファイルや過去のアーカイ
ブなどをすべて消すことができます。
　ただし、delml コマンドは、設定ファイルや、メンバーリスト、過去の記事など、
そのすべてを消し去りますので、実行前に必要であれば、それぞれバックアップを
とってください。


*会員が１０００人になろうとしています。大丈夫でしょうか？

　古い CML は会員番号を３桁で管理していましたが、2.5.1-Release より４桁で管
理するようになりました。したがって、９９９９人までは問題ありません。


*すると、１万人を越えることはできないのですか？

　その通りです。sendmail と CML の組合わせで１万人にメールを配送することは
あまり現実的ではないと思うので、この点については、改善する予定はありません。


*記事番号が１０万を超えそうです。大丈夫でしょうか。

　3.1-Release より、アーカイブの管理を７桁に変更されましたので問題ありませ
ん。


*記事番号が１０００万を超えそうです。大丈夫でしょうか？

　残念ながら、１０００万通を越えると正しくアーカイブが確保されないでしょう。
しかし、１０００万通のメールを保存するとなると、システム側に先に限界が来る
ように思います。


*巨大な添付ファイル付きのメールが送信されてメンバーから苦情がでています。

　CMLDMAXLINE変数や、CMLDMAXBYTE変数を用いてMLで処理するメールサイズの上限
を設定することができます。


*MLにメールが流れないので調べてみると /tmp が溢れていました。

　CML-4.2以降をお使いの場合、Configure でtemporary directory を /tmp 以外に
設定できるようになりました。

　また、CKECKDISKSPACE変数や、DISKLIMIT変数を用いて残り容量をチェックするこ
ともできます。

  
著作権や利用に関する話題
========================

*CML は無料ですか？

　その通りです。CML は、それを配布するにあたり、メディア代金などの、ごく一
般的と思われる手数料以上のものを徴収されることはありません。また、配布する
人は、手数料以上を徴収してはいけません。


*CML のスクリプトを参考にしてあるツールを作りました。

　CML を構成するスクリプトの一部もしくは全部を流用し何かを開発することは全
く制限されません。ただし、その出来上がったものに CML の名前をつけてはいけま
せん。もちろん、CML の名の元に配布してはいけません。


*CML を私の ftp サーバも配布したいのです。

　ありがとうございます。ただし、CML のバージョンアップが実施された場合には、
必ずあなたの ftp サーバの内容も更新してください。


その他の話題
============

*改善の要望は受け付けてもらえますか？

　前向きな、そして多くの人に対して有益と思われる改善要望は必ず採り入れられ
るでしょう。著作者にメールを送ってください。


*私の知りたい問題がこのリストには載っていないようです。

　すみません、FAQ を充実させるために、ぜひ、どのような事を知りたいのか著作
者にメールを送ってください。
