=================================================================== RCS file: /home/cvs/OpenXM/src/asir-doc/parts/process.texi,v retrieving revision 1.2 retrieving revision 1.4 diff -u -p -r1.2 -r1.4 --- OpenXM/src/asir-doc/parts/process.texi 1999/12/21 02:47:31 1.2 +++ OpenXM/src/asir-doc/parts/process.texi 2000/01/13 08:29:56 1.4 @@ -1,4 +1,4 @@ -@comment $OpenXM$ +@comment $OpenXM: OpenXM/src/asir-doc/parts/process.texi,v 1.3 1999/12/24 04:38:04 noro Exp $ \BJP @node 分散計算,,, Top @chapter 分散計算 @@ -34,7 +34,7 @@ ための規約である. @b{OpenXM} においては \E \BEG -In @b{Asir} distributed computations are done under @b{OpenXM} +On @b{Asir} distributed computations are done under @b{OpenXM} (Open message eXchange protocol for Mathematics), which is a protocol for exchanging mainly mathematical objects between processes. @@ -115,11 +115,11 @@ are available. @item @code{ox_push_cmo()} \JP データを server のスタックに積む -\EG It requests a server to push an object to the stack of the server. +\EG It requests a server to push an object to the stack of a server. @item @code{ox_pop_cmo()} \JP データを server のスタックから取り出す. -\EG It request a server to pop an object from the stack of the server. +\EG It request a server to pop an object from the stack of a server. @item @code{ox_cmo_rpc()} @@ -191,9 +191,8 @@ Mathcap is also defined as a @b{CMO} and the elements or strings. The format of mathcap is as follows. -[[version number, server name],@b{SM}taglist,[@b{OX}taglist,@b{CMO}taglist, @b{CMO}taglist,...]] -[[version number, server name],@b{SM}taglist,[[@b{OX}tag,@b{CMO}taglist], -[@b{OX}tag,@b{CMO}taglist],...]] +[[version number, server name],@b{SM}taglist, +[[@b{OX}tag,@b{CMO}taglist],[@b{OX}tag,@b{CMO}taglist],...]] [@b{OX}tag,@b{CMO}taglist] indicates that available object tags for a category of data specified by @b{OX}tag. @@ -501,7 +500,7 @@ input @code{quit}. * ox_push_cmd ox_sync:: * ox_get:: * ox_pops:: -* ox_reset register_handler:: +* ox_reset ox_intr register_handler:: * ox_select:: * ox_flush:: * ox_get_serverinfo:: @@ -588,14 +587,6 @@ UNIX 版においては, @code{ox_launch()} は, @enumerate @item -ホスト @code{B} の @code{csh} のサーチパスに起動されるプログラム -のあるディレクトリをいれる. プログラムは @code{rsh} で起動される. した -がって, ホスト @code{B} のサーチパスに そのプログラムが入っていない場 -合には起動できない. この場合絶対パスを与えるか, @samp{~/.cshrc} のサー -チパスにそのプログラムのあるディレクトリを追加する必要がある. その際, -相手先ホストにおけるディレクトリであることを忘れないようにすること. - -@item ホスト @code{B} の @samp{~/.rhosts} に, ホスト @code{A} のホスト 名を登録する. @@ -653,7 +644,7 @@ is invoked on @var{host}. Then @samp{ox_launch} invoke If @var{host} is equal to 0, all the commands are invoked on the same machine as the @b{Asir} is running. If no arguments are specified, @var{host}, @var{dir} and @var{command} -are regarded as 0, the value of @code{get_rootdir()} and @samp{ox_dir} in +are regarded as 0, the value of @code{get_rootdir()} and @samp{ox_asir} in the same directory respectively. @item @@ -692,21 +683,6 @@ Here, Let @code{A} be the host on which @b{Asir} is ru @enumerate @item -Set the command search path of @code{csh} on the remote host @code{B} -so that your program, say @code{P}, can run on @code{B}. -This is done by putting the directory of @code{P} to the command search -path of @code{csh} on @code{B}. -The program @code{P} is invoked by @code{rsh} or @code{remsh}. -Thus, invocation of -the program @code{P} shall fail unless it is found within the search -path on the host @code{B}. -For such a case, you can run the program @code{P} by either giving -the absolute path or adding the directory of the program @code{P} to -the search path description in your @samp{~/.cshrc}. -Note that the the `directory' means the directory on the remote host -@code{B}. - -@item Register the hostname of the host @code{A} to the @samp{~/.rhosts} of the host @code{B}. That is, you should be allowed to access the host @code{B} from @code{A} @@ -1203,9 +1179,9 @@ The result is pushed to the stack. @fref{ox_pop_cmo ox_pop_local} @end table -\JP @node ox_reset register_handler,,, 分散計算に関する関数 -\EG @node ox_reset register_handler,,, Functions for distributed computation -@subsection @code{ox_reset},@code{register_handler} +\JP @node ox_reset ox_intr register_handler,,, 分散計算に関する関数 +\EG @node ox_reset ox_intr register_handler,,, Functions for distributed computation +@subsection @code{ox_reset},@code{ox_intr},@code{register_handler} @findex ox_reset @findex register_handler @@ -1213,6 +1189,9 @@ The result is pushed to the stack. @item ox_reset(@var{number}) \JP :: プロセスのリセット \EG :: Resets an OpenXM server +@item ox_intr(@var{number}) +\JP :: プロセスのに @code{SIGINT} 送付 +\EG :: Sends @code{SIGINT} to an OpenXM server @item register_handler(@var{func}) \JP :: プロセスのリセットのための関数登録 \EG :: Registers a function callable on a keyboard interrupt. @@ -1247,6 +1226,13 @@ The result is pushed to the stack. 計算途中での強制中断に用いる. @item +@code{ox_intr()} は, 識別子 @var{number} のプロセスをに対して +@code{SIGINT} を送付する. @code{SIGINT} に対するプロセスの動作は +規定されていないが, @samp{ox_asir} の場合, ただちに debug mode に +入る. X 上で動作している場合, デバッグコマンド入力用のウィンドウが +ポップアップする. + +@item @code{register_handler()} は, @kbd{C-c} などによる割り込みの際に, @kbd{u} を指定することで, 無引数ユーザ定義関数 @var{func()} が呼び出される ように設定する. この関数に, @code{ox_reset()} を呼び出させることで, @@ -1273,6 +1259,12 @@ Even if a process is running, the execution is safely It can be also used to interrupt a distributed computation. @item +@code{ox_intr()} sends @code{SIGINT} to a process whose identifier is +@var{number}. The action of a server against @code{SIGINT} is not +specified in @b{OpenXM}. @samp{ox_asir} immediately enters the debug +mode and pops up an window to input debug commands on X window system. + +@item @code{register_handler()} registers a function @var{func()}. If @kbd{u} is specified on a keybord interrupt, @var{func()} is executed before returning the toplevel. @@ -1507,7 +1499,7 @@ Usually @b{OX_SYNC_BALL} will be ignored by the peer. @table @t \JP @item 参照 \EG @item References -@fref{ox_rpc ox_cmo_rpc ox_execute_string}, @fref{ox_reset register_handler} +@fref{ox_rpc ox_cmo_rpc ox_execute_string}, @fref{ox_reset ox_intr register_handler} @end table \JP @node ox_get,,, 分散計算に関する関数 @@ -2166,5 +2158,5 @@ plot*form*ydone*background:white @table @t \JP @item 参照 \EG @item References -@fref{ox_launch ox_launch_nox ox_shutdown}, @fref{ox_reset register_handler} +@fref{ox_launch ox_launch_nox ox_shutdown}, @fref{ox_reset ox_intr register_handler} @end table