summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial/command/dataflow.sgml
diff options
context:
space:
mode:
authorKen'ichi Fukamachi <fukachan@fml.org>2018-09-16 15:41:09 +0900
committerKen'ichi Fukamachi <fukachan@fml.org>2018-09-16 15:41:09 +0900
commit6f983739de5b5c3229d2bef06004adbdd7010fe1 (patch)
tree8a007943a11c0061d774a6332e110135aa7d2f4a /fml/doc/ja/tutorial/command/dataflow.sgml
parentc10f8eff1f70519fce4a3eaa166dff4ad79d7c68 (diff)
downloadfml8-6f983739de5b5c3229d2bef06004adbdd7010fe1.tar.gz
fml8-6f983739de5b5c3229d2bef06004adbdd7010fe1.tar.bz2
fml8-6f983739de5b5c3229d2bef06004adbdd7010fe1.zip
reviewed. alignment cosmetics.
Diffstat (limited to 'fml/doc/ja/tutorial/command/dataflow.sgml')
-rw-r--r--fml/doc/ja/tutorial/command/dataflow.sgml56
1 files changed, 34 insertions, 22 deletions
diff --git a/fml/doc/ja/tutorial/command/dataflow.sgml b/fml/doc/ja/tutorial/command/dataflow.sgml
index 6f3a32f7..b765e3ce 100644
--- a/fml/doc/ja/tutorial/command/dataflow.sgml
+++ b/fml/doc/ja/tutorial/command/dataflow.sgml
@@ -14,9 +14,10 @@
-->
<para>
-すべてのコマンド(&fml8; への命令)処理は最終的に「FML::Command」クラス
-経由で「FML::Command::モード::コマンド」クラスを呼び出します。GUI およ
-び CUI、コマンドメールは、そこに至る前処理の段階が異なるだけです。
+すべてのコマンド(&fml8; への命令)処理は、
+最終的に「FML::Command」クラス経由で
+「FML::Command::モード::コマンド」クラスを呼び出します。
+GUI および CUI、コマンドメールは、そこに至る前処理段階が異なるだけです。
</para>
@@ -32,7 +33,7 @@
</caution>
<para>
-本節はコマンドメールの話です。
+本節は、コマンドメールの話です。
メールの本文が複数行あり、それが複数の命令を含むと想定します。
</para>
@@ -42,22 +43,27 @@
</para>
<para>
-空行を無視するなどの基本的な処理の後、コマンド(行の先頭の文字列)が、現
-在のコンテキストで許されるコマンドか否か?を確認します。
+空行を無視するなどの基本的な処理の後、
+コマンド(行の先頭の文字列)が、
+現在のコンテキストで許されるコマンドか否か?を確認します。
</para>
<para>
1) guide や subscribe のようにメンバー以外にも許されるコマンドであれば、
そこから直接、コマンド呼び出しルーチンへ処理が移ります。
- ここで許されるコマンドは anonymous_command_mail_allowed_commands
+ ここで許されるコマンドは
+ anonymous_command_mail_allowed_commands
変数で定義されているコマンドです。
</para>
<para>
2) あらかじめ指定されたユーザだけに許されるコマンドの場合、
- command_mail_restrictions のルールに従って他の条件を確認し、
- 許されたなら、呼び出しルーチンへ処理が移ります。
- ここで許されるコマンドは user_command_mail_allowed_commands
+ command_mail_restrictions
+ のルールに従って他の条件を確認し、
+ コマンドの実行が許される場合のみ、
+ コマンド呼び出しルーチンへ処理が移ります。
+ ここで実行が許されるコマンドは
+ user_command_mail_allowed_commands
で定義されているコマンドです。
</para>
@@ -69,7 +75,7 @@
<para>
「呼び出しルーチン」では、
(コマンドに依存した)返事の送り先の確認と
-(コマンドに依存する)シンタックスチェックを経て、
+(コマンドに依存する)シンタックスチェックをへて、
FML::Command クラス経由でコマンドが実行されます。
この実行は一般ユーザ権限で実行されます。
</para>
@@ -83,11 +89,15 @@ admin コマンドの実行は、ここでは行なわれません。
注: admin コマンドは user_command_mail_allowed_commands で許されています
</para>
</footnote>
-の実行として処理が進められ、最終的に「FML::Command::User::admin」クラ
-スが呼び出されます。このクラスの中で、admin_command_mail_restrictions
-変数 に基づいてリモート権限があるか?が確認され、もう一度
-「FML::Command」クラス経由で管理者権限の「FML::Command::Admin::コマン
-ド」クラスが呼び出されます(つまりトランポリン・メカニズムです)。
+の実行として処理が進められ、
+最終的に「FML::Command::User::admin」クラスが呼び出されます。
+このクラスの中で、
+admin_command_mail_restrictions 変数 にもとづいて、
+このユーザはリモートコマンドを実行する権限があるか?が確認されます。
+その後、もう一度
+「FML::Command」クラス経由で、
+管理者権限の「FML::Command::Admin::コマンド」クラスが呼び出されます
+(つまりトランポリン・メカニズムです)。
</para>
</sect2>
@@ -100,15 +110,17 @@ admin コマンドの実行は、ここでは行なわれません。
<para>
このプログラムを使える時点で管理者権限(MLのサーバにリモートで入り、
-ユーザ fml に su できる権限)があるはずです。よって、特別な制限はありま
-せん。FML::Command経由で「FML::Command::Admin::コマンド」クラスを直接
-呼び出しています。
+ユーザ fml に su できる権限)があるはずです。
+よって、特別な制限はありません。
+FML::Command 経由で
+「FML::Command::Admin::コマンド」クラスを直接呼び出しています。
</para>
<para>
-なお、サーバへリモートからログインするためには SSH で「RSA 2048 ビット
-以上の鍵のみを許す、パスワード認証は認めない」といった強固な運用ルール
-を課して下さい。
+なお、
+サーバへリモートからログインするためには
+SSH で「RSA 2048 ビット以上の鍵のみを許す、パスワード認証は認めない」
+といった強固な運用ルールを課して下さい。
</para>
</sect2>