diff options
Diffstat (limited to 'fml/doc/ja/tutorial/command')
| -rw-r--r-- | fml/doc/ja/tutorial/command/dataflow.sgml | 29 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/command/extension.sgml | 25 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/command/internal.sgml | 37 |
3 files changed, 57 insertions, 34 deletions
diff --git a/fml/doc/ja/tutorial/command/dataflow.sgml b/fml/doc/ja/tutorial/command/dataflow.sgml index 2188e4e8..a7f1f5e8 100644 --- a/fml/doc/ja/tutorial/command/dataflow.sgml +++ b/fml/doc/ja/tutorial/command/dataflow.sgml @@ -1,5 +1,5 @@ <!-- - $FML: dataflow.sgml,v 1.3 2004/04/07 11:07:00 fukachan Exp $ + $FML: dataflow.sgml,v 1.4 2004/10/06 09:07:33 fukachan Exp $ --> @@ -43,12 +43,16 @@ <para> 1) guideやsubscribeのようにメンバー以外にも許されるコマンドであれば、 直接コマンド呼び出しルーチンへ処理が移ります。 + ここで許されるコマンドは anonymous_command_mail_allowed_commands + で定義されているコマンドです。 </para> <para> 2) メンバーだけに許されるコマンドの場合、 command_mail_restrictionsのルールに従って他の条件を確認し、 許されたなら、呼び出しルーチンへ処理が移ります。 + ここで許されるコマンドは user_command_mail_allowed_commands + で定義されているコマンドです。 </para> <para> @@ -61,11 +65,17 @@ FML::Command クラス経由でコマンドが実行されます。 <para> admin コマンドの実行は、ここでは行なわれません。「admin ...」コマンド -は、まず一般ユーザ権限の admin コマンドとして処理が薦められ、最終的に -「FML::Command::User::admin」クラスが呼び出されます。このクラスの中で、 -$admin_command_mail_restrictions に基づいてリモート権限があるか？が確 -認され、もう一度「FML::Command」クラス経由で管理者権限の -「FML::Command::Admin::コマンド」クラスが呼び出されます。 +は、まず一般ユーザ権限の admin コマンド +<footnote> +<para> +注: admin コマンドは user_command_mail_allowed_commands で許されています +</para> +</footnote> +として処理が薦められ、最終的に 「FML::Command::User::admin」クラスが呼 +び出されます。このクラスの中で、$admin_command_mail_restrictions に基 +づいてリモート権限があるか？が確認され、もう一度「FML::Command」クラス +経由で管理者権限の「FML::Command::Admin::コマンド」クラスが呼び出され +ます。 </para> </sect2> @@ -77,9 +87,10 @@ $admin_command_mail_restrictions に基づいてリモート権限があるか？が確 </title> <para> -このプログラムを使える時点で管理者権限があるはずです。よって、 -FML::Command経由で「FML::Command::Admin::コマンド」クラスを直接呼び出 -しています。 +このプログラムを使える時点で管理者権限(ＭＬのサーバにリモートで入り、 +ユーザ fml に su できる権限)があるはずです。よって、特別な制限はありま +せん。FML::Command経由で「FML::Command::Admin::コマンド」クラスを直接 +呼び出しています。 </para> </sect2> diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml index 1acccf54..1ef21a28 100644 --- a/fml/doc/ja/tutorial/command/extension.sgml +++ b/fml/doc/ja/tutorial/command/extension.sgml @@ -1,5 +1,5 @@ <!-- - $FML: extension.sgml,v 1.11 2004/04/07 11:07:00 fukachan Exp $ + $FML: extension.sgml,v 1.12 2004/10/06 09:07:33 fukachan Exp $ --> @@ -48,11 +48,11 @@ <para> ユーザ向けのコマンド uja を作りたい場合、 -FML::Command 以下から適当に cut and paste して +FML::Command::User 以下のモジュールから適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/User/uja.pm </screen> -というファイルを置き、設定ファイルで +というファイルを作り、設定ファイルで uja を許可するコマンドリストに追加して下さい。 全ての ML で有効にする場合は、site_default_config.cf で、 @@ -79,11 +79,11 @@ user_command_mail_allowed_commands += uja <para> admin 向けのコマンド uja を作りたい場合、 -FML::Command 以下から適当に cut and paste して +FML::Command::Admin 以下から適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/Admin/uja.pm </screen> -というファイルを置いてください。 +というファイルをつくってください。 全ての ML で有効にする場合は、site_default_config.cf で、 @@ -135,12 +135,12 @@ admin_command_mail_allowed_commands += uja <para> makefml でコマンド uja を作いたい場合、 -FML::Command 以下から適当に cut and paste して +FML::Command::Admin 以下から適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/Admin/uja.pm </screen> -というファイルを置けば有効になります -モジュールを置くだけで有効になります。 +というファイルをつくるだけで有効になります +つまりモジュールを置くだけで有効になります。 *_allowed_commands 系の変数の設定変更は不要です。 </para> @@ -156,6 +156,12 @@ FML::Command 以下から適当に cut and paste して <warning> + +<para> +以下の記述で利用可能な機能を追加することが出来ますが、 +別途、画面の作り込みが必要です。 +</para> + <para> このホスト全ての ML で有効にする場合、 拡張するモジュールを @@ -183,7 +189,9 @@ FML::Command 以下から適当に cut and paste して /usr/local/lib/fml/site_local/FML/Command/Admin/uja.pm </screen> というファイルを置いてください。 +</para> +<para> 全ての ML で有効にする場合は、site_default_config.cf で、 許可するコマンドリストに追加してください。 <screen> @@ -199,5 +207,4 @@ admin_cgi_allowed_commands += uja </screen> </para> - </sect1> diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml index ebbcf26a..5a56d026 100644 --- a/fml/doc/ja/tutorial/command/internal.sgml +++ b/fml/doc/ja/tutorial/command/internal.sgml @@ -1,5 +1,5 @@ <!-- - $FML: internal.sgml,v 1.9 2004/04/21 08:48:47 fukachan Exp $ + $FML: internal.sgml,v 1.10 2004/10/06 09:07:33 fukachan Exp $ --> @@ -35,7 +35,7 @@ sub myProcHelpFileSendBack </para> <para> -&fml8; では help ファイルを送り返すコードの実体は +一方、&fml8; では help ファイルを送り返すコードの実体は FML::Command::User::help にあり、 FML::Process::Command クラスから (FML::Command の AUTOLOAD を経由して)呼び出されます。 @@ -65,7 +65,7 @@ sub process src => $help_file, charset_out => $charset, }; - my $help_template = $curproc->prepare_file_to_return( $params ); + my $help_template = $curproc->reply_message_prepare_template( $params ); if (-f $help_template) { $curproc->reply_message( { @@ -80,32 +80,37 @@ sub process } } </screen> -ここで $curproc はハッシュリファレンスで、&fml4; の %Envelope におおむ -ね相当します。名前の通り、UNIX カーネルでおなじみの current process 構 -造体へのポインタのようなもので、プロセスに関連するいろいろなデータ構造 -やオブジェクトへのリファレンスを含んでいます。 +ここで $curproc はハッシュリファレンスで、&fml4; の %Envelope に概ね相 +当します。名前の通り、UNIX カーネルでおなじみの current process 構造体 +へのポインタのようなもので、プロセスに関連するいろいろなデータ構造やオ +ブジェクトへのリファレンスを含んでいます。 </para> <para> -変数ですが、&fml4; ではグローバル変数群です。一方 &fml8; では $config -オブジェクトを通じてアクセスできる設定変数空間の中にあります。 +変数ですが、&fml4; では全てグローバルです。一方 &fml8; では $config オ +ブジェクトを通じてアクセスできる設定変数空間の中にあります。 </para> <para> -prepare_file_to_return() はメッセージテンプレートの中にある変数の展開 -や文字コード変換を適宜行ないます。 +reply_message_prepare_template() はメッセージテンプレートの中にある変 +数の展開や文字コード変換を適宜行ないます。 </para> <para> $curproc->reply_message() は引数によって振舞いがことなりますが、 -いずれにせよ、メッセージをキューに入れるメソッドです。 +いずれにせよ、メッセージをメッセージキューに入れるメソッドです。 </para> <para> -キューに入れられたメッセージ群は、プロセスの終了直前に受信者ごとにメッ -セージはまとめられ一通のメールとして組み立てなおされ、Mail::Delivery -クラス経由で送信されます。メッセージキューの種類がファイルとメッセージ -が混在していれば、適宜 MIME マルチパートのメッセージが生成されます。 +メッセージキューに入れられたメッセージ群は、プロセスの終了直前に受信者 +ごとにメッセージがまとめられ一通のメールとして組み立てなおされます。メッ +セージキューの種類がファイルとメッセージが混在している場合は適宜 MIME +マルチパートのメッセージが生成されます。 +</para> + +<para> +Mail::Delivery クラスが送信処理を担当するモジュールです。生成されたメー +ルは最終的に Mail::Delivery クラスへ渡され送信処理が行なわれます。 </para> <para> |