=================================================================== RCS file: /home/cvs/OpenXM/src/ox_toolkit/README,v retrieving revision 1.4 retrieving revision 1.5 diff -u -p -r1.4 -r1.5 --- OpenXM/src/ox_toolkit/README 1999/12/15 08:04:50 1.4 +++ OpenXM/src/ox_toolkit/README 1999/12/15 09:24:46 1.5 @@ -1,6 +1,6 @@ # Author: 小原功任 @ 金沢大学理学部計算科学教室 # URI: http://omega.s.kanazawa-u.ac.jp/ohara/ -# $OpenXM: OpenXM/src/ox_toolkit/README,v 1.3 1999/12/15 02:44:12 ohara Exp $ +# $OpenXM: OpenXM/src/ox_toolkit/README,v 1.4 1999/12/15 08:04:50 ohara Exp $ /*&ja ox_toolkit ユーザガイド @@ -190,25 +190,24 @@ void ox_shutdown(ox_file_t sv); /* /*&ja 3.3 SM コマンドの送信 - */ /*&en 3.3 How to command to OpenXM stack machine? - */ /*&common + void ox_push_cmd(ox_file_t sv, int sm_code); */ /*&ja サーバにスタックマシンコマンドを送る。コマンドはコマンド番号で与える。 - */ /*&en -This function send operation code to an OpenXM stack machine. +ox_push_cmd() sends an operation code to an OpenXM stack machine. Table of opecode is defined in oxtag.h. */ /*&ja + 3.4 CMO の送受信 void ox_push_cmo(ox_file_t sv, cmo *c); @@ -255,23 +254,25 @@ cmo_mathcap* ox_mathcap(ox_file_t sv); Mathcap を受け取る。現在は Mathcap の処理はユーザプログラムに任されている。 いずれこの関数は廃止される予定。 - */ /*&ja + 4. 低水準 API 低水準 API はファイルディスクリプタを直接利用する。 4.1 通信に使われるバイトオーダの決定 - */ /*&en + 4. Low-level API. -4.1 How to decide a byte order of integers? +In this section, ``fd'' is an identifier of an OpenXM connection. +4.1 How to decide a byte order of integers? */ /*&common + int decideByteOrderServer(int fd, int order); */ @@ -281,59 +282,75 @@ int decideByteOrderServer(int fd, int order); いる。詳しくは、高山-野呂, "OpenXM の設計と実装" を参照せよ。 (注意) クライアント側でのバイトオーダの設定は、高水準 API で自動的に行われる。 - */ +/*&en +You must call it when your OpenXM server is initialized. +This function always choose the network byte order for integers. +*/ /*&common + 4.2 int send_int32(int fd, int integer); - -*/ -/*&ja -fd に 32bit 整数を書き込む。 - -*/ -/*&common int receive_int32(int fd); */ /*&ja +fd に 32bit 整数を書き込む。 fd から 32bit 整数を読み込む。 - */ +/*&en +send_int32() writes 32bits integer to an OpenXM connection. +receive_int32() reads 32bits integer from an OpenXM connection. +*/ /*&common + 4.3 int send_cmo(int fd, cmo* m); +cmo* receive_cmo(int fd); */ /*&ja fd に cmo を書き込む。 - +fd から cmo を読み込む。 */ +/*&en +send_cmo() writes an CMObject to an OpenXM connection. +receive_cmo() reads an CMObject from an OpenXM connection. +*/ /*&common -cmo* receive_cmo(int fd); -*/ -/*&ja -fd から cmo を読み込む。 - 4.4 int next_serial(); +*/ +/*&ja シリアルナンバを生成する。 +*/ +/*&en +next_serial() generates serial number for ox message. +*/ +/*&common 4.5 int send_ox_tag(int fd, int tag); - -fd に OX メッセージのヘッダ(tag+id)を書き込む。 -シリアル番号は自動的に生成される。 - int receive_ox_tag(int fd); -fd から OX メッセージのヘッダ(tag+id)を読み込む。 +*/ +/*&ja +fd に OX メッセージのヘッダ(tag+serial#)を書き込む。シリアル番号は +自動的に生成される。 +fd から OX メッセージのヘッダ(tag+serial#)を読み込む。 +*/ +/*&en +send_ox_tag() writes a tag and automatically generated serial number +of an ox message to an OpenXM conection. +receive_ox_tag() reads a tag and serial number of an ox message. +*/ +/*&common 4.6 @@ -341,5 +358,7 @@ int send_ox(int fd, ox* m); int send_ox_cmo(int fd, cmo* m); void send_ox_command(int fd, int sm_command); +*/ +/*&ja ox メッセージを送信する。 */ \ No newline at end of file