several examples around on log, hooks, troubleshootings.

12 files changed, 713 insertions, 16 deletions

diff --git a/fml/doc/en/tutorial/include/chapters.ent b/fml/doc/en/tutorial/include/chapters.ent
index b809d542..574a8e58 100644
--- a/fml/doc/en/tutorial/include/chapters.ent
+++ b/fml/doc/en/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapters.ent,v 1.8 2006/01/15 15:32:03 fukachan Exp $
+   $FML: chapters.ent,v 1.9 2006/01/16 03:21:34 fukachan Exp $
    $jaFML: chapters.ent,v 1.75 2003/06/20 22:03:12 fukachan Exp $
 -->
 
@@ -127,13 +127,11 @@
 <!entity chapter.db.modules          SYSTEM "internals/db_modules.sgml">
 <!entity chapter.dbms                SYSTEM "internals/dbms.sgml">
 <!entity chapter.hook                SYSTEM "internals/hook.sgml">
-<!entity chapter.policy              SYSTEM "policy.sgml">
-
 <!entity chapter.filename            SYSTEM "internals/filename.sgml">
-
 <!entity chapter.userctl             SYSTEM "internals/userctl.sgml">
-
 <!entity chapter.merge.internal      SYSTEM "internals/merge.sgml">
+<!entity chapter.policy              SYSTEM "policy.sgml">
+<!entity sect.hook.recipes           SYSTEM "internals/recipes.hook.sgml">
 
 
 <!-- delivery -->
@@ -192,6 +190,7 @@
 <!-- operations -->
 <!entity chapter.op.log              SYSTEM "operations/log.sgml">
 <!entity chapter.op.backup           SYSTEM "operations/backup.sgml">
+<!entity sect.op.log.recipes         SYSTEM "operations/recipes.log.sgml">
 
 
 <!-- misc -->
@@ -217,6 +216,10 @@
 
 <!-- trouble shoot -->
 <!entity chapter.troubleshoot         SYSTEM "troubleshoot/chapter.sgml">
+<!entity troubleshoot.recipes         SYSTEM "troubleshoot/recipes.sgml">
+<!entity troubleshoot.recipes.message SYSTEM "troubleshoot/recipes.message.sgml">
+
+
 <!entity recipe.version               SYSTEM "troubleshoot/recipe.version.sgml">
 <!entity recipe.listup.addresses      SYSTEM "troubleshoot/recipe.listup.addresses.sgml">
 <!entity recipe.listup.aliases        SYSTEM "troubleshoot/recipe.listup.aliases.sgml">
diff --git a/fml/doc/en/tutorial/internals/hook.sgml b/fml/doc/en/tutorial/internals/hook.sgml
index 206e4d5c..56c4f75d 100644
--- a/fml/doc/en/tutorial/internals/hook.sgml
+++ b/fml/doc/en/tutorial/internals/hook.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: hook.sgml,v 1.1 2005/07/28 13:27:48 fukachan Exp $
+   $FML: hook.sgml,v 1.2 2005/09/28 11:05:51 fukachan Exp $
 -->
 
 
@@ -122,4 +122,16 @@ The naming convension may differ from this convension.
 </sect1>
 
 
+<sect1 id="hook.recipes">
+	<title>
+	Recipes
+	</title>
+
+<qandaset>
+&sect.hook.recipes;
+</qandaset>
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/en/tutorial/operations/log.sgml b/fml/doc/en/tutorial/operations/log.sgml
index fc0480c6..daf9e820 100644
--- a/fml/doc/en/tutorial/operations/log.sgml
+++ b/fml/doc/en/tutorial/operations/log.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: log.sgml,v 1.1 2005/07/23 01:57:38 fukachan Exp $
+   $FML: log.sgml,v 1.2 2005/09/25 04:27:20 fukachan Exp $
    $jaFML: log.sgml,v 1.2 2004/10/06 09:07:41 fukachan Exp $
 -->
 
@@ -81,4 +81,14 @@ $log_computer_output_engine in config.cf file.
 </sect1>
 
 
+<sect1 id="operations.log.recipes">
+	<title>
+	Recipes
+	</title>
+
+&sect.op.log.recipes;
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/en/tutorial/operations/recipes.log.sgml b/fml/doc/en/tutorial/operations/recipes.log.sgml
new file mode 100644
index 00000000..758fad62
--- /dev/null
+++ b/fml/doc/en/tutorial/operations/recipes.log.sgml
@@ -0,0 +1,156 @@
+<!--
+ $FML$
+-->
+
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+show fml error log of yesterday.
+</para>
+</question>
+
+<answer>
+<para>
+daily.pl of &fml4; is not implemented yet.
+</para>
+
+<para>
+Currently use grep to parse the log file.
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+See old logs.
+</para>
+</question>
+
+<answer>
+<para>
+&fml8; appends log messages continuously into the log file at
+$ml_home_directory by default. All log messages exist in it.
+</para>
+
+<para>
+On the other hand, Unix log expires. 
+So you cannot trace too lod messages.
+</para>
+
+<para>
+Please tune parameters of expiration tools e.g. newsyslog which
+program differs from unix variants to variants to save log messages in
+at least 3 months.
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Centralize log messages.
+</para>
+</question>
+
+<answer>
+<para>
+Unix uses syslog mechanism.
+To redirect all messages to /var/log/messages, set the following:
+<screen>
+[/etc/syslog.conf]
+
+*.*		/var/log/messages
+</screen>
+</para>
+
+<para>
+Also, &fml8; can use syslog mechanism.
+<screen>
+[/var/spool/ml/elena/config.cf]
+
+log_type	=	syslog
+</screen>
+</para>
+
+<para>
+To use these configuration, all messages are centralized to
+/var/log/messages file.
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+extract specific log messages in monitoring.
+</para>
+</question>
+
+<answer>
+<para>
+<screen>
+% tail -F /var/spool/ml/elena/log | grep 'PATTERN'
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+extrace the specific log messages with coping it.
+</para>
+</question>
+
+<answer>
+<para>
+
+<screen>
+% tail -F /var/spool/ml/elena/log | grep 'PATTERN' | tee FILE
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Expire old log files.
+</para>
+</question>
+
+<answer>
+<para>
+Newsyslog mechanism provided by &fml4; is not implemented.
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index c8e946a2..1df327f5 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.105 2006/01/15 15:32:03 fukachan Exp $
+	$FML: chapters.ent,v 1.106 2006/01/16 03:21:34 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -133,13 +133,10 @@
 <!entity chapter.db.modules          SYSTEM "internals/db_modules.sgml">
 <!entity chapter.dbms                SYSTEM "internals/dbms.sgml">
 <!entity chapter.hook                SYSTEM "internals/hook.sgml">
-
 <!entity chapter.filename            SYSTEM "internals/filename.sgml">
-
 <!entity chapter.userctl             SYSTEM "internals/userctl.sgml">
-
 <!entity chapter.merge.internal      SYSTEM "internals/merge.sgml">
-
+<!entity sect.hook.recipes           SYSTEM "internals/recipes.hook.sgml">
 
 
 <!-- 配送 -->
@@ -198,6 +195,7 @@
 <!-- operations -->
 <!entity chapter.op.log              SYSTEM "operations/log.sgml">
 <!entity chapter.op.backup           SYSTEM "operations/backup.sgml">
+<!entity sect.op.log.recipes         SYSTEM "operations/recipes.log.sgml">
 
 
 <!-- misc -->
@@ -224,6 +222,7 @@
 <!-- トラブルシューティング -->
 <!entity chapter.troubleshoot         SYSTEM "troubleshoot/chapter.sgml">
 <!entity troubleshoot.recipes         SYSTEM "troubleshoot/recipes.sgml">
+<!entity troubleshoot.recipes.message SYSTEM "troubleshoot/recipes.message.sgml">
 
 
 <!entity recipe.version               SYSTEM "troubleshoot/recipe.version.sgml">
diff --git a/fml/doc/ja/tutorial/internals/hook.sgml b/fml/doc/ja/tutorial/internals/hook.sgml
index d66de589..f683df07 100644
--- a/fml/doc/ja/tutorial/internals/hook.sgml
+++ b/fml/doc/ja/tutorial/internals/hook.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: hook.sgml,v 1.5 2004/05/22 12:33:49 fukachan Exp $
+   $FML: hook.sgml,v 1.6 2004/10/06 09:07:39 fukachan Exp $
 -->
 
 
@@ -124,4 +124,16 @@ sub run
 </sect1>
 
 
+<sect1 id="hook.recipes">
+	<title>
+	レシピ’s
+	</title>
+
+<qandaset>
+&sect.hook.recipes;
+</qandaset>
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/internals/recipes.hook.sgml b/fml/doc/ja/tutorial/internals/recipes.hook.sgml
new file mode 100644
index 00000000..4923d573
--- /dev/null
+++ b/fml/doc/ja/tutorial/internals/recipes.hook.sgml
@@ -0,0 +1,62 @@
+<!--
+   $FML$
+-->
+
+
+<qandaentry>
+
+<question>
+<para>
+HOOK で使うべきおすすめの変数名はなんですか？
+</para>
+</question>
+
+<answer>
+<para>
+HOOK 内で使う変数を my() で制限してくれれば、特に制限はないです。
+<screen>
+$hook = q{
+	my $x = $config->{ xxx };
+	my $y = $config->{ yyy };
+	if ($x eq $y) {
+	    SOME ACTION
+	}
+};
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+HOOK で変更してよい変数はなんですか？
+</para>
+</question>
+
+<answer>
+
+<para>
+$config オブジェクトへの代入操作は問題ありません。
+また $curproc が提供するアクセスメソッドで変更できるものについても
+自由にアクセスメソッドを使って下さい。
+</para>
+
+<para>
+理屈の上では HOOK で $curproc 経由でアクセスできる全てのものを変更して
+好きなように &fml8; を操作することが出来ますが、アップグレードなどの保
+証は一切ありません。
+</para>
+
+<para>
+アップグレードしても問題のない HOOK を書くには
+$curproc のアクセスメソッドだけを使って書くようにしてください。
+</para>
+
+</answer>
+
+</qandaentry>
diff --git a/fml/doc/ja/tutorial/operations/log.sgml b/fml/doc/ja/tutorial/operations/log.sgml
index 14929366..2c5b73e2 100644
--- a/fml/doc/ja/tutorial/operations/log.sgml
+++ b/fml/doc/ja/tutorial/operations/log.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: log.sgml,v 1.1 2003/11/29 12:51:36 fukachan Exp $
+   $FML: log.sgml,v 1.2 2004/10/06 09:07:41 fukachan Exp $
 -->
 
 
@@ -89,4 +89,14 @@ FML::Log::Print::Simpleを参考に、hack してみてください:)
 </sect1>
 
 
+<sect1 id="operations.log.recipes">
+	<title>
+	レシピ’s
+	</title>
+
+&sect.op.log.recipes;
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/operations/recipes.log.sgml b/fml/doc/ja/tutorial/operations/recipes.log.sgml
new file mode 100644
index 00000000..ea654fcc
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/recipes.log.sgml
@@ -0,0 +1,168 @@
+<!--
+ $FML$
+-->
+
+<qandaset>
+
+<qandaentry>
+
+<question>
+<para>
+前日の fml のエラーログを出したい
+</para>
+</question>
+
+<answer>
+<para>
+&fml4; の daily.pl にあたるものは未実装です。
+</para>
+
+<para>
+現状ではログファイルを grep してください。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+古いログを見たい
+</para>
+</question>
+
+<answer>
+<para>
+&fml8; はデフォルトではＭＬのホームディレクトリにあるログファイルにひ
+たすら書き込んでいきます。ＭＬが始まった時からの記録が全てここにありま
+す。
+</para>
+
+<para>
+一方、Unix のログは一定期間後に削除されていってしまうのであまり古いロ
+グは追えません。
+</para>
+
+<para>
+newsyslog など(OS によって仕組みは異なる) OS 附属のシステムが古いログ
+の消去をしてます。あらかじめ、これらのパラメータを調整し、三カ月程度は
+保存するようにしておきましょう。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ログを一極集中させたい
+</para>
+</question>
+
+<answer>
+<para>
+Unix では syslog というメカニズムでログを管理しています。syslogd が受
+けとったメッセージは /etc/syslog.conf に従いファイルへの書き込みや他ホ
+ストへの転送がなされます。
+<screen>
+[/etc/syslog.conf]
+
+# すべてのログを /var/log/messages へ出力する
+*.*		/var/log/messages
+</screen>
+</para>
+
+<para>
+&fml8; のログはデフォルトでは各ＭＬのホームディレクトリにあるログファ
+イルへ書き込まれますが syslog へ出力することも出来ます。
+<screen>
+[/var/spool/ml/elena/config.cf]
+
+log_type	=	syslog
+</screen>
+</para>
+
+<para>
+上述の「全てを記録する syslog 」設定とあわせて /var/log/messages にシ
+ステム全てのログと fml のログを集めることが出来るというわけです。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ログを見張りつつ特定の行だけを見たい
+</para>
+</question>
+
+<answer>
+<para>
+fml8 の問題というより Unix コマンドの使い方の話です。
+</para>
+
+<para>
+ある「パターン」にマッチするメッセージだけを表示させたいなら次のように
+します。
+<screen>
+% tail -F /var/spool/ml/elena/log | grep 'パターン'
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ログのコピーをとりつつ見張り、かつエラー行だけ見る
+</para>
+</question>
+
+<answer>
+<para>
+fml8 の問題というより Unix コマンドの使い方の話です。
+</para>
+
+<para>
+
+<screen>
+% tail -F /var/spool/ml/elena/log | grep 'パターン' | tee ファイル
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+古いログファイルを消去したい
+</para>
+</question>
+
+<answer>
+<para>
+&fml4; の newsyslog 機能に当たるものは未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>
diff --git a/fml/doc/ja/tutorial/troubleshoot/chapter.sgml b/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
index 300d59a7..cd8de29b 100644
--- a/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
+++ b/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.6 2005/11/19 03:45:07 fukachan Exp $
+   $FML: chapter.sgml,v 1.7 2006/01/15 15:32:03 fukachan Exp $
 -->
 
 
@@ -21,6 +21,7 @@
 &recipe.listup.addresses;
 &recipe.listup.aliases;
 &troubleshoot.recipes;
+&troubleshoot.recipes.message;
 
 </qandaset>
 
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.message.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.message.sgml
new file mode 100644
index 00000000..61946cb2
--- /dev/null
+++ b/fml/doc/ja/tutorial/troubleshoot/recipes.message.sgml
@@ -0,0 +1,212 @@
+<!--
+   $FML$
+-->
+
+
+<qandaentry>
+
+<question>
+<para>
+受信したメールに Reply-To: がついていないようです
+</para>
+</question>
+
+<answer>
+
+<para>
+別についている必要はありませんのでエラーでも何でもありません。
+</para>
+
+<para>
+また「ついていない」という意味を確認したほうがよいでしょう。メールリー
+ダが表示していないだけかも知れません。メールヘッダをすべて表示するよう
+にして確認してもらうようにして下さい。
+</para>
+
+<para>
+なお、デフォルトでは fml8 が配送した記事には Reply-To: がついています。
+もし元々のメールに Reply-To: 指定があった場合は、そのまま元の Reply-To: が
+ついています。
+もし元のメールに Reply-To: がないなら fml8 が適切なものをつけます。
+たとえば、記事であれば投稿用のアドレス、コマンドメールの返事であれば
+コマンドメールのアドレスです。
+</para>
+
+<para>
+ただ fml8 が Reply-To: をつけないように設定してあるのならつきません。
+元々のメールに Reply-To: がければ、そのまま Reply-To: のないメールが配
+送されます。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+返信先が期待通りでないようです
+</para>
+</question>
+
+<answer>
+<para>
+まず「返信先」とは何のことをいっているのか？を確認しましょう。
+</para>
+
+<para>
+おそらくメールリーダで返信をクリックしたら用意されたテンプレートの
+宛先が期待通りでなかったということをいっているのだとはおもいます。
+</para>
+
+<para>
+ふつう、その宛先は Reply-To: なければ From: が使われているはずです。
+メールリーダで加工されていないヘッダを表示してどうなっているかを確認し
+てもらって下さい。
+</para>
+
+<para>
+なお、Reply-To: については前レシピを参照して下さい。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+References: や In-Reply-To: がついていません
+</para>
+</question>
+
+<answer>
+<para>
+これは元のメールについていないためです。
+そのため送信者のメールリーダがつけていないということになります。
+どうにもなりません。
+</para>
+
+<para>
+fml8 は References: や In-Reply-To: についてなにもしません。
+素通しです。
+</para>
+</answer>
+
+</qandaentry>
+	
+
+<qandaentry>
+
+<question>
+<para>
+メールリーダでスレッドが表示できません。
+</para>
+</question>
+
+<answer>
+<para>
+fml8 はこれらのヘッダフィールドに対して何もしません。
+元のメールに In-Reply-To: や References: がないためと考えられます。
+</para>
+
+<para>
+前レシピも参照して下さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ＭＬの受信者のうち一部の人だけ文字化けするそうです。
+</para>
+</question>
+
+<answer>
+<para>
+全員なら fml8 に問題がある可能性もありますが、
+一部の人だけ文字化けするのであれば、
+その人たちのメール環境の問題です。
+</para>
+
+<para>
+ただ元々のメールが特殊で一部の人だけ読めないという可能性(たとえば M$ 
+星人の人たちだけで勝手に見えているようなメールとメールリーダの組)もあ
+るので、一概に読む側が悪いとも言い切れない気がしますが…
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+どうしても ISO-2022-JP で送ってこない人がいます
+</para>
+</question>
+
+<answer>
+<para>
+MIME ヘッダを見てメールリーダがよろしく頑張ってしまうので、
+現代では問題とされないことが多くなってしまったかもしれません。
+</para>
+
+<para>
+無理矢理 fml8 側で変換できないわけではありませんが、整合性がとれなくな
+るので、やめたほうがいいでしょう。メールリーダにおまかせです。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+一部の受信者が日本語が読めない環境にいる
+</para>
+</question>
+
+<answer>
+<para>
+遠い外国ということでしょうか。
+けっこうどうしょうもありませんが、ウエブメールなら読める可能性が高いです。
+いずれにせよ読む側の問題なので fml8 で何かをすることは難しいでしょう。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+半角文字のメールが送られてきたらそれを矯正する
+</para>
+</question>
+
+<answer>
+<para>
+未実装です。
+<screen>
+
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
index 51360919..2d5618a0 100644
--- a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
+++ b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML: recipes.sgml,v 1.1 2005/10/29 05:13:11 fukachan Exp $
+ $FML: recipes.sgml,v 1.2 2006/01/15 13:49:57 fukachan Exp $
 -->
 
 
@@ -72,6 +72,40 @@ fml からのエラーメッセージが記録されている可能性があります。
 
 </qandaentry>
 
+<qandaentry>
+
+<question>
+<para>
+配送に失敗した記事を自動で再送したい
+</para>
+</question>
+
+<answer>
+<para>
+MTA 間での再送エラーは MTA が再配送を試みます。
+Sendmail の歴史的なパラメータが五日間でしたので、
+五日間再配送を試みるくらいの MTA が多いと思います。
+</para>
+
+<para>
+&fml8; と MTA 間でエラーが生じた場合は 
+&fml8; のメールキューに入り、
+&fml8; が MTA への再送を試みます。
+この部分の動作において &fml8; は MTA です。
+</para>
+
+<para>
+参考: 
+<link linkend="delivery">
+<xref linkend="delivery">
+</link>
+も参照して下さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
 
 <qandaentry>
 
@@ -173,3 +207,21 @@ rudo 宛に直接配送されてくる分の２つになるというわけです。
 </answer>
 
 </qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+flock が動かない OS なのですが？
+</para>
+</question>
+
+<answer>
+<para>
+fml8 は flock(2) 必須ですので、fml8 は動きません(たぶん動くけど動作が
+変になる)。
+</para>
+</answer>
+
+</qandaentry>