=================================================================== 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 @@ Mathcap ¤ò¼õ¤±¼è¤ë¡£¸½ºß¤Ï Mathcap ¤Î½èÍý¤Ï¥æ¡¼¥¶¥×¥í¥ 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 @@ void send_ox_command(int fd, int sm_command); 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