Annotation of OpenXM/doc/OpenXM-specs/stackmachine.tex, Revision 1.8
1.8 ! takayama 1: %% $OpenXM$
1.1 noro 2: //&jp \section{ OX スタックマシン }
1.4 noro 3: //&eg \section{ OX stack machine }
4: \label{sec:stackmachine}
1.1 noro 5: /*&jp
6: この節では, OX スタックマシン operator の説明
7: (TCP/IP ソケット上での標準 encoding 法 を用いる),
8: および, サンプルサーバとリンクする場合または
9: open XM ライブラリとしてリンクして使用する場合の
10: ための C の関数の仕様を説明する.
11:
12: 説明の前に, OX サーバスタックマシンの動作の原則を
13: 説明しておく.
14: サーバスタックマシンは,
15: {\tt SM\_pop*} 系のスタックマシンコマンドがこないかぎり,
16: 自発的にメッセージを送信することはない.
17: この原則に基づいて分散計算のプログラミングをおこなう.
18: イベントドリブンなプログラム法とはちがうことに
19: 注意しよう.
1.2 noro 20: */
1.1 noro 21:
1.2 noro 22: /*&eg
23: In this section we describe the OX stack machine operators. In
24: the descriptions OX messages are represented by th standard encoding
25: scheme on TCP/IP sockets. In principle, an OX stack machine never
26: sends data to the output stream unless it receives {\tt SM\_pop*}
27: commands. Note that the programming style should be different from
28: that for event-driven programming.
29: */
1.1 noro 30:
1.2 noro 31: //&jp \subsection{サーバスタックマシン }
32: //&eg \subsection{Server stack machine}
1.1 noro 33:
1.2 noro 34: /*&jp
1.1 noro 35: サンプルサーバである {\tt oxserver00.c}
36: は以下の仕様の C の関数を用意して,
37: {\tt nullstackmachine.c } を置き換えれば一応動作するはずである.
1.2 noro 38: */
39: /*&eg
40: {\tt oxserver00.c} is implemented as a sample server.
41: If you want to implement you own server,
42: write the following functions and use them instead of
1.4 noro 43: those in {\tt nullstackmachine.c}.
1.2 noro 44: */
1.1 noro 45:
1.4 noro 46: //&jp \subsubsection{サーバスタックマシンのグループ SMobject/Primitive に属するオペレータ}
47: //&eg \subsubsection{Operators in the group SMobject/Primitive}
1.1 noro 48:
1.2 noro 49: /*&jp
1.1 noro 50: \noindent
1.2 noro 51: サーバスタックマシンは最低で1本のスタック
52: \begin{verbatim}
53: Object xxx_OperandStack[SIZE];
54: \end{verbatim}
55: をもつ. ここで, {\tt Object} はそのシステム固有の Object 型で構わない.
56: CMObject は各サーバ固有のローカルオブジェクトに変換してスタックへプッ
57: シュしてよい. ただし変換, 逆変換を合成したものは恒等写像であることが
58: のぞましい. CMObject をどのように (local) Object に変換するか, Object
59: が受け付けるメッセージの定義は,各システムが独自にきめて文書化しておく
60: ものとする. つまりすべてのメッセージは, private である. たとえば,
61: {\tt add } のような基本的な メッセージにたいしても, OX スタックマシン
62: はなにもきめていない. 将来的には open math \cite{openmath} のように
63: CMObject に対する最大公約数的なメッセージの仕様をcontent dictionary
64: (CD) の形で定義したい.
65:
66: 以下, \verb+ xxx_ + は誤解の恐れがないときは省略する.
67: \verb+ xxx_ + は local サーバシステムに固有の識別子である.
68: {\tt Asir} の場合は \verb+ Asir_ + を用いる. {\tt kan/sm1} の場合は
69: \verb+ Sm1_ + を用いる. 関数名, タグ名は長いので省略形を用いてもよい.
70:
71: 以下では次のようにパケットを記述する. 各フィールドは,
72: \fbox{データ型 \quad データ} なる形式
73: で書く. たとえば, {\tt int32 OX\_DATA} は 32 bit network byte order
74: の数字 {\tt OX\_DATA}という意味である. ``イタリックで書かれているフィー
75: ルドは,定義が別のところでなされているか解釈に誤解のないような自然言語
76: で説明されている object を表す.'' たとえば, {\it String commandName}
77: は, String データ型の local object {\it commandName} を意味する. (サー
78: バスタックマシン上の object は, CMO 形式の objectとは限らないことに注
79: 意. CMO 形式で書いてあっても, それはサーバスタックマシンのlocal 形式
80: でスタック上にあると解釈して下さい.)
1.1 noro 81:
1.4 noro 82: すべてのサーバスタックマシンは以下の操作を実装していないといけない.
83: 各操作に対し, その前後におけるスタックの状態を示す. 図において,
84: 右端のオブジェクトがスタックのトップに対応する.
1.2 noro 85: */
1.1 noro 86:
1.2 noro 87: /*&eg
1.1 noro 88: \noindent
1.2 noro 89: Any OX stack machine has at least one stack.
1.1 noro 90: \begin{verbatim}
91: Object xxx_OperandStack[SIZE];
92: \end{verbatim}
1.2 noro 93: Here {\tt Object} may be local to the system {\tt xxx} wrapped by the stack
94: machine.
1.4 noro 95: That is, the server may translate CMObjects into its local
96: objects and push them onto the stack. It is preferable that
1.2 noro 97: the composition of such a translation and its inverse is equal to the
1.4 noro 98: identity map. The translation scheme is called the {\it phrase book} of the
1.2 noro 99: server and it should be documented for each stack machine. In OpenXM,
1.4 noro 100: any message is private to a connection. In future we will provide a content
1.2 noro 101: dictionary (CD; see OpenMath \cite{openmath}) for basic specifications
102: of CMObjects.
103:
104: In the following, \verb+ xxx_ + may be omitted if no confusion occurs.
105: As the names of functions and tags are long, one may use abbreviated
1.4 noro 106: names. Message packets are represented as follows.
107:
108: Each field is shown as \fbox{data type \quad data}. For example {\tt
109: int32 OX\_DATA} denotes a number {\tt OX\_DATA} which is represented
110: by a 32 bit integer with the network byte order. If a field is
111: displayed by italic characters, it should be defined elsewhere or its
112: meaning should be clear. For example {\it String commandName} denotes
113: a local object {\it commandName} whose data type is String. Note that
114: an object on the stack may have a local data type even if it is
115: represented as CMO.
1.1 noro 116:
1.2 noro 117: Any server stack machine has to implement the following operations.
1.4 noro 118: For each operation we show the states of the stack before and after
119: the operation. In the figures the rightmost object corresponds to the
120: top of the stack. Only the modified part of the stack are shown.
1.2 noro 121: */
1.1 noro 122:
123: \begin{enumerate}
1.2 noro 124: \item
125: /*&jp
1.4 noro 126: CMObject/Primitive の CMO データのうち必須のもの, {\tt CMO\_ERROR2}, {\tt
1.2 noro 127: CMO\_NULL}, {\tt CMO\_INT32}, {\tt CMO\_STRING}, {\tt CMO\_LIST}がおく
128: られて来た場合それをスタックに push する. たとえば, {\tt CMO\_NULL}
129: あるいは {\tt CMO\_String} の場合次のようになる.
130: */
131: /*&eg
1.4 noro 132: Any server should accept CMObjects in the group CMObject/Primitive.
1.2 noro 133: The server pushes such data onto the stack.
134: The following examples show the states of the stack after receiving
135: {\tt CMO\_NULL} or {\tt CMO\_String} respectively.
136: */
1.1 noro 137:
1.2 noro 138: Request:
1.1 noro 139: \begin{tabular}{|c|c|} \hline
140: {\tt int32 OX\_DATA} & {\tt int32 CMO\_NULL} \\
141: \hline
142: \end{tabular}
1.2 noro 143:
144: Stack after the request:
1.1 noro 145: \begin{tabular}{|c|} \hline
146: {\it NULL} \\
147: \hline
148: \end{tabular}
149:
1.4 noro 150: Output: none.
1.2 noro 151:
1.4 noro 152: Request:\\
1.1 noro 153: \begin{tabular}{|c|c|c|c|c|c|} \hline
154: {\tt int32 OX\_DATA} & {\tt int32 CMO\_String} &{\tt int32} {\rm size}
155: &{\tt byte} {\rm s1} & $\cdots$ &{\tt byte} {\rm ssize}\\
156: \hline
157: \end{tabular}
1.2 noro 158:
159: Stack after the request:
1.1 noro 160: \begin{tabular}{|c|} \hline
161: {\it String s} \\
162: \hline
163: \end{tabular}
164:
1.4 noro 165: Output: none.
1.2 noro 166:
167: //&jp CMO データの受け取りに失敗した時のみ \\
1.4 noro 168: //&eg If the server fails to receive a CMO data,\\
1.1 noro 169: \begin{tabular}{|c|c|c|} \hline
170: {\tt int32 OX\_DATA} & {\tt int32 CMO\_ERROR2} & {\it CMObject} ob\\
171: \hline
172: \end{tabular}
173: \\
1.2 noro 174: /*&jp
1.1 noro 175: をスタックへ push する.
176: 現在のところ, ob には, \\
177: \centerline{
178: [{\sl Integer32} OX パケット番号, {\sl Integer32} エラー番号,
179: {\sl CMObject} optional 情報]
180: }
181: なるリストを入れる (CMO 形式でかいてあるが, これはサーバ独自の形式でよい.
182: CMO として送出されるときこのような形式でないといけないという意味である.)
1.2 noro 183: */
184: /*&eg
185: is pushed onto the stack.
186: Currently ob is a list\\
187: \centerline{
188: [{\sl Integer32} OX serial number, {\sl Integer32} error code,
189: {\sl CMObject} optional information]
190: }
191: */
1.1 noro 192:
193: \item
194: \begin{verbatim}
1.2 noro 195: SM_mathcap
1.1 noro 196: \end{verbatim}
1.2 noro 197: /*&jp
198: このサーバの mathcap をもどす (termcap のまね). サーバのタイプ, サー
199: バスタックマシンの能力を知ることができる. C 言語で実装する場合は,
1.4 noro 200: mathcap の構造体をシステム毎にきめるものとし,この関数はその構造体への
201: ポインタを戻す. (open sm1 では {\tt struct mathcap} を用いている.
1.2 noro 202: */
203: /*&eg
1.3 noro 204: It requests a server to push the mathcap of the server.
1.2 noro 205: The mathcap is similar to the termcap. One can know the server type
206: and the capability of the server from the mathcap.
207: */
1.1 noro 208: @plugin/mathcap.h)
1.2 noro 209:
210: Request:
1.1 noro 211: \begin{tabular}{|c|c|} \hline
212: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_mathcap} \\
213: \hline
214: \end{tabular}
1.2 noro 215:
1.3 noro 216: Stack after the request:
1.1 noro 217: \begin{tabular}{|c|c|} \hline
218: {\tt int32 OX\_DATA} & {\sl Mathcap} mathCapOb \\
219: \hline
220: \end{tabular}
221:
1.4 noro 222: Output: none.
1.3 noro 223:
1.1 noro 224: \item
225: \begin{verbatim}
1.4 noro 226: SM_setMathcap
1.1 noro 227: \end{verbatim}
1.2 noro 228: /*&jp
229: 受け取った Mathcap {\tt m} を自分のシステムに設定して, 相手側が理解不
1.4 noro 230: 能な CMO をおくらないようにする. C 言語で実装する場合は, mathcap の構
1.2 noro 231: 造体をシステム毎にきめるものとし,この関数はその構造体へのポインタを引
1.4 noro 232: 数とする. (open sm1 では {\tt struct mathcap} を用いている.
1.2 noro 233: */
234: /*&eg
1.3 noro 235: It requests a server to register the peer's mathcap {\tt m} in the server.
1.2 noro 236: The server can avoid to send OX messages unknown to its peer.
237: */
1.1 noro 238: @plugin/mathcap.h)
1.2 noro 239:
1.5 noro 240: Stack before the request:
241: \begin{tabular}{|c|} \hline
242: {\it Mathcap m} \\
243: \hline
244: \end{tabular}\\
1.2 noro 245: Request:
1.1 noro 246: \begin{tabular}{|c|c|} \hline
247: {\tt int32 OX\_DATA} & {\sl Mathcap} m \\ \hline
1.4 noro 248: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_setMathcap} \\
1.1 noro 249: \hline
250: \end{tabular}
1.2 noro 251:
1.4 noro 252: Output: none.
1.2 noro 253: /*&jp
254: \noindent
1.1 noro 255: 注意: mathcap は一般にクライアント主体で設定する.
256: クライアントがサーバに {\tt SM\_mathcap} をおくり,
257: サーバ側の mathcap を得る.
258: それを, クライアントはそのサーバに付随した mathcap として
259: 設定する.
260: 次に, クライアントはサーバに自分の mathcap を
1.4 noro 261: {\tt SM\_setMathcap} でおくり, 自分の mathcap を設定させる.
1.2 noro 262: */
263: /*&eg
264: \noindent
265: Remark: In general the exchange of mathcaps is triggered by a client.
266: A client sends {\tt SM\_mathcap} to a server and obtains the server's
267: mathcap. Then the client registers the mathcap. Finally the client
1.4 noro 268: sends its own mathcap by {\tt SM\_setMathcap} and the server
1.2 noro 269: registers it.
270: */
1.1 noro 271:
272: \item
273: \begin{verbatim}
1.2 noro 274: SM_executeStringByLocalParser
1.1 noro 275: \end{verbatim}
1.2 noro 276: /*&jp
1.3 noro 277: 文字列 {\tt s} を stack から pop し,
278: その文字列をシステム固有の文法(サーバスタックマシンの組み込みローカ
279: ル言語)にしたがったコマンドとして実行する. コマンドの実行の結
1.2 noro 280: 果の最後に戻り値があるときは, {\tt OperandStack} に戻り値を push する.
1.3 noro 281: OpenXM では, 現在のところ関数名の標準化はおこなっていない.
1.2 noro 282: この関数および {\tt popString} の機能を実現すれば, 最低限の open XM の
283: サーバになれる. 実装では, まずこの二つの関数の機能を実現すべきである.
284: */
285: /*&eg
1.3 noro 286: It requests a server to pop a character string {\tt s}, to
287: parse it by the local parser of the stack machine, and
1.4 noro 288: to interpret by the local interpreter.
289: If the execution produces a Output, it is pushed onto
1.2 noro 290: {\tt OperandStack}.
1.4 noro 291: If an error has occurred, Error2 Object is pushed onto the stack.
1.2 noro 292: OpenXM does not provide standard function names.
293: If this operation and {\tt SM\_popString} is implemented, the stack machine
1.4 noro 294: is ready to be used as an OX server.
1.2 noro 295: */
296:
297: Stack before the request:
1.1 noro 298: \\
299: \begin{tabular}{|c|} \hline
300: {\it String commandString} \\
301: \hline
302: \end{tabular}
1.2 noro 303:
304: Request:
1.1 noro 305: \begin{tabular}{|c|c|} \hline
306: {\tt int32 OX\_COMMAND}& {\tt int32 SM\_executeStringByLocalParser} \\
307: \hline
308: \end{tabular}
1.2 noro 309:
1.4 noro 310: Output: none.
1.2 noro 311: /*&jp
312: \noindent
313: 参考: \ 実行前のスタックのデータは,
1.4 noro 314: {\it String commandString} なる local stack machine の object としてス
1.2 noro 315: タック上にあるが, TCP/IP の通信路では, 次のようなデータがまずながれて
1.1 noro 316: {\it commandName} がスタックに push される:
1.2 noro 317: */
318: /*&eg
319: \noindent
320: Remark: Before this request, one has to push {\it String commandString}
321: onto the stack. It is done by sending the following OX data message.
322: */
1.1 noro 323: \begin{tabular}{|c|c|c|} \hline
324: {\tt int32 OX\_DATA} & {\tt int32 CMO\_string} & {\it size and the string commandString} \\
325: \hline
326: \end{tabular}
327:
328: \item
329: \begin{verbatim}
1.2 noro 330: SM_executeStringByLocalParserInBatchMode
1.1 noro 331: \end{verbatim}
1.2 noro 332: /*&jp
333: スタックに副作用がない(スタックにたいしてなんの操作もしない)ことを除き
334: 上とまったく同じ関数である. エラーの時のみ, Error2 Object をスタック
335: へプッシュする.
336: */
337: /*&eg
338: This is the same request as {\tt SM\_executeStringByLocalParser}
339: except that it does not modify the stack. It pushes an Error2 Object
1.4 noro 340: if an error has occurred.
1.2 noro 341: */
1.1 noro 342: \item
343: \begin{verbatim}
1.2 noro 344: SM_popString
345: \end{verbatim}
346: /*&jp
347: {\tt OperandStack} より Object を pop し, それを xxx の出力規則にしたがい文
348: 字列型に変換して送信する. スタックが空のときは, {\tt (char *)NULL} を戻す.
1.3 noro 349: 文字列は TCP/IP stream へ CMO のデー
1.2 noro 350: タとして送信する. エラーの場合は {\tt CMO\_ERROR2} を戻すべきである.
351: */
352: /*&eg
1.3 noro 353: It requests a server to pop an object from {\tt OperandStack},
1.2 noro 354: to convert it into a character string according to the output format
355: of the local system, and to send the character string via TCP/IP stream.
356: {\tt (char *)NULL} is returned when the stack is empty.
1.5 noro 357: The returned string is sent as a CMO string data.
1.4 noro 358: {\tt CMO\_ERROR2} should be returned if an error has occurred.
1.2 noro 359: */
360:
361: Stack before the request:
1.1 noro 362: \begin{tabular}{|c|} \hline
363: {\it Object} \\
364: \hline
365: \end{tabular}
1.2 noro 366:
367: Request:
1.1 noro 368: \begin{tabular}{|c|c|} \hline
369: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_popString} \\
370: \hline
371: \end{tabular}
1.2 noro 372:
1.4 noro 373: Output:
1.1 noro 374: \begin{tabular}{|c|c|c|} \hline
375: {\tt int32 OX\_DATA} & {\tt int32 CMO\_STRING} & {\it size and the string s} \\
376: \hline
377: \end{tabular}
378:
379: \item
380: \begin{verbatim}
1.2 noro 381: SM_getsp
1.1 noro 382: \end{verbatim}
1.2 noro 383: /*&jp
384: 現在のスタックポインタの位置をもどす. スタート時点での位置は 0 であり,
385: object が push されたばあい, 1 づつ増えるものとする.
386: */
387: /*&eg
1.3 noro 388: It requests a server to push the current stack pointer onto the stack.
1.2 noro 389: The stack pointer is represented by a non-negative integer.
390: Its initial value is 0 and a push operation increments the
391: stack pointer by 1.
392: */
393:
394: Stack before the request:
1.1 noro 395: \begin{tabular}{|c|} \hline
396: {\it Object} \\
397: \hline
398: \end{tabular}
1.2 noro 399:
400: Request:
1.1 noro 401: \begin{tabular}{|c|c|} \hline
402: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_getsp} \\
403: \hline
404: \end{tabular}
1.2 noro 405:
1.3 noro 406: Stack after the request:
1.1 noro 407: \begin{tabular}{|c|c|c|} \hline
408: {\tt int32 OX\_DATA} & {\tt int32 CMO\_INT32} & {\it stack pointer value} \\
409: \hline
410: \end{tabular}
411:
1.4 noro 412: Output: none.
1.3 noro 413:
1.1 noro 414: \item
415: \begin{verbatim}
1.2 noro 416: SM_dupErrors
1.1 noro 417: \end{verbatim}
1.2 noro 418: /*&jp
419: スタック上のエラーオブジェクトをリストにして戻す. スタック自体は変化
420: させない.
421: */
422: /*&eg
1.3 noro 423: It requests a server to push a list object containing all error objects on the stack.
1.2 noro 424: */
425:
426: Request:
1.1 noro 427: \begin{tabular}{|c|c|} \hline
428: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_dupErrors} \\
429: \hline
430: \end{tabular}
1.2 noro 431:
1.3 noro 432: Stack after the request:
1.1 noro 433: \begin{tabular}{|c|c|c|} \hline
434: {\tt int32 OX\_DATA} & {\sl CMObject} \ a list of errors\\
435: \hline
436: \end{tabular}
1.3 noro 437:
1.4 noro 438: Output: none.
1.6 takayama 439:
440: \item
441: \begin{verbatim}
442: SM_pushCMOtag
443: \end{verbatim}
444: /*&jp
445: スタックの先頭オブジェクトが CMO に変換された場合の CMO tag を
446: {\tt CMO\_INT32} としてスタックへ push する.
447: 先頭オブジェクトはスタックに留まる.
448: 先頭オブジェクトをCMO へ変換する方法が無い場合は, エラー object を積む.
449: */
450: /*&eg
451: It requests a server to push the CMO tag of the top object on the server
452: stack. The tag is pushed as {\tt CMO\_INT32}.
453: The top object remains on the stack.
454: If there is no way to translate the object into CMO,
455: push an error object.
456: */
457:
458: Request:
459: \begin{tabular}{|c|c|} \hline
460: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_pushCMOtag} \\
461: \hline
462: \end{tabular}
463:
464: Stack after the request:
465: \begin{tabular}{|c|c|c|} \hline
466: {\tt int32 OX\_DATA} & {\sl CMO\_INT32} \ tag\\
467: \hline
468: \end{tabular}
469:
470: Output: none.
1.1 noro 471: \end{enumerate}
472:
473: \medbreak
474: \noindent
1.2 noro 475: /*&jp
1.1 noro 476: {\bf 例}: \
477: mathcap の問い合わせに対して, {\tt ox\_sm1} は次のように答える.
1.2 noro 478: */
479: /*&eg
480: {\bf Example}: \
481: {\tt ox\_sm1} returns the following data as its mathcap.
482: */
1.4 noro 483: %%Prog: [(cmoMathcap)] extension ::
1.1 noro 484: \begin{verbatim}
485: Class.mathcap
486: [ [199909080 , $Ox_system=ox_sm1.plain$ , $Version=2.990911$ ,
487: $HOSTTYPE=i386$ ] ,
488: [262 , 263 , 264 , 265 , 266 , 268 , 269 , 272 , 273 , 275 , 276 ] ,
489: [[514] , [2130706434 , 1 , 2 , 4 , 5 , 17 , 19 , 20 , 22 , 23 , 24 ,
490: 25 , 26 , 30 , 31 , 60 , 61 , 27 , 33 , 40 , 34 ]]]
491: \end{verbatim}
492:
1.2 noro 493: /*&jp
494: mathcap は 3つの要素をもつリストである. まづ, 最初の要素を見よう.
1.7 takayama 495: 最初の数字は OpenXM プロトコルのバージョンである.
496: 現在では 1.1.3 等のバージョンが 001001003 と数字にエンコードされて
497: ここに格納される.
1.4 noro 498: Ox\_system は openXM システム名である. 読み込むライブラリがちがって
1.2 noro 499: いて, 関数名(または シンボル)の意味がちがうときはこの名前もかえる. た
500: とえば, open math の basic content dictionary 対応の関数定義マクロを読
1.4 noro 501: みこんだ sm1 は, ox\_sm1\_basicCD なる名前にする. HOSTTYPE 値は, CPU
1.2 noro 502: の種類をあらわしunix では環境変数\verb+$HOSTTYPE+ の値である. 2 番目
503: の要素は 利用可能な SM コマンドをあつめたリストである. 3 番目のリスト
504: は, 処理可能な数学データの形式, およびCMOの場合なら処理可能なCMOのタグ
505: のリストが続く. 上の例では, 514 は {\tt OX\_DATA} をあらわし, 数学デー
506: タのフォマットは(サイズ情報なしの) CMO であることを示す.
507: */
508: /*&eg
509: A mathcap has three components. The first one contains informations
1.7 takayama 510: to identify the version number of the OpenXM protocol,
511: the system and hosts on which the application runs.
1.4 noro 512: In the above example, {\tt Ox\_system} denotes the system name.
513: {\tt HOSTTYPE} represents the OS type and taken from \verb+$HOSTTYPE+
1.2 noro 514: enviroment variable.
515: The second component consists of avaiable SM commands.
516: The third component is a list of pairs. Each pair consists
1.5 noro 517: of an OX message tag and the list of available message tags.
1.2 noro 518: Again in the above example, 514 is the value of {\tt OX\_DATA}
519: and it indicates that the server accepts CMO (without size information)
520: as mathematical data messages. In this case the subsequent
521: list represents available CMO tags.
522: */
1.1 noro 523:
524: \medbreak
525: \noindent
1.2 noro 526: //&jp {\bf 例}: \
527: //&eg {\bf Example}: \
1.1 noro 528: %%Prog: (ox.sm1) run sm1connectr [(oxWatch) ox.ccc] extension
529: %%Prog: ox.ccc (122345; ) oxsubmit ;
1.2 noro 530: //&jp {\tt message\_body} の実例をあげる. シリアル番号部は除いてある.
1.3 noro 531: //&eg We show examples of {\tt message\_body}. Serial numbers are omitted.
1.1 noro 532: \begin{enumerate}
533: \item {\tt executeStringByLocalParser("12345 ;");}
1.2 noro 534: /*&jp
535: は次のようなパケットに変換される. 各数字は 16進1バイトをあらわす.
536: {\tt xx(yy)} のなかの {\tt (yy)} は対応するアスキーコードをあわらす.
537: */
538: /*&eg
1.3 noro 539: is converted into the following packet. Each number denotes
540: one byte in hexadecimal representation.
541: {\tt (yy)} in {\tt xx(yy)} represents the corresponding ASCII code.
1.2 noro 542: */
1.1 noro 543: \begin{verbatim}
544: 0 0 2 2 0 0 0 4 0 0 0 7
545: 31(1) 32(2) 33(3) 34(4) 35(5) 20 3b(;)
546: 0 0 2 1 0 0 1 c
547: \end{verbatim}
1.2 noro 548: /*&jp
1.3 noro 549: それぞれのデータの意味は次のとおりである.
550: */
551: /*&eg
552: Each data has the following meaning.
1.2 noro 553: */
1.1 noro 554:
555: \begin{verbatim}
556: 0 0 2 2 (OX_DATA) 0 0 0 4 (CMO_STRING)
557: 0 0 0 7 (size)
558: 31(1) 32(2) 33(3) 34(4) 35(5) 20 3b(;) (data)
559: 0 0 2 1 (OX_COMMAND)
560: 0 0 1 c (SM_executeStringByLocalParser)
561: \end{verbatim}
1.2 noro 562: //&jp これを OXexpression で表記すると次のようになる.
1.3 noro 563: //&eg This is expressed by OXexpression as follows.
1.1 noro 564: \begin{center}
565: (OX\_DATA, (CMO\_STRING, 7, "12345 ;"))
566: \end{center}
567: \begin{center}
568: (OX\_COMMAND, (SM\_executeStringByLocalParser))
569: \end{center}
570:
1.2 noro 571: //&jp \item {\tt popString()} を要請するメッセージ:
1.3 noro 572: //&eg \item A message which requests {\tt SM\_popString}:
1.1 noro 573: \begin{verbatim}
574: 0 0 2 1 (OX_COMMAND)
575: 0 0 1 7 (SM_popString)
576: \end{verbatim}
1.3 noro 577: //&jp OXexpression では
578: //&eg In OXexpression it is represented as
1.1 noro 579: (OX\_COMMAND, (SM\_popString)).
580:
581: \noindent
1.2 noro 582: //&jp これにたいして次の返答メッセージがくる.
1.3 noro 583: //&eg The server returns the following reply message:
1.1 noro 584: \begin{verbatim}
585: 0 0 2 2 (OX_DATA)
586: 0 0 0 4 (CMO_STRING) 0 0 0 5 (size)
587: 31(1) 32(2) 33(3) 34(4) 35(5)
588: \end{verbatim}
1.2 noro 589: //&jp OXexpression でかくと,
1.3 noro 590: //&eg In OXexpression it is represented as
1.1 noro 591: (OX\_DATA, (CMO\_STRING, 7, "12345 ;")).
592: \end{enumerate}
593:
1.4 noro 594: //&jp \subsubsection{グループ SMobject/Basic に属するオペレータ}
595: //&eg \subsubsection{Operators in the group SMobject/Basic}
1.1 noro 596:
597: \begin{enumerate}
598: \item
599: \begin{verbatim}
1.3 noro 600: SM_pops
1.1 noro 601: \end{verbatim}
1.2 noro 602: /*&jp
1.4 noro 603: operand stack より, {\it n} 個の元 ({\it obj1, obj2, $\ldots$, objn}
1.2 noro 604: を pop して捨てる.
605: */
606: /*&eg
1.3 noro 607: It requests a server to pop {\it n} and to discard elements {\it obj1, obj2,
1.5 noro 608: $\ldots$, objn} from the stack.
1.2 noro 609: */
610:
1.4 noro 611: //&jp Stack before the request: \\
612: //&eg Stack before the request: \\
1.1 noro 613: \begin{tabular}{|c|c|c|c|c|} \hline
1.4 noro 614: {\it obj1} & {\it obj2} & $\cdots$ & {\it objn} &{\it Integer32 n} \\
1.1 noro 615: \hline
616: \end{tabular}
1.2 noro 617:
618: Request:
1.1 noro 619: \begin{tabular}{|c|c|} \hline
620: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_pops } \\
621: \hline
622: \end{tabular}
1.2 noro 623:
1.4 noro 624: Output: none.
1.1 noro 625:
626:
627: \item
628: \begin{verbatim}
1.3 noro 629: int SM_setName
1.1 noro 630: \end{verbatim}
1.2 noro 631: /*&jp
632: {\tt OperandStack} より {\it name} を pop し, つぎに{\tt OperandStack}
633: より {\it obj} を pop し, それを現在の名前空間で変数 {\it name} に
634: bind する. 正常終了なら 0 を, 異常終了なら -1 をもどす. TCP/IP によ
635: る通信では, 異常終了の時のみ, {\tt CMO\_ERROR2} をstack へ push する.
636: */
637: /*&eg
1.3 noro 638: It requests a server to pop {\it name}, to pop {\it obj}, and to
1.4 noro 639: bind {\it obj} to a variable {\it name} in the current name space
640: of the server.
641: If an error has occurred {\tt CMO\_ERROR2} is pushed onto the stack.
1.2 noro 642: */
1.4 noro 643: //&jp Stack before the request:
644: //&eg Stack before the request:
1.1 noro 645: \begin{tabular}{|c|c|} \hline
646: {\it obj} & {\it String name} \\
647: \hline
648: \end{tabular}
1.2 noro 649:
650: Request:
1.1 noro 651: \begin{tabular}{|c|c|} \hline
652: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_setName} \\
653: \hline
654: \end{tabular}
1.2 noro 655:
1.4 noro 656: Output: none.
1.1 noro 657:
658: \item
659: \begin{verbatim}
1.3 noro 660: SM_evalName
1.1 noro 661: \end{verbatim}
1.3 noro 662:
1.2 noro 663: /*&jp
664: 現在の名前空間で変数 {\it name} を評価する. 評価の結果 {\it
1.4 noro 665: OutputObj} をスタックへ戻す. 関数自体は正常終了なら 0 を, 異常終了な
1.2 noro 666: ら -1 をもどす. TCP/IP の場合, 異常終了の場合のみ {\tt CMO\_ERROR2}
667: を stack へ push する.
668: */
1.3 noro 669:
1.2 noro 670: /*&eg
1.3 noro 671: It requests a server to pop {\it name} and to evaluate a variable
1.4 noro 672: {\it name} in the current name space. The Output of the evaluation
673: {\it OutputObj} is pushed to the stack.
1.5 noro 674: If an error has occurred {\tt CMO\_ERROR2} is pushed onto the stack.
1.2 noro 675: */
676:
1.4 noro 677: //&jp Stack before the request:
678: //&eg Stack before the request:
1.1 noro 679: \begin{tabular}{|c|} \hline
680: {\it String name} \\
681: \hline
682: \end{tabular}
1.2 noro 683:
684: Request:
1.1 noro 685: \begin{tabular}{|c|c|} \hline
686: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_evalName} \\
687: \hline
688: \end{tabular}
1.2 noro 689:
1.4 noro 690: //&jp Stack after the request:
691: //&eg Stack after the request:
1.1 noro 692: \begin{tabular}{|c|} \hline
1.4 noro 693: {\it OutputObj} \\
1.1 noro 694: \hline
695: \end{tabular}
1.2 noro 696:
1.4 noro 697: Output: none.
1.1 noro 698:
699: \item
700: \begin{verbatim}
1.3 noro 701: SM_executeFunction
1.1 noro 702: \end{verbatim}
1.2 noro 703: /*&jp
704: スタックより {\it n} 個のデータを pop して, サーバのローカル関数{\it
705: s} を実行する. エラーのときのみ {\tt CMO\_ERROR2} を stack へ push す
706: る.
707: */
708: /*&eg
1.3 noro 709: It requests a server to pop {\it s} as a function name,
710: to pop {\it n} as the number of arguments and to execute
711: a local function {\it s} with {\it n} arguments popped from
712: the stack.
1.4 noro 713: If an error has occurred {\tt CMO\_ERROR2} is pushed to the stack.
1.2 noro 714: */
715:
1.4 noro 716: //&jp Stack before the request: \\
717: //&eg Stack before the request: \\
1.1 noro 718: \begin{tabular}{|c|c|c|c|c|} \hline
719: {\it objn} & $\cdots$ & {\it obj1} & {\it INT32 n} & {\it String s} \\
720: \hline
721: \end{tabular}
1.2 noro 722:
723: Request:
1.1 noro 724: \begin{tabular}{|c|c|} \hline
725: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_executeFunction} \\
726: \hline
727: \end{tabular}
728:
1.2 noro 729: //&jp Stack after the request: 関数実行の結果.
1.4 noro 730: //&eg Stack after the request: The Output of the execution.
1.1 noro 731:
1.4 noro 732: Output: none.
1.1 noro 733:
734: \item
735: \begin{verbatim}
1.3 noro 736: SM_popSerializedLocalObject
1.1 noro 737: \end{verbatim}
1.3 noro 738:
1.2 noro 739: /*&jp
1.3 noro 740: スタックより pop した object を local 形式で serialization して
741: OX message として stream へ出力する. OX message tag としては,
742: local 形式に対応したものが定義されていることが必要である.
743: この関数はおもに, homogeneous な分散システムで用いる.
1.2 noro 744: */
745: /*&eg
1.3 noro 746: It requests a sever to pop an object, to convert it into a
747: serialized form according to a local serialization scheme, and
748: to send it to the stream as an OX message.
749: An OX message tag corresponding to
750: the local data format must be sent prior to the serialized data
751: itself.
752: This operation is used mainly on homogeneous distributed systems.
1.2 noro 753: */
1.1 noro 754:
755: \item
756: \begin{verbatim}
1.3 noro 757: SM_popCMO
1.1 noro 758: \end{verbatim}
759:
1.2 noro 760: /*&jp
1.3 noro 761: {\tt OperandStack} より object を pop し CMO 形式の serialized object を
762: stream へ header {\tt OX\_DATA} をつけてながす.
1.2 noro 763: */
764: /*&eg
1.3 noro 765: It requests a server to pop an object from the stack, to convert
766: it into a serialized form according to the standard CMO encoding scheme,
767: and to send it to the stream with the {\tt OX\_DATA} header.
1.2 noro 768: */
769:
770: Request:
1.1 noro 771: \begin{tabular}{|c|c|} \hline
772: {\tt int32 OX\_COMMAND} & {\tt int32 OX\_popCMO} \\
773: \hline
774: \end{tabular}
1.2 noro 775:
1.4 noro 776: Output:
1.1 noro 777: \begin{tabular}{|c|c|} \hline
778: {\tt int32 OX\_DATA} & {\it Serialized CMO} \\
779: \hline
780: \end{tabular}
781:
782: \end{enumerate}
783:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to stackmachine.tex CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [local] / OpenXM / doc / OpenXM-specs