rfc2372.txt

很多RFC的中文文档

   到远处处理管理器TIP URL的指针。一个处理管理器的TIP URL采用格式：
   TIP://<主机>[:<端口>]
   plocal_xid [in]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。
   pxid_url [out]
   到联结远处处理TIP URL的指针。一个处理的TIP URL采用格式：
   TIP://<主机>[:<端口>]/<处理标识符>
   url_length [in]
   远处处理URL缓存的字节大小
 
   形容
   tip_push() 输出（推）一个本地处理到远端节点。如果一个远处处理校验符没有
   被提供，则调用者的当前处理上下文被使用。这个调用返回一个TIP URL给已联结
   的远处处理。这个TIP处理校验符可能在应用请求上被传递到远处节点（作为一个
   TIP URL的一部分）。为了代表此处理的利益起作用，接收的进程使用这个信息。

   返回值
   [TIPOK]
   处理已被成功地推到远处节点。 
   [TIPINVALIDXID]
   一个无效的处理校验符已经被提供。
   [TIPNOCURRENTTX]
   当前进程没有和一个处理相联结。
   [TIPINVALIDHANDLE]
   无效的连接句柄指定。
   [TIPNOTPUSHED]
   处理不能被推到远处节点。
   [TIPNOTCONNECTED]
   调用者已经失去与TIP TM的连接。
   [TIPINVALIDURL]
   无效的端点URL被提供。
   [TIPTRANSIENT]
   短暂的错误发生，重试操作。
   [TIPTRUNCATED]
   TIP处理校验符的不足缓冲尺寸被指定。	
   [TIPERROR]
   一个不期望的错误发生。
 
4) tip_pull() - 创建一个本地处理并将它与TIP处理连接起来。

   概要
   int tip_pull([in] tip_handle_t TM,
                [in] char *pxid_url,
                [out] void *plocal_xid,
                [in] unsigned int xid_length)
   
   参数
   TM [in]
   此TIP TM的句柄。
   pxid_url [in]
   到联结远处处理TIP URL的指针。一个处理的TIP URL采用格式：
   TIP://<主机>[:<端口>]/<处理校验符>
   plocal_xid [out]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。
   xid_length [in]
   本地处理标识符缓存的字节大小。

   形容
   tip_pull()创建了一个本地处理并将本地处理和TIP处理连接起来（在此TIP处理中
   调用者成为次一级的参与者）。远处的TIP TM通过URL(*pxid_url)来识别。这个本
   地处理的校验符被返回。如果一个本地处理已经为了已提供的TIP处理校验符而创建，
   那么[TIPOK]被返回（和本地处理校验符一起），并且没有别的操作被执行。

   返回值
   [TIPOK]
   本地处理已经被成功创建，且已和TIP处理连接。
   [TIPINVALIDHANDLE]
   无效的连接句柄指定。
   [TIPTRUNCATED]
   本地处理校验符的不足缓冲尺寸被指定。	
   [TIPNOTPULLED]
   本地处理和TIP处理之间的连接已失败。
   [TIPNOTCONNECTED]
   调用者已经失去与TIP TM的连接。
   [TIPINVALIDURL]
   无效的端点URL被提供。
   [TIPTRANSIENT]
   短暂的错误发生，重试操作。
   [TIPERROR]
   一个不期望的错误发生。

5) tip_pull_async() - 创建了一个本地处理并将本地处理和TIP处理连接起来.一个本
                      地处理一被创建，控制就被返回到调用者。

   概要
   int tip_pull_async ([in] tip_handle_t TM
                       [in] char *pxid_url,
                       [out] void *plocal_xid,
                       [in] unsigned int xid_length)

   参数
   TM [in]
   TIP网关句柄
   pxid_url [in]
   到联结远处处理TIP URL的指针。一个处理的TIP URL采用格式：
   TIP://<主机>[:<端口>]/<处理校验符>
   plocal_xid [out]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。
   xid_length [in]
   本地处理标识符缓存的字节大小。

   形容
   tip_pull()创建了一个本地处理并将本地处理和TIP处理连接起来（在此TIP处理中
   调用者成为下一级的参与者）。远处的TIP TM通过URL(*pxid_url)来校验。这个本
   地处理的校验符被返回。在此本地处理已经被创建（在TIP PULL协议指令发送之前）
   之后，一个对tip_pull_async()的调用立即返回。一个后来的对tip_pull_complete()
   的调用必须得到发布，用来检查PULL请求的完成成功与否。

   返回值
   [TIPOK]
   本地处理已被成功创建。 
   [TIPINVALIDHANDLE]
   无效的连接句柄指定。
   [TIPNOTCONNECTED]
   使用者已经失去与TIP TM的连接。
   [TIPINVALIDURL]
   无效的端点URL被提供。
   [TIPTRANSIENT]
   短暂的错误发生，重试操作。
   [TIPTRUNCATED]
   本地处理校验符的不足缓冲尺寸被指定。	
   [TIPERROR]
   一个不期望的错误发生。

6) tip_pull_complete() - 检查一个先前的tip_pull_async()请求是否已被成功完成。

   概要
   int tip_pull_complete ([in] tip_handle_t TM,
                          [in] void *plocal_xid)
   参数
   TM [in]
   此TIP TM的句柄。
   plocal_xid [in]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。

   形容
   tip_pull_complete()检查一个先前的对tip_pull_async()调用是否已被成功完成。
   即是否本地处理已经成功地和TIP处理连接在一起。调用者提供由先前对       
tip_pull_async()的调用返回的本地处理校验符。对同一个本地处理校验符的
   tip_pull_complete()的重复调用是等幂的。

   返回值
   [TIPOK]
   本地处理已成功地和TIP处理连接。 
   [TIPINVALIDHANDLE]
   无效的连接句柄指定。
   [TIPINVALIDXID]
   一个无效的处理校验符已经被提供。
   [TIPNOTPULLED]
   和TIP处理相连接的本地处理已经失败。本地处理已经被废弃。
   [TIPNOTCONNECTED]
   调用者已经失去与TIP TM的连接。
   [TIPERROR]
   一个不期望的错误发生。
       
7) tip_xid_to_url() - 返回一个TIP处理校验符作为一个本地校验标识符。

   概要
   int tip_xid_to_url ([in] tip_handle_t TM,
                       [in] void *plocal_xid,
                       [out] char *pxid_url,
                       [in] unsigned int url_length)

   参数
   TM [in]
   此TIP TM的句柄。
   plocal_xid [in]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。
   pxid_url [out]
   到本地处理TIP URL的指针。一个处理的TIP URL采用格式：
   TIP://<主机>[:<端口>]/<处理标识符>
   url_length [in]
   TIP URL缓存的字节大小。

   形容
   tip_xid_to_url()返回一个TIP处理校验符作为一个本地处理校验符。这个TIP处理
   校验符能被传递到远处应用来使它们在处理上起作用。例如，拉本地处理到此远处节
   点。如果一个本地处理校验符没有被提供，那么调用者当前的处理上下文被使用。常
   数TIPURLSIZE定义了一个TIP处理校验符的字节大小。这个值是实现的细节。

   返回值 
   [TIPOK]
   TIP处理标识符已被返回。
   [TIPNOTCONNECTED]
   调用者已经失去与TIP TM的连接。
   [TIPNOCURRENTTX]
   当前的进程没有和一个处理（且一个都没有被提供）相联结。
   [TIPINVALIDXID]
   一个无效本地处理校验符已被提供。
   [TIPTRUNCATED]
   TIP处理校验符的不足缓冲尺寸被指定。	
   [TIPERROR]
   一个不期望的错误发生。

8) tip_url_to_xid() -  返回一个本地处理校验符作为一个TIP处理校验符。

   概要
   int tip_url_to_xid ([in] tip_handle_t TM,
                       [in] char *pxid_url,
                       [out] void *plocal_xid,
                       [in] unsigned int xid_length)
   参数
   TM [in]
   此TIP TM的句柄。
   pxid_url [in]
   到本地处理TIP URL的指针。一个处理的TIP URL采用格式：
   TIP://<主机>[:<端口>]/<处理标识符>
   plocal_url [out]
   到本地处理校验符的指针。处理校验符的结构是由本地处理管理器来定义的。
   xid_length [in]
   本地处理校验符缓存的字节大小。

   形容
   tip_url_to_xid()返回一个本地处理校验符作为一个TIP处理校验符（注意本地处理
   必须先前已通过一个tip_push()，或者tip_pull()(或者 tip_pull_async())创建。
   常数TIPXIDSIZE定义了一个TIP处理校验符的字节大小。这个值是实现的细节。

   返回值
   [TIPOK]
   TIP处理校验符已被返回。
   [TIPINVALIDURL]
   一个无效TIP处理校验符已被提供。
   [TIPTRUNCATED]
   本地处理校验符的不足缓冲尺寸被指定。	
   [TIPERROR]
   一个不期望的错误发生。
9) tip_get_tm_url() - 以TIP URL的格式得到本地TIP处理管理器的名字。
   概要
   int tip_get_tm_url ([in] tip_handle_t TM,
                        [out] char *tm_url,
                        [in] int tm_len);
   参数
   TM[in]
   此TIP TM句柄。
   tm_url [in]
   到本地处理管理器TIP URL的指针。一个处理管理器的TIP URL采用格式：
   TIP://<主机>[:<端口>]
   tm_len [out]
   本地处理管理器TIP URL缓存的字节大小。

   形容
   tip_get_tm_url()以TIP URL的格式得到本地TIP处理管理器的名字（即
   TIP://<主机>[:<端口>]）。

   返回值
   [TIPOK]
   本地处理管理器的名字已被成功返回。
   [TIPTRUNCATED]
   由于缓冲尺寸不足，本地处理管理器的名字已被截短。用更大的缓冲尺寸去重
   试操作。

版权声明
   Copyright (C) The Internet Society (1998).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

RFC2372—Transaction Internet Protocol - Requirements and Supplemental Information
处理internet协议（TIP）-要求和补充信息


1
RFC文档中文翻译计划