=================================================================== RCS file: /home/cvs/OpenXM/src/ox_toolkit/README,v retrieving revision 1.11 retrieving revision 1.12 diff -u -p -r1.11 -r1.12 --- OpenXM/src/ox_toolkit/README 2000/10/10 05:23:19 1.11 +++ OpenXM/src/ox_toolkit/README 2000/10/10 06:52:13 1.12 @@ -1,6 +1,6 @@ # Author: ¾®¸¶¸ùǤ @ ¶âÂôÂç³ØÍý³ØÉô·×»»²Ê³Ø¶µ¼¼ # URI: http://omega.s.kanazawa-u.ac.jp/ohara/ -# $OpenXM: OpenXM/src/ox_toolkit/README,v 1.10 2000/03/10 12:24:38 ohara Exp $ +# $OpenXM: OpenXM/src/ox_toolkit/README,v 1.11 2000/10/10 05:23:19 ohara Exp $ /*&ja ox_toolkit ¥æ¡¼¥¶¥¬¥¤¥É @@ -129,7 +129,7 @@ new_cmo_error2(cmo* ob); */ /*&ja -2.5 ¥³¥Í¥¯¥·¥ç¥ó +3. ¥³¥Í¥¯¥·¥ç¥ó OXFILE ¤Ï OpenXM ¤Ç¤ÎÄÌ¿®Ï©¤òɽ¸½¤¹¤ë¥¯¥é¥¹¤Ç¤¢¤ë¡£¤³¤Î¥¯¥é¥¹¤Î¥ª¥Ö¥¸¥§ ¥¯¥È¤òÌÀ¼¨Åª¤Ë¤ÏÀ¸À®¤·¤Ê¤¤¤³¤È¡£É¬¤º¥³¥ó¥¹¥È¥é¥¯¥¿¤òÍøÍѤ·¤Ê¤±¤ì¤Ð¤Ê¤é @@ -137,40 +137,66 @@ OXFILE ¤Ï OpenXM ¤Ç¤ÎÄÌ¿®Ï©¤òɽ¸½¤¹¤ë¥¯¥é¥¹¤Ç¤¢¤ë¡£¤³¤ ¥Ð¥¤¥È¥ª¡¼¥À¤Ë´ØÏ¢¤·¤¿½èÍý¤Ï¤³¤Î¥¯¥é¥¹¤Î¥á¥½¥Ã¥É¤Ç¼Â¸½¤µ¤ì¤ë¡£¤³¤Î¥¯¥é ¥¹¤Î¥á¥½¥Ã¥É¤È¤·¤Æ¼¡¤Î¤â¤Î¤¬ÍÑ°Õ¤µ¤ì¤Æ¤¤¤ë¡£ -2.5.1 ¥³¥ó¥¹¥È¥é¥¯¥¿ +3.1 ¥³¥ó¥¹¥È¥é¥¯¥¿ + OXFILE *oxf_connect_active(char *hostname, short port); + +ǽưŪ¤ËÀܳ¤¹¤ë¾ì¹ç¤Î¥³¥ó¥¹¥È¥é¥¯¥¿¡£Ä̾¥µ¡¼¥Ð¤ÇÍøÍѤ¹¤ë¡£ + OXFILE *oxf_connect_passive(int listened); + +¼õưŪ¤ËÀܳ¤¹¤ë¤¿¤á¤Î¥³¥ó¥¹¥È¥é¥¯¥¿¡£ +ÆâÉô¤Ç accept() ¤ò¸Æ¤Ö¤Î¤Ç¡¢listened ¤Ë¤Ï mysocketListen() ¤ÎÊÖ¤·¤¿Ãͤ¬É¬Íס£ + OXFILE *oxf_open(int fd); -2.5.2 ǧ¾Ú¤Ë´ØÏ¢¤·¤¿¥á¥½¥Ã¥É +¥¤¥ó¥¹¥¿¥ó¥¹¤òÀ¸À®¤¹¤ë¤À¤±¤Ç¡¢Àܳ¤Ï¹Ô¤ï¤Ê¤¤¡£¤¹¤Ç¤Ë¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡ +¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò fd ¤Ë»ØÄꤹ¤ë¡£·×»»¥µ¡¼¥Ð¤Ç¤ÎÍøÍѤòÁÛÄê¡£ + +3.2 ǧ¾Ú¤Ë´ØÏ¢¤·¤¿¥á¥½¥Ã¥É + int oxf_confirm_client(OXFILE *oxfp, char *passwd); + +¥¯¥é¥¤¥¢¥ó¥È¦¤Ç¤Îǧ¾Ú¤ò¹Ô¤¦¡£ÊÖ¤êÃͤ¬1¤Î¤È¤­¤ËÀ®¸ù¡¢0¤Î¤È¤­¤Ë¼ºÇÔ¡£ + int oxf_confirm_server(OXFILE *oxfp, char *passwd); + +¥µ¡¼¥Ð¦¤Ç¤Îǧ¾Ú¤ò¹Ô¤¦¡£¾ï¤ËÀ®¸ù¤¹¤ë¡£ + void oxf_determine_byteorder_client(OXFILE *oxfp); void oxf_determine_byteorder_server(OXFILE *oxfp); + +oxfp ¤Î»Ø¤¹ÄÌ¿®Ï©¤Ç¤Î¥Ð¥¤¥È¥ª¡¼¥À¤ò·èÄꤷ¡¢oxfp ¤Î¥¤¥ó¥¹¥¿¥ó¥¹¤ò½ñ¤­´¹¤¨¤ë¡£ + void oxf_setopt(OXFILE *oxfp, int mode); -2.5.3 ¤½¤Î¾¤Î¥á¥½¥Ã¥É +oxfp ¤ÎÀßÄê¤ò¹Ô¤¦¡£oxf_determine_byteorder_XXX() ¤ÇÍѤ¤¤é¤ì¤Æ¤¤¤ë¡£ + +3.3 ¤½¤Î¾¤Î¥á¥½¥Ã¥É + int oxf_read(void *buffer, size_t size, size_t num, OXFILE *oxfp); int oxf_write(void *buffer, size_t size, size_t num, OXFILE *oxfp); void oxf_flush(OXFILE *oxfp); void oxf_close(OXFILE *oxfp); +fread, fwrite, fflush, fclose ¤Ë½àµò¡£ + */ /*&ja -3. ¹â¿å½à API(¤³¤Îµ­½Ò¤Ï¸Å¤¤¤Î¤Ç»È¤ï¤Ê¤¤¤³¤È) +4. ¹â¿å½à API(¤³¤Îµ­½Ò¤Ï¸Å¤¤¤Î¤Ç»È¤ï¤Ê¤¤¤³¤È) ¹â¿å½à API ¤Ï¡ÖOpenXM ¥¯¥é¥¤¥¢¥ó¥È¡×¤«¤éÍøÍѤ¹¤ë¤³¤È¤òÁ°Äó¤ËÀ߷פµ¤ì¤Æ¤¤¤ë¡£ -3.1 ÄÌ¿®¤Î³«»Ï +4.1 ÄÌ¿®¤Î³«»Ï ÄÌ¿®¤ò³«»Ï¤¹¤ë¾ì¹ç¤Ë¤Ï¡¢¼¡¤Î´Ø¿ô¤Î¤¤¤º¤ì¤«¤òÍøÍѤ¹¤ë¡£ */ /*&en -3. High-level API +4. High-level API High-level API is prepared to help an implementation of OpenXM clients. -3.1 How to make connections to OpenXM servers? +4.1 How to make connections to OpenXM servers? In order to open a connection to an OpenXM server, you need to call ox_start() or to call ox_start_insecure_nonreverse(). @@ -208,13 +234,13 @@ OpenXM server run on a remote host and you need to pro */ /*&ja -3.2 ÄÌ¿®¤Î½ªÎ» +4.2 ÄÌ¿®¤Î½ªÎ» ÄÌ¿®¤Î½ªÎ»¤Î¤¿¤á¤Ë¤Ï¼¡¤ÎÆó¤Ä¤Î´Ø¿ô¤¬ÍÑ°Õ¤µ¤ì¤Æ¤¤¤ë¡£ */ /*&en -3.2 How to close connections to OpenXM servers? +4.2 How to close connections to OpenXM servers? In order to close a connection to an OpenXM server, you need to call ox_close() or to call ox_shutdown(). @@ -232,10 +258,10 @@ void ox_shutdown(OXFILE *sv); */ /*&ja -3.3 SM ¥³¥Þ¥ó¥É¤ÎÁ÷¿® +4.3 SM ¥³¥Þ¥ó¥É¤ÎÁ÷¿® */ /*&en -3.3 How to command to OpenXM stack machines? +4.3 How to command to OpenXM stack machines? */ /*&common @@ -252,10 +278,10 @@ See OpenXM/include/ox_toolkit_tags.h for a list of ope */ /*&ja -3.4 CMO ¤ÎÁ÷¼õ¿® +4.4 CMO ¤ÎÁ÷¼õ¿® */ /*&en -3.4 How to receive a CMO? +4.4 How to receive a CMO? */ /*&common @@ -273,7 +299,7 @@ ox_push_cmo ¤Ï cmo ¤òÁ÷¿®¡¢ox_pop_cmo ¤Ï cmo ¤ò¼õ¿®¤¹¤ /*&en */ /*&ja -3.5 ¥¹¥¿¥Ã¥¯½èÍý +4.5 ¥¹¥¿¥Ã¥¯½èÍý */ /*&common @@ -285,7 +311,7 @@ int ox_pops(OXFILE *sv, int num); */ /*&ja -3.6 ÄÌ¿®Ï©¤Î¥Õ¥é¥Ã¥·¥å +4.6 ÄÌ¿®Ï©¤Î¥Õ¥é¥Ã¥·¥å */ /*&common @@ -297,7 +323,7 @@ int ox_flush(OXFILE *sv); */ /*&ja -3.7 ÄÌ¿®¤ÎÃæÃÇ +4.7 ÄÌ¿®¤ÎÃæÃÇ */ /*&common @@ -309,7 +335,7 @@ void ox_reset(OXFILE *sv); */ /*&ja -3.8 ¥í¡¼¥«¥ë¸À¸ì¤Ç½ñ¤«¤ì¤¿¥³¥Þ¥ó¥É¤Îɾ²Á +4.8 ¥í¡¼¥«¥ë¸À¸ì¤Ç½ñ¤«¤ì¤¿¥³¥Þ¥ó¥É¤Îɾ²Á */ /*&common @@ -321,7 +347,7 @@ void ox_execute_string(OXFILE *sv, char* str); */ /*&ja -3.9 ´Ø¿ô¸Æ¤Ó½Ð¤· +4.9 ´Ø¿ô¸Æ¤Ó½Ð¤· */ /*&common @@ -333,7 +359,7 @@ function(argv[1], ...) ¤ò·×»»¤·¡¢·ë²Ì¤ò¥¹¥¿¥Ã¥¯¤ËÀѤࡠ*/ /*&ja -3.10 Mathcap ¤Î¼õ¿® +4.10 Mathcap ¤Î¼õ¿® */ /*&common @@ -346,19 +372,19 @@ Mathcap ¤ò¼õ¤±¼è¤ë¡£¸½ºß¤Ï Mathcap ¤Î½èÍý¤Ï¥æ¡¼¥¶¥×¥í¥ */ /*&ja -4. Äã¿å½à API +5. Äã¿å½à API Äã¿å½à API ¤Ï¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òľÀÜÍøÍѤ¹¤ë¡£ -4.1 ÄÌ¿®¤Ë»È¤ï¤ì¤ë¥Ð¥¤¥È¥ª¡¼¥À¤Î·èÄê +5.1 ÄÌ¿®¤Ë»È¤ï¤ì¤ë¥Ð¥¤¥È¥ª¡¼¥À¤Î·èÄê */ /*&en -4. Low-level API. +5. Low-level API. In this section, ``fd'' is an identifier of an OpenXM connection. -4.1 How to decide a byte order of integers? +5.1 How to decide a byte order of integers? */ /*&common @@ -379,7 +405,7 @@ as an expression for integers. */ /*&common -4.2 +5.2 */ /*&common @@ -397,7 +423,7 @@ receive_int32() reads 32bits integer from an OpenXM co */ /*&common -4.3 +5.3 */ /*&common @@ -415,7 +441,7 @@ receive_cmo() reads an CMObject from an OpenXM connect */ /*&common -4.4 +5.4 */ /*&common @@ -430,7 +456,7 @@ next_serial() generates a serial number for ox message */ /*&common -4.5 +5.5 */ /*&common @@ -450,7 +476,7 @@ receive_ox_tag() reads a tag and a serial number of an */ /*&common -4.6 Sending OX messages. +5.6 Sending OX messages. */ /*&common @@ -465,12 +491,12 @@ OX ¥á¥Ã¥»¡¼¥¸¤òÁ÷¿®¤¹¤ë¡£ /*&ja -5. OX expression ¥Ñ¡¼¥µ +6. OX expression ¥Ñ¡¼¥µ */ /*&en -5. Parser for OX expressions +6. Parser for OX expressions */ /*&ja @@ -484,11 +510,11 @@ encoded OX/CMO expression. In this section, we explai */ /*&en -5.1 Setting an option +6.1 Setting an option */ /*&ja -5.1 ¥ª¥×¥·¥ç¥ó +6.1 ¥ª¥×¥·¥ç¥ó */ /*&common @@ -505,11 +531,11 @@ expressios. */ /*&en -5.2 Initializing +6.2 Initializing */ /*&ja -5.2 ½é´ü²½ +6.2 ½é´ü²½ */ /*&common @@ -524,11 +550,11 @@ We give the parser an OX/CMO expression, that is, a Li */ /*&en -5.3 Getting an object +6.3 Getting an object */ /*&ja -5.3 ·ë²Ì¤òÆÀ¤ë +6.3 ·ë²Ì¤òÆÀ¤ë */ /*&common