开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > VxWorks > 查看源码
wtx.h
资源名称：ixp425BSP.rar　[点击查看]
上传用户：luoyougen
上传日期：2008-05-12
资源大小：23136k
文件大小：41k
源码类别：

VxWorks

开发平台：

C/C++

wtx.h：源码内容
  1. /* wtx.h - wtx protocol header file */
  3. /* Copyright 1984-2001 Wind River Systems, Inc. */
  5. /*
  6. modification history
  7. --------------------
  8. 03v,10dec01,sn   include demanglerTypes.h instead of demangler.h (so that safe
  9.                  for gdb to include)
  10. 03u,04dec01,sn   added wtxDefaultDemanglerStyle
  11. 03t,05dec01,fle  added Object directory retirving to wtxCpuInfoGet ()
  12. 03s,04oct01,c_c  Added wtxToolNameGet API.
  13. 03r,11sep01,fle  added declaration of wtxEnvironRegistryOptionsGet () routine
  14. 03q,06feb01,dtr  Adding check for altivec support.
  15. 03p,25may99,fle  added WTX_SVR_TYPE enum  SPR 67367
  16. 03o,23feb99,c_c  Implemented an API to get the target IP address (SPR #25044).
  17. 03n,22sep98,l_k  Removed wtxFindExecutable.
  18. 03m,21sep98,l_k  Implement wtxFindExecutable.
  19. 03l,18sep98,pcn  Implement wtxObjModuleInfoAndPathGet.
  20. 03k,18aug98,pcn  Use WTX_MSG_EVTPT_LIST_2.
  21. 03j,20jul98,pcn  Added evtptNum and toolId in the wtxEventpointListGet return
  22.  list.
  23. 03i,06jul98,pcn  Removed wtxObjModuleUndefSymAdd from API.
  24. 03h,19jun98,pcn  Added wtxObjModuleLoadStart, wtxObjModuleLoadProgressReport,
  25.  wtxObjModuleLoadCancel.
  26. 03g,11jun98,pcn  Added an input parameter at wtxEventListGet.
  27. 03f,09jun98,jmp  added wtxAsyncResultFree and wtxAsyncEventGet().
  28. 03e,03jun98,pcn  Added 2 requests: wtxSymListByModuleNameGet and
  29.  wtxSymListByModuleIdGet.
  30. 03d,25may98,pcn  Changed wtxTsLock in wtxTsTimedLock, wtxEventpointList_2 in
  31.  wtxEventpointListGet, wtxObjModuleUnload_2 in
  32.  wtxObjModuleUnloadByName.
  33. 03c,30apr98,dbt  added wtxHwBreakpointAdd and wtxEventpointAdd.
  34. 03b,28apr98,pcn  Removed wtxCommandSend.
  35. 03a,23apr98,fle  added CPU name retrieving to wtxCpuInfoGet
  36. 02z,21apr98,fle  added wtxCpuInfoGet()
  37. 02y,26mar98,pcn  WTX 2: added a new parameter in wtxLogging.
  38. 02x,03mar98,fle  got rid of wtxRegistryPing() function declaration
  39. 02w,02mar98,pcn  WTX 2: moved WTX_LD_M_FILE_DESC in wtxMsg.h. Added
  40.  WTX_EVTPT_LIST_2 definition. Added wtxAsyncNotifyEnable,
  41.  wtxAsyncNotifyDisable, wtxCacheTextUpdate, wtxCommandSend,
  42.  wtxEventListGet, wtxEventpointList_2, wtxLogging,
  43.  wtxMemWidthRead, wtxMemWidthWrite, wtxObjModuleChecksum,
  44.  wtxObjModuleLoad_2, wtxObjModuleUnloa wtxUnregisterForEvent.
  45.  Changed wtxTargetRtTypeGet, wtxTargetCpuTypeGet return type.
  46. 02v,29jan98,fle  added wtxRegistryPing() declaration
  47.  + added WTX_REGISTRY_PING_INTERVAL definition
  48. 02u,28jan98,c_c  Packed all wtxEvtxxxStringGet routines into one.
  49. 02t,29aug97,fle  Adding the WTX_MEM_DISASSEMBLE service
  50.  + got rid of old C style declaration (only STDC remains)
  51. 02s,30sep96,elp  put in share/, added wtxObjModuleUndefSymAdd(),
  52.  wtxSymAddWithGroup() (SPR# 6775).
  53. 02r,27sep96,sjw  correct prototype for wtxTsVersionGet, was wtsTsVersionGet
  54. 02q,18sep96,dgp  doc: change spelling of alignement to alignment for API Guide
  55.  in wtxMemAlign
  56. 02p,05sep96,elp  changed val in wtxMemSet() from UINT8 to UINT32 (SPR# 6984).
  57. 02o,02sep96,jmp  added wtxToolIdGet() prototypes,
  58.  added WTX RPC service number argument to wtxServiceAdd().
  59. 02n,30aug96,elp  changed wpwrVersionGet() into wtxTsVersionGet().
  60. 02m,17jun96,p_m  changed type of flags parameter in wtxFileOpen() (SPR# 4941).
  61. 02l,30may96,elp  added wtxToolNameGet(), wpwrVersionGet(), wtxServiceAdd() and
  62.  wtxSymTblInfoGet() prototypes (SPR# 6502).
  63. 02k,09nov95,p_m  removed un-necessary version defines.
  64. 02h,03nov95,jmp  added wtxErrSet() prototype.
  65. 02g,25oct95,p_m  added wtxAgentModeGet() (SPR# 5231) and wtxDirectCall().
  66. 02f,26sep95,s_w  rename wtxBreakpointDelete() to wtxEventpointDelete() 
  67.  (SPR 4852)
  68. 02e,05sep95,s_w  add WTX_LD_M_FILE_DESC type and change wtxObjModuleLoad()
  69.  prototype (for SPR 4598)
  70. 02d,08jun95,c_s  added wtxTargetAttach().
  71. 02c,02jun95,p_m  added WTX_PROTOCOL_VERSION.
  72. 02b,01jun95,p_m  replaced isText by contextType and added returnType in 
  73.  WTX_CONTEXT_DESC. Changed wtxFuncCall() parameters to 
  74.  WTX_CONTEXT_DESC.
  75. 02a,26may95,s_w  add wtxSymListGet(), wtxSymRemove(), wtxEventpointList(),
  76.  wtxMemScan(), wtxVioFileList(), wtxContextExitNotifyAdd()
  77.  and correct the K&R prototype for wtxStrToEventType().
  78. 01z,22may95,s_w  add wtxTsRestart(), wtxVioChanGet() and wtxVioChanRelease().
  79. 01y,22may95,jcf  name revision.
  80. 01x,14may95,s_w  Removed use of WTX messages in API calls and added extra
  81.  target info routines. Use exchange API to make calls.
  82. 01w,15may95,c_s  added wtxEndian().
  83. 01v,04may95,s_w  major re-write for cleanup of WTX C library and addition
  84.  of error handling routines. Also restruction of headers.
  85. 01u,03may95,p_m  changed EVT_ to WTX_EVT_ and removed EVT_CALL_GOT_EXC
  86.  and EVT_BREAKPOINT.
  87. 01t,20apr95,p_m  integrated more WIN32 changes. added wtxShutdown().
  88. 01s,10apr95,p_m  moved event strings from "tsevt.h" and added EVT_TOOL_MSG.
  89.  added wtxMsgErrSet() that was removed by mistake.
  90. 01r,09apr95,s_w  correct prototype for wtxErrClear and wtxToolAttachHookSet
  91. 01q,09apr95,p_m  added missing prototypes and WTXC_EVT_TYPE.
  92. 01p,08apr95,p_m  completed C API.
  93. 01o,03mar95,p_m  added wtxMsgErrSet().
  94. 01n,28feb95,p_m  added WTX_MAX_SYM_CNT.
  95. 01m,23feb95,pad  changed WTX_MAX_SERVICE_CNT to 500.
  96. 01l,17feb95,p_m  changed delete to dlete in wtxExchangeInstall to please g++.
  97. 01k,08feb95,p_m  added MAX_OBJ_SEG_CNT and MAX_LD_M_SECTION_CNT taken from
  98.  xdrwtx.c. removed unnecessary constants.
  99.  made all limits prefix be WTX_MAX_.
  100. 01j,02feb95,p_m  merged all status in WTX_ERROR_T. 
  101. 01i,22jan95,jcf  added new status returns.
  102. 01h,20jan95,jcf  changed include to wtxtypes.h.
  103. 01g,20dec94,p_m  now use wtxrpc.h generated by rpcgen from wtx.x.
  104.  added S_wtx_AGENT_SERVICE_NOT_AVAIL.
  105.  added S_wtx_TARGET_NOT_ATTACHED.
  106. 01f,16nov94,p_m  added WTX_EVENT_ADD and wtxSvcInit().
  107.  removed S_wtx_NOT_ENOUGH_MEMORY. Changed errno numbers.
  108.  added S_wtx_NO_SCALABLE_AGENT and S_wtx_WIND_BASE_NOT_SET. 
  109. 01e,14nov94,p_m  changed WTX_VIO_OPEN to WTX_OPEN and WTX_VIO_CLOSE 
  110.  to WTX_CLOSE.  added S_wtx_INVALID_FLAGS.
  111. 01e,11nov94,p_m  changed WTX_EVAL_GOPHER to WTX_GOPHER_EVAL.
  112. 01d,27oct94,p_m  added WTX_CONTEXT_RESUME.
  113. 01c,24oct94,p_m  added WTX_FUNC_CALL_PRI.
  114. 01b,20oct94,p_m  added error codes.
  115. 01a,06oct94,p_m  written.
  116. */
  118. #ifndef __INCwtxh
  119. #define __INCwtxh 1
  121. #ifdef __cplusplus
  122. extern "C" {
  123. #endif
  125. #ifdef HOST
  126. #include <setjmp.h>
  127. #include "demanglerTypes.h"
  128. #else
  129. #include "vxWorks.h"
  130. #include "setjmp.h"
  131. #include "string.h"
  132. #include "stdio.h"
  133. #include "stdlib.h"
  134. #include "bootLib.h"
  135. #endif /* HOST */
  137. #include "wtxtypes.h"
  138. #include "wtxmsg.h"
  139. #include "wtxerr.h"
  141. /* defines */
  143. #define N_DASM_INST_DEFAULT     10      /* default # of disassembled insts   */
  145. #define WTX_ALL_EVENTS ~0 /* Number of events returned */
  146. #define WTX_LOG_NO_LIMIT 0 /* No max size for the log file */
  147. #define WTX_LOCK_FOREVER 0  /* Lock indefinitely the target server */
  149. #define LOAD_MODULE_INFO_ONLY   0x1000000       /* module synchronization */
  151. #define LOAD_IN_PROGRESS        0       /* load in progress*/
  152. #define LOAD_DONE               1       /* load finished (good or bad) */
  154. #define WTX_TRY(hWtx) 
  155. {
  156. WTX_HANDLER_T errHandler;
  157. jmp_buf jumpBuf;
  159. wtxErrClear (hWtx);
  160. errHandler = wtxErrHandlerAdd (hWtx, &wtxErrExceptionFunc, &jumpBuf);
  161. if (setjmp (jumpBuf) == 0)
  163. #define WTX_CATCH(hWtx, errCode) else if (wtxErrGet (hWtx) == errCode)
  164. #define WTX_CATCH_ALL(hWtx) else
  166. #define WTX_TRY_END(hWtx) 
  167. wtxErrHandlerRemove (hWtx, errHandler);
  168. }
  170. #define WTX_THROW(hWtx, errCode) wtxErrDispatch (hWtx, errCode)
  173. /* typedefs */
  175. typedef enum cpu_info /* available cpu information types */
  176.     {
  177.     CPU_INFO_NONE = 0, /* no info needed                  */
  178.     ARCH_DIR = 1, /* target architecture directory   */
  179.     LEADING_CHAR = 2, /* symbols prepended character     */
  180.     DEMANGLER = 3, /* target symbol demangler name    */
  181.     CPU_NAME = 4, /* target CPU name                 */
  182.     ARCH_OBJ_DIR = 5 /* target architecture object dir  */
  183.     } CPU_INFO;
  185. typedef struct cpu_info_type /* cpu info type               */
  186.     {
  187.     CPU_INFO param; /* parameter value             */
  188.     char * string; /* parameter associated string */
  189.     char * section; /* parameter section           */
  190.     } CPU_INFO_TYPE;
  192. typedef enum wtx_endian_t
  193.     {
  194.     WTX_ENDIAN_BIG = 0,
  195.     WTX_ENDIAN_LITTLE = 1,
  196.     WTX_ENDIAN_UNKNOWN = WTX_ERROR
  197.     } WTX_ENDIAN_T;
  199. typedef struct _wtx * HWTX; /* WTX Handle */
  201. typedef BOOL32 (*WTX_HANDLER_FUNC) (); 
  204. typedef struct _wtx_handler_t * WTX_HANDLER_T;
  207. /* XXX - expect typedefs below to move into wtxtypes.h or wtxmsg.h */
  209. typedef struct wtx_context_desc /* context creation desc. */
  210.     {
  211.     WTX_CONTEXT_TYPE contextType; /* context type */
  212.     WTX_RETURN_TYPE returnType; /* int or double */
  213.     char * name; /* name */
  214.     UINT32 priority; /* priority */
  215.     UINT32 options; /* options */
  216.     TGT_ADDR_T stackBase; /* base of stack */
  217.     UINT32 stackSize; /* stack size */
  218.     TGT_ADDR_T entry; /* context entry point */
  219.     INT32 redirIn; /* redir. in file or NULL */
  220.     INT32 redirOut; /* redir. out file or NULL */
  221.     TGT_ARG_T args[WTX_MAX_ARG_CNT]; /* arguments */
  222.     } WTX_CONTEXT_DESC;
  224. typedef struct wtx_evtpt_list   /* eventpoint list message */
  225.     {
  226.     UINT32 nEvtpt; /* num. eventpoint in list */
  227.     WTX_EVTPT * pEvtpt; /* eventpoint list */
  228.     } WTX_EVTPT_LIST;
  230. typedef struct wtx_evtpt_list_2 /* eventpoint list message */
  231.     {
  232.     UINT32              nEvtpt;         /* num. eventpoint in list */
  233.     WTX_EVTPT_INFO *    pEvtptInfo;     /* eventpoint info list */
  234.     } WTX_EVTPT_LIST_2;
  235.  
  236. typedef struct wtx_mem_info   /* memory information */
  237.     {
  238.     UINT32  curBytesFree; /* number of free bytes */
  239.     UINT32  curBytesAllocated; /* cur. # of bytes alloc. */
  240.     UINT32  cumBytesAllocated; /* cum. # of bytes alloc. */
  241.     UINT32  curBlocksFree; /* cur. # of free blocks */
  242.     UINT32  curBlocksAlloc; /* cur. # of blocks alloc. */
  243.     UINT32  cumBlocksAlloc; /* cum. # of blocks alloc. */
  244.     UINT32  avgFreeBlockSize; /* average free blocks size */
  245.     UINT32  avgAllocBlockSize; /* average alloc. blocks size */
  246.     UINT32  cumAvgAllocBlockSize; /* cum. avg alloc. block size */
  247.     UINT32  biggestBlockSize; /* size of biggest block */
  248.     void *  pReserved; /* reserved */
  249.     } WTX_MEM_INFO;
  251. typedef struct wtx_module_info /* object module information */
  252.     {
  253.     UINT32    moduleId; /* module Id */
  254.     char *    moduleName; /* module name */
  255.     char *    format; /* object file format */
  256.     UINT32    group; /* group number */
  257.     int    loadFlag; /* flags used to load mod. */
  258.     UINT32    nSegments; /* number of segments */
  259.     OBJ_SEGMENT * segment; /* segment description */
  260.     void *    pReserved; /* reserved */
  261.     } WTX_MODULE_INFO;
  263. typedef struct wtx_module_list /* object module list */
  264.     {
  265.     UINT32 numObjMod;  /* number of module in list */
  266.     UINT32 *   modIdList;  /* list of object module id */
  267.     } WTX_MODULE_LIST;
  269. typedef enum wtx_svr_type /* type of server to connect to      */
  270.     {
  271.     WTX_SVR_NONE = 0, /* no server to connect to           */
  272.     WTX_SVR_SERVER = 1, /* server is a target server         */
  273.     WTX_SVR_REGISTRY = 2 /* server is the registry            */
  274.     } WTX_SVR_TYPE;
  276. typedef struct wtx_ts_info /* TS information message */
  277.     {
  278.     WTX_TGT_LINK_DESC tgtLinkDesc; /* Target link descriptor */
  279.     WTX_TGT_INFO tgtInfo; /* info obtained from Target */
  280.     WTX_TOOL_DESC * pWtxToolDesc; /* info about attached Tools */
  281.     char * version; /* Target Server version */
  282.     char * userName; /* target server user name */
  283.     char * startTime; /* target server start time */
  284.     char * accessTime; /* target server access time */
  285.     char * lockMsg; /* lock/authorization message */
  286.     void * pReserved; /* reserved */
  287.     } WTX_TS_INFO;
  289. typedef struct wtx_load_report_info /* Progress info for async. loads */
  290.     {
  291.     int         loadState;      /*
  292.                                  * two value :
  293.                                  *  LOAD_IN_PROGRESS : 
  294.                                  *    - informations available in
  295.                                  *      PROGRESSINFO structure.
  296.                                  *  LOAD_DONE : 
  297.                                  *    - informations available in
  298.                                  *       MODULEINFO structure.
  299.                                  */
  300.     union       state_info
  301.         {
  302.         struct ld_m_file_desc /* object module file descriptor     */
  303.     {
  304.     char *              filename;       /* object file name          */
  305.     INT32               loadFlag;       /* behavior control flags    */
  306.     UINT32              moduleId;       /* module identifier         */
  307.     UINT32              nSections;      /* number of sections        */
  308.     LD_M_SECTION *      section;        /* section description       */
  309.     WTX_SYM_LIST        undefSymList;   /* list of undefined symbols */
  310.     } WTX_LD_M_FILE_DESC;
  312.         struct progress_info
  313.             {
  314.             int         state;          /* Current State                  */
  315.             int         maxValue;       /* Maximum value for this state   */
  316.             int         currentValue;   /* current value for this state   */
  317.             }   PROGRESS_INFO;
  318.         }       STATE_INFO;
  319.     }   WTX_LOAD_REPORT_INFO;
  321. /* globals */
  323. #ifndef HOST
  324. /* externals */
  326. extern BOOT_PARAMS sysBootParams;
  327. #endif /* HOST */
  330. /* function declarations */
  332. extern char * wtxCpuInfoGet
  333.     (
  334.     int cpuNum, /* cpu number to get info on */
  335.     CPU_INFO cpuInfoType /* cpu info type to get      */
  336.     );
  338. extern STATUS wtxEach /* examine each WTX-registered service*/
  339.     (
  340.     HWTX hWtx, /* WTX API handle */
  341.     const char * namePat, /* reg expression to match svc name */
  342.     const char * typePat, /* reg expression to match svc type */
  343.     const char * keyPat, /* reg expression to match svc key */
  344.     FUNCPTR routine, /* func to call for each svc entry */
  345.     void * arg /* arbitrary user-supplied arg */
  346.     );
  348. extern WTX_DESC * wtxInfo /* return service descriptor */
  349.     (
  350.     HWTX hWtx, /* WTX API handle */
  351.     const char * name /* service name to lookup */
  352.     );
  354. extern WTX_DESC_Q * wtxInfoQ /* return list of registred services */
  355.     (
  356.     HWTX hWtx, /* WTX API handle */
  357.     const char * namePat, /* reg expression to match svc name */
  358.     const char * typePat, /* reg expression to match svc type */
  359.     const char * keyPat /* reg expression to match svc key */
  360.     );
  362. extern STATUS wtxInitialize /* init to be called by WTX client */
  363.     (
  364.     HWTX * phWtx /* handle to use in next API calls */
  365.     );
  367. extern STATUS wtxProbe /* probe to see if registry is running*/
  368.     (
  369.     HWTX hWtx /* WTX API handle */
  370.     );
  372. extern WTX_DESC * wtxRegister /* register for a service */
  373.     (
  374.     HWTX hWtx, /* WTX API handle */
  375.     const char * name,  /* service name, NULL to be named */
  376.     const char * type, /* service type, NULL for unspecified */
  377.     const char * key /* unique service key */
  378.     );
  380. extern STATUS wtxTerminate /* terminate use of WTX client handle */
  381.     (
  382.     HWTX hWtx /* WTX API handle */
  383.     );
  385. extern STATUS wtxTimeoutSet /* set WTX timeout */
  386.     (
  387.     HWTX hWtx, /* WTX API handle */
  388.     UINT32 msec /* New timeout value in milliseconds */
  389.     );
  391. extern STATUS wtxTimeoutGet /* get the current timeout */
  392.     (
  393.     HWTX hWtx, /* WTX API handle */
  394.     UINT32 * pMsec /* Pointer to timeout value in ms */
  395.     );
  397. extern STATUS wtxUnregister /* unregister for descriptor */
  398.     (
  399.     HWTX hWtx, /* WTX API handle */
  400.     const char * name /* service unregister, NULL for self */
  401.     );
  403. extern STATUS wtxAgentModeSet /* set the mode of the target agent */
  404.     (
  405.     HWTX hWtx, /* WTX API handle */
  406.     WTX_AGENT_MODE_TYPE agentMode /* debug agent mode */
  407.     );
  409. extern WTX_AGENT_MODE_TYPE wtxAgentModeGet /* get agent mode */
  410.     (
  411.     HWTX hWtx /* WTX API handle */
  412.     );
  414. extern STATUS   wtxAsyncNotifyEnable    /* start async. event notification */
  415.     (
  416.     HWTX                hWtx,           /* WTX API handle */
  417.     FUNCPTR             pFunc           /* user defined hook routine */
  418.     );
  420. extern STATUS   wtxAsyncNotifyDisable   /* stop async. event notification */
  421.     (
  422.     HWTX                hWtx            /* WTX API handle */
  423.     );
  425. extern WTX_EVENT_DESC * wtxAsyncEventGet
  426.     (
  427.     HWTX hWtx /* WTX API handle */
  428.     );
  430. extern STATUS wtxAsyncResultFree
  431.     (
  432.     HWTX hWtx, /* WTX API handle */
  433.     WTX_EVENT_DESC * pEventDesc /* pointer to struct. to free */
  434.     );
  436. extern UINT32 wtxBreakpointAdd /* create a new event point */
  437.     (
  438.     HWTX hWtx, /* WTX API handle */
  439.     WTX_CONTEXT_TYPE contextType, /* type of context to put bp in */
  440.     WTX_CONTEXT_ID_T contextId, /* associated context */
  441.     TGT_ADDR_T tgtAddr /* breakpoint address */
  442.     );
  444. extern STATUS wtxCacheTextUpdate        /* Update the target text cache */
  445.     (
  446.     HWTX                hWtx,           /* WTX API handle */
  447.     TGT_ADDR_T          addr,           /* start address  */
  448.     UINT32              nBytes          /* how many ?     */
  449.     );
  451. extern STATUS wtxClientDataGet /* get the client data */
  452.     (
  453.     HWTX hWtx, /* WTX API handle */
  454.     void ** ppClientData /* pointer to client data pointer */
  455.     );
  457. extern STATUS wtxClientDataSet /* set client data */
  458.     (
  459.     HWTX hWtx, /* WTX API handle */
  460.     void * pClientData /* value to associate with handle */
  461.     );
  463. extern INT32 wtxConsoleCreate /* create a console window (UNIX) */
  464.      (
  465.      HWTX hWtx, /* WTX API handle */
  466.      const char * name,  /* Name of console window */
  467.      const char * display, /* Display name eg: host:0 */
  468.      INT32 * fdIn, /* RETURN: input file descriptor */
  469.      INT32 * fdOut /* RETURN: output file descriptor */
  470.      );
  472. extern STATUS wtxConsoleKill /* kill console (UNIX) */
  473.     (
  474.     HWTX hWtx, /* WTX API handle */
  475.     INT32 consoleId /* id of console to destroy */
  476.     );
  478. extern STATUS wtxContextCont /* continue execution of target ctxt */
  479.     (
  480.     HWTX hWtx, /* WTX API handle */
  481.     WTX_CONTEXT_TYPE contextType, /* type of context to continue */
  482.     WTX_CONTEXT_ID_T contextId /* id of context to continue */
  483.     );
  485. extern WTX_CONTEXT_ID_T wtxContextCreate /* create a ctxt on target */
  486.     (
  487.     HWTX hWtx, /* WTX API handle */
  488.     WTX_CONTEXT_DESC * pContextDesc /* context descriptor */
  489.     );
  491. extern UINT32 wtxContextExitNotifyAdd /* add exit evpt notification */
  492.     (
  493.     HWTX hWTx,  /* WTX API handle */
  494.     WTX_CONTEXT_TYPE contextType, /* type of context */
  495.     WTX_CONTEXT_ID_T contextId /* associated context */
  496.     );
  498. extern STATUS wtxContextKill /* kill a target context */
  499.     (
  500.     HWTX hWtx, /* WTX API handle */
  501.     WTX_CONTEXT_TYPE contextType, /* type of context to kill */
  502.     WTX_CONTEXT_ID_T contextId /* id of context to kill */
  503.     );
  505. extern STATUS wtxContextResume /* resume execution of a target ctxt */
  506.     (
  507.     HWTX hWtx, /* WTX API handle */
  508.     WTX_CONTEXT_TYPE contextType, /* type of context to resume */
  509.     WTX_CONTEXT_ID_T contextId /* id of context to resume */
  510.     );
  512. extern STATUS wtxContextStep /* single step exec of target ctxt */
  513.     (
  514.     HWTX hWtx, /* WTX API handle */
  515.     WTX_CONTEXT_TYPE contextType, /* type of context to resume */
  516.     WTX_CONTEXT_ID_T contextId,  /* id of context to step */
  517.     TGT_ADDR_T stepStart, /* stepStart pc value */
  518.     TGT_ADDR_T stepEnd /* stepEnd PC vale */
  519.     );
  521. extern STATUS wtxContextSuspend /* suspend a target context */
  522.     (
  523.     HWTX hWtx, /* WTX API handle */
  524.     WTX_CONTEXT_TYPE contextType, /* type of context to suspend */
  525.     WTX_CONTEXT_ID_T contextId /* id of context being suspended */
  526.     );
  528. extern STATUS wtxErrClear /* clear any error for the tool */
  529.     (
  530.     HWTX hWtx /* WTX API handle */
  531.     );
  533. extern WTX_ERROR_T wtxErrGet /* return the last error for a handle */
  534.     (
  535.     HWTX hWtx /* WTX API handle */
  536.     );
  538. extern STATUS wtxErrSet /* set the error code for the handle */
  539.     (
  540.     HWTX hWtx, /* WTX API handle */
  541.     UINT32 errCode /* error value to set */
  542.     );
  544. extern const char * wtxErrMsgGet /* fetch last WTX API error string */
  545.     (
  546.     HWTX hWtx /* WTX API handle */
  547.     );
  549. extern const char * wtxErrToMsg /* convert error code to string */
  550.     (
  551.     HWTX hWtx, /* WTX API handle */
  552.     WTX_ERROR_T errCode /* error code to convert */
  553.     );
  555. extern STATUS wtxErrDispatch /* dispatch error with supplied code */
  556.     (
  557.     HWTX hWtx, /* WTX API handle */
  558.     WTX_ERROR_T errCode /* error code to register */
  559.     );
  561. extern BOOL32 wtxErrExceptionFunc /* a function to handle an error */
  562.     (
  563.     HWTX hWtx, /* WTX API handle */
  564.     void * pClientData, /* pointer to a jump buffer */
  565.     void * pCallData /* error code to return via setjmp() */
  566.     );
  568. extern WTX_HANDLER_T wtxErrHandlerAdd /* add an error handler */
  569.     (
  570.     HWTX hWtx, /* WTX API handle */
  571.     WTX_HANDLER_FUNC pFunc, /* function to call on error */
  572.     void * pClientData /* data to pass function */
  573.     );
  575. extern STATUS wtxErrHandlerRemove /* remove error handler for WTX handle*/
  576.     (
  577.     HWTX hWtx, /* WTX API handle */
  578.     WTX_HANDLER_T pHandler /* error handler */
  579.     );
  581. extern STATUS wtxEventAdd /* send an event to the target server */
  582.     (
  583.     HWTX hWtx, /* WTX API handle */
  584.     const char * event,  /* event string to send */
  585.     UINT32 addlDataLen, /* length of addl data block in bytes */
  586.     const void * pAddlData /* pointer to additional data */
  587.     );
  589. extern WTX_EVENT_DESC * wtxEventGet /* get an event from the target */
  590.     (
  591.     HWTX hWtx /* WTX API handle */
  592.     );
  594. extern WTX_EVENT_NODE * wtxEventListGet /* Get all the events in one call */
  595.     (
  596.     HWTX                hWtx,           /* WTX API handle */
  597.     UINT32              nEvents         /* Number of events to return */
  598.     );
  600. extern UINT32 wtxEventpointAdd /* Create a new event point */
  601.     (
  602.     HWTX                hWtx, /* WTX API handle */
  603.     WTX_EVTPT_2 * pEvtpt /* eventpoint descriptor */
  604.     );
  606. extern UINT32 wtxHwBreakpointAdd /* Create a new hardware breakpoint  */
  607.     (
  608.     HWTX                hWtx, /* WTX API handle */
  609.     WTX_CONTEXT_TYPE contextType, /* type of context to put bp in */
  610.     WTX_CONTEXT_ID_T contextId, /* associated context */
  611.     TGT_ADDR_T tgtAddr, /* breakpoint address */
  612.     TGT_INT_T type /* access type (arch dependant) */
  613.     );
  614. extern STATUS wtxEventpointDelete /* delete eventpoint from the target */
  615.     (
  616.     HWTX hWtx, /* WTX API handle */
  617.     UINT32 evtptId /* ID of eventpoint to delete */
  618.     );
  620. extern WTX_EVTPT_LIST * wtxEventpointList  /* list evpts on target server*/
  621.     (
  622.     HWTX hWtx /* WTX API handle */
  623.     );
  625. extern WTX_EVTPT_LIST_2 * wtxEventpointListGet /* list evpts on TS */ 
  626.     (
  627.     HWTX                hWtx            /* WTX API handle */
  628.     );
  630. extern STATUS wtxFileClose /* close a file on the target server */
  631.     (
  632.     HWTX hWtx, /* WTX API handle */
  633.     INT32 fileDescriptor /* file to close descriptor */
  634.     );
  636. extern INT32 wtxFileOpen /* open a file on the target server */
  637.     (
  638.     HWTX hWtx, /* WTX API handle */
  639.     const char * fileName,  /* file name */
  640.     WTX_OPEN_FLAG flags, /* unix style flags */
  641.     INT32 mode, /* unix style mode */
  642.     INT32 channel /* channel id for redirection */
  643.     );
  645. extern WTX_CONTEXT_ID_T wtxFuncCall /* call a function on the target */
  646.     (
  647.     HWTX hWtx, /* WTX API handle */
  648.     WTX_CONTEXT_DESC * pContextDesc /* pointer to call descriptor */
  649.     ); 
  651. extern STATUS wtxDirectCall /* call func on target within agent */
  652.     (
  653.     HWTX hWtx, /* WTX API handle */
  654.     TGT_ADDR_T entry, /* function address */
  655.     void * pRetVal, /* pointer to return value */
  656.     TGT_ARG_T arg0, /* function argument 1 */
  657.     TGT_ARG_T arg1, /* function argument 2 */
  658.     TGT_ARG_T arg2, /* function argument 3 */
  659.     TGT_ARG_T arg3, /* function argument 4 */
  660.     TGT_ARG_T arg4, /* function argument 5 */
  661.     TGT_ARG_T arg5, /* function argument 6 */
  662.     TGT_ARG_T arg6, /* function argument 7 */
  663.     TGT_ARG_T arg7, /* function argument 8 */
  664.     TGT_ARG_T arg8, /* function argument 9 */
  665.     TGT_ARG_T arg9 /* function argument 10 */
  666.     ); 
  668. extern WTX_GOPHER_TAPE * wtxGopherEval /* evaluate Gopher string on target */
  669.     (
  670.     HWTX hWtx, /* WTX API handle */
  671.     const char * inputString /* Gopher program to evaluate */
  672.     );
  674. extern STATUS wtxLogging                /* WDB/WTX logging facilities */
  675.     (
  676.     HWTX        hWtx,                   /* WTX API handle     */
  677.     int         type,                   /* WDB or WTX logging */
  678.     int         action,                 /* Logging ON or OFF  */
  679.     char *      fileName,               /* Logging file name  */
  680.     int         maxSize,                /* log file max size  */
  681.     char * filter /* Request filter     */
  682.     );
  684. extern WTX_MEM_INFO * wtxMemInfoGet /* get info about memory pool */
  685.     (
  686.     HWTX hWtx /* WTX API handle */
  687.     );
  689. extern STATUS wtxMemAddToPool /* add memory to the agent pool */
  690.     (
  691.     HWTX hWtx, /* WTX API handle */
  692.     TGT_ADDR_T address, /* base of memory block to add */
  693.     UINT32 size /* size of memory block to add */
  694.     );
  696. extern TGT_ADDR_T wtxMemAlign /* allocate aligned target memory */
  697.     (
  698.     HWTX hWtx, /* WTX API handle */
  699.     TGT_ADDR_T alignment,  /* alignment boundary */
  700.     UINT32 numBytes /* size of block to allocate */
  701.     );
  703. extern TGT_ADDR_T wtxMemAlloc /* alloc blocks in memory pool */
  704.     (
  705.     HWTX hWtx, /* WTX API handle */
  706.     UINT32 numBytes /* size to allocate in bytes */
  707.     );
  709. extern UINT32 wtxMemChecksum /* perform checksum on target memory */
  710.     (
  711.     HWTX hWtx, /* WTX API handle */
  712.     TGT_ADDR_T startAddr,  /* remote addr to start checksum at */
  713.     UINT32 numBytes /* number of bytes to checksum */
  714.     );
  716. extern WTX_DASM_INST_LIST * wtxMemDisassemble /* disassemble memory */
  717.     (
  718.     HWTX hWtx, /* WTX API handle */
  719.     TGT_ADDR_T startAddr, /* Inst address to match */
  720.     UINT32 nInst, /* number of instructions to get */
  721.     TGT_ADDR_T endAddr, /* Last address to match */
  722.     BOOL32 printAddr, /* if instruction's address appended */
  723.     BOOL32 printOpcodes, /* if instruction's opcodes appended */
  724.     BOOL32 hexaAddr /* for hex  adress representation */
  725.     );
  727. extern STATUS wtxMemFree /* free a block of target memory */
  728.     (
  729.     HWTX hWtx, /* WTX API handle */
  730.     TGT_ADDR_T address /* target mem block address to free */
  731.     );
  733. extern STATUS wtxMemMove /* move a block of target memory */
  734.     (
  735.     HWTX hWtx, /* WTX API handle */
  736.     TGT_ADDR_T srcAddr, /* remote addr to move from */
  737.     TGT_ADDR_T destAddr, /* remote addr to move to */
  738.     UINT32 numBytes /* number of bytes to move */
  739.     );
  741. extern UINT32 wtxMemRead /* read memory from the target */
  742.     (
  743.     HWTX hWtx, /* WTX API handle */
  744.     TGT_ADDR_T fromAddr, /* Target addr to read from */
  745.     void * toAddr, /* Local addr to read to */
  746.     UINT32 numBytes /* Bytes to read */
  747.     );
  749. extern UINT32 wtxMemWidthRead           /* read memory on <width> bytes */
  750.     (
  751.     HWTX                hWtx,           /* WTX API handle */
  752.     TGT_ADDR_T          fromAddr,       /* Target addr to read from */
  753.     void *              toAddr,         /* Local addr to read to */
  754.     UINT32              numBytes,       /* Bytes to read */
  755.     UINT8               width           /* width to read */
  756.     );
  758. extern TGT_ADDR_T wtxMemRealloc /* reallocate a block of target mem */
  759.     (
  760.     HWTX hWtx, /* WTX API handle */
  761.     TGT_ADDR_T address,  /* memory block to reallocate */
  762.     UINT32 numBytes /* new size */
  763.     );
  765. extern UINT32 wtxMemSet /* set target memory to given value */
  766.     (
  767.     HWTX hWtx, /* WTX API handle */
  768.     TGT_ADDR_T addr, /* remote addr to write to */
  769.     UINT32 numBytes,  /* number of bytes to set */
  770.     UINT32 val /* value to set */
  771.     );
  773. extern STATUS wtxMemScan /* scan target memory for pattern */
  774.     (
  775.     HWTX hWtx, /* WTX API handle */
  776.     BOOL32 match, /* Match/Not-match pattern boolean */
  777.     TGT_ADDR_T startAddr,  /* Target address to start scan */
  778.     TGT_ADDR_T endAddr, /* Target address to finish scan */
  779.     UINT32 numBytes,  /* Number of bytes in pattern */
  780.     void * pattern, /* Pointer to pattern to search for */
  781.     TGT_ADDR_T * pResult /* Pointer to result address */
  782.     );
  784. extern UINT32 wtxMemWrite /* write memory on the target */
  785.     (
  786.     HWTX hWtx, /* WTX API handle */
  787.     void * fromAddr, /* Local addr to write from */
  788.     TGT_ADDR_T toAddr, /* Remote addr to write to */
  789.     UINT32 numBytes /* Bytes to read */
  790.     );
  792. extern UINT32 wtxMemWidthWrite          /* write memory on the target */
  793.     (
  794.     HWTX                hWtx,           /* WTX API handle */
  795.     void *              fromAddr,       /* Local addr to write from */
  796.     TGT_ADDR_T          toAddr,         /* Remote addr to write to */
  797.     UINT32              numBytes,       /* Bytes to read */
  798.     UINT8               width           /* Width to read */
  799.     );
  801. extern STATUS wtxObjModuleChecksum      /* Checks validity of target memory */
  802.     (
  803.     HWTX                hWtx,           /* WTX API handle */
  804.     INT32               moduleId,       /* Module Id      */
  805.     char *              fileName        /* Module name    */
  806.     );
  808. extern char * wtxObjModuleFindName /* find obj module name given its ID */
  809.     (
  810.     HWTX hWtx, /* WTX API handle */
  811.     UINT32 modId /* id of module to find obj name of */
  812.     );
  814. extern UINT32 wtxObjModuleFindId /* find obj module IF from name */
  815.     (
  816.     HWTX hWtx, /* WTX API handle */
  817.     const char * name /* object module file name */
  818.     );
  820. extern WTX_MODULE_INFO * wtxObjModuleInfoGet /* give info on obj module */
  821.     (
  822.     HWTX hWtx, /* WTX API handle */
  823.     UINT32 modId /* id of module to look for */
  824.     );
  826. extern WTX_MODULE_INFO * wtxObjModuleInfoAndPathGet /* give info on obj module */
  827.     (
  828.     HWTX hWtx, /* WTX API handle */
  829.     UINT32 modId /* id of module to look for */
  830.     );
  832. extern WTX_MODULE_LIST * wtxObjModuleList /* list loaded obj modules */
  833.     (
  834.     HWTX hWtx /* WTX API handle */
  835.     );
  837. extern WTX_LD_M_FILE_DESC * wtxObjModuleLoad /* load a new object module */
  838.     (
  839.     HWTX hWtx, /* WTX API handle */
  840.     WTX_LD_M_FILE_DESC * pFileDesc /* module descriptor */
  841.     );
  843. extern STATUS wtxObjModuleLoadStart /* asynchronous load */
  844.     (
  845.     HWTX                        hWtx,           /* WTX API handle    */
  846.     WTX_LD_M_FILE_DESC *        pFileDesc       /* Module descriptor */
  847.     );
  849. extern WTX_LOAD_REPORT_INFO * wtxObjModuleLoadProgressReport /* load status */
  850.     (
  851.     HWTX                        hWtx    /* WTX API handle    */
  852.     );
  854. extern STATUS wtxObjModuleLoadCancel /* cancel an async. load */
  855.     (
  856.     HWTX                        hWtx    /* WTX API handle    */
  857.     );
  859. extern STATUS wtxObjModuleUnload /* unload an obj module from target */
  860.     (
  861.     HWTX hWtx, /* WTX API handle */
  862.     UINT32 modId /* id of module to unload */
  863.     );
  865. extern STATUS wtxObjModuleByNameUnload  /* Unload an obj. mod. from target */
  866.     (
  867.     HWTX                hWtx,           /* WTX API handle             */
  868.     char *              name            /* Name of module to look for */
  869.     );
  871. extern STATUS wtxRegisterForEvent /* send events matching expression */
  872.     (
  873.     HWTX hWtx, /* WTX API handle */
  874.     const char * regExp /* Regular expr to select events */
  875.     );
  877. extern STATUS wtxRegsGet /* read register data from the target */
  878.     (
  879.     HWTX hWtx, /* WTX API handle */
  880.     WTX_CONTEXT_TYPE contextType, /* context type to get regs of */
  881.     WTX_CONTEXT_ID_T contextId, /* context id to get regs of */
  882.     WTX_REG_SET_TYPE regSet, /* type of register set */
  883.     UINT32 firstByte, /* first byte of register set */
  884.     UINT32 numBytes, /* number of bytes of register set */
  885.     void * regMemory /* place holder for reg. values */
  886.     );
  888. extern STATUS wtxRegsSet /* write to registers on the target */
  889.     (
  890.     HWTX hWtx, /* WTX API handle */
  891.     WTX_CONTEXT_TYPE contextType, /* context type to set regs of */
  892.     WTX_CONTEXT_ID_T contextId, /* context id to set regs of */
  893.     WTX_REG_SET_TYPE regSet, /* type of register set */
  894.     UINT32 firstByte, /* first byte of reg. set */
  895.     UINT32 numBytes, /* number of bytes in reg. set. */
  896.     void * regMemory /* register contents */
  897.     );
  899. extern void wtxSymListFree
  900.     (
  901.     WTX_SYM_LIST * pSymList /* symbol list to free */
  902.     );
  904. extern STATUS wtxResultFree /* free mem allocated by WTX API call */
  905.     (
  906.     HWTX hWtx, /* WTX API handle */
  907.     void * pResult /* pointer to WTX result structure */
  908.     );
  910. extern STATUS wtxServiceAdd /* add a new service to the agent */
  911.     (
  912.     HWTX hWtx, /* WTX API handle */
  913.     UINT32 * wtxSvcNum, /* where to return WTX RPC serv num */
  914.     UINT32 wdbSvcNum, /* WDB RPC service number */
  915.     char * wdbName, /* WDB service name */
  916.     char * wdbObjFile, /* WDB service object module */
  917.     char * wdbInitRtn, /* WDB svc init routine name */
  918.     char * wtxObjFile, /* WTX xdr/service DLL file */
  919.     char * wtxName, /* WTX service routine name */
  920.     char * wtxInProcName, /* WTX service input xdr proc name */
  921.     char * wtxOutProcName /* WTX service output xdr proc name */
  922.     );
  924. extern TGT_ADDR_T wtxStrToTgtAddr /* convert str to a TGT_ADDR_T */
  925.     (
  926.     HWTX hWtx, /* WTX API handle */
  927.     const char * str /* string to convert */
  928.     );
  930. extern INT32 wtxStrToInt32 /* convert str to an INT32 */
  931.     (
  932.     HWTX hWtx, /* WTX API handle */
  933.     const char * str /* string to convert */
  934.     );
  936. extern WTX_CONTEXT_ID_T wtxStrToContextId /* convert str to ctxt ID */
  937.     (
  938.     HWTX hWtx, /* WTX API handle */
  939.     const char * str /* string to convert */
  940.     );
  942. extern WTX_CONTEXT_TYPE wtxStrToContextType /* convert str ton ctxt type */
  943.     (
  944.     HWTX hWtx, /* WTX API handle */
  945.     const char * str /* string to convert */
  946.     );
  948. extern WTX_EVENT_TYPE wtxStrToEventType /* convert string to event type */
  949.     (
  950.     HWTX hWtx, /* WTX API handle */
  951.     const char * str /* string to convert */
  952.     );
  954. const char * wtxEventToStrType /* convert event type to a string */
  955.     (
  956.     WTX_EVENT_TYPE event /* WTX Event */
  957.     );
  959. extern STATUS wtxSymAdd /* add symbol with given params */
  960.     (
  961.     HWTX hWtx, /* WTX API handle */
  962.     const char * symName,  /* name of symbol to add */
  963.     TGT_ADDR_T symValue, /* value of symbol to add */
  964.     UINT8 symType /* type of symbol to add */
  965.     ); 
  967. extern STATUS wtxSymAddWithGroup /* add symbol with given group */
  968.     (
  969.     HWTX hWtx, /* WTX API handle */
  970.     const char * symName, /* name of symbol to add */
  971.     TGT_ADDR_T symValue, /* value of symbol to add */
  972.     UINT8 symType, /* type of symbol to add */
  973.     UINT16 group /* group of symbol to add */
  974.     ); 
  976. extern WTX_SYMBOL * wtxSymFind /* find info on symbol */
  977.     (
  978.     HWTX hWtx, /* WTX API handle */
  979.     const char * symName, /* name of symbol */
  980.     TGT_ADDR_T symValue, /* value of symbol */
  981.     BOOL32 exactName, /* must match name exactly */
  982.     UINT8 symType, /* type of symbol */
  983.     UINT8 typeMask /* mask to select type bits */
  984.     );
  986. extern WTX_SYM_LIST * wtxSymListGet /* get list of symbols */
  987.     (
  988.     HWTX hWtx, /* WTX API handle */
  989.     const char * string, /* string to match */
  990.     const char * moduleNameOrId, /* Module name to search in */
  991.     TGT_ADDR_T value, /* Symbol value to match */
  992.     BOOL32 listUnknown /* List unknown symbols only flag */
  993.     );
  995. extern WTX_SYM_LIST * wtxSymListByModuleIdGet /* get list of symbols */
  996.     (
  997.     HWTX                hWtx, /* WTX API handle */
  998.     const char *        string, /* string to match */
  999.     UINT32 moduleId, /* Module Id to search in */
  1000.     TGT_ADDR_T          value, /* Symbol value to match */
  1001.     BOOL32              listUnknown /* List unknown symbols only flag */
  1002.     );
  1004. extern WTX_SYM_LIST * wtxSymListByModuleNameGet /* get list of symbols */
  1005.     (
  1006.     HWTX                hWtx, /* WTX API handle */
  1007.     const char *        string, /* string to match */
  1008.     const char *        moduleName, /* Module name to search in */
  1009.     TGT_ADDR_T          value, /* Symbol value to match */
  1010.     BOOL32              listUnknown /* List unknown symbols only flag */
  1011.     );
  1013. extern STATUS wtxSymRemove /* remove a symbol from sym table */
  1014.     (
  1015.     HWTX hWtx, /* WTX API handle */
  1016.     const char * symName, /* Name of symbol to remove */
  1017.     UINT8 symType /* Type of symbol to remove */
  1018.     );
  1020. extern WTX_SYM_TBL_INFO * wtxSymTblInfoGet /* return sym table info */
  1021.     (
  1022.     HWTX hWtx /* WTX API handle */
  1023.     );
  1025. extern INT32 wtxTargetRtTypeGet /* get the target-runtime-type info */
  1026.     (
  1027.     HWTX hWtx /* WTX API handle */
  1028.     );
  1030. extern const char * wtxTargetRtVersionGet /* get target-runtime version */
  1031.     (
  1032.     HWTX hWtx /* WTX API handle */
  1033.     );
  1035. extern INT32 wtxTargetCpuTypeGet /* get the target CPU type code */
  1036.     (
  1037.     HWTX hWtx /* WTX API handle */
  1038.     );
  1040. extern BOOL32 wtxTargetHasFppGet /* check for floating point processor */
  1041.     (
  1042.     HWTX hWtx /* WTX API handle */
  1043.     );
  1045. extern BOOL32 wtxTargetHasAltivecGet /* check for altivec processor */
  1046.     (
  1047.     HWTX hWtx /* WTX API handle */
  1048.     );
  1050. extern WTX_ENDIAN_T wtxTargetEndianGet /* get edianness of target */
  1051.     (
  1052.     HWTX hWtx /* WTX API handle */
  1053.     );
  1055. extern const char * wtxTargetBootlineGet /* get target boot line info */
  1056.     (
  1057.     HWTX hWtx /* WTX API handle */
  1058.     );
  1060. extern const char * wtxTargetBspNameGet /* get the BSP name string */
  1061.     (
  1062.     HWTX hWtx /* WTX API handle */
  1063.     );
  1065. extern STATUS wtxTargetReset /* reset the target */
  1066.     (
  1067.     HWTX hWtx /* WTX API handle */
  1068.     );
  1070. extern UINT32 wtxTargetIpAddressGet /* get the target IP address */
  1071.     (
  1072.     HWTX hWtx /* WTX API handle */
  1073.     );
  1075. extern char * wtxTargetToolNameGet/* get the target tool name */
  1076.     (
  1077.     HWTX hWtx /* WTX API handle */
  1078.     );
  1080. extern STATUS wtxTargetAttach /* reattach to the target */
  1081.     (
  1082.     HWTX hWtx /* WTX API handle */
  1083.     );
  1085. extern STATUS wtxToolAttach /* connect client to target server */
  1086.     (
  1087.     HWTX hWtx, /* WTX API handle */
  1088.     const char * targetName, /* Target Server name */
  1089.     const char * toolName /* tool name */
  1090.     );
  1092. extern char * wtxToolNameGet /* return name of current tool */
  1093.     (
  1094.     HWTX hWtx /* WTX API handle */
  1095.     );
  1097. extern BOOL32 wtxToolConnected /* check tool connection to server */
  1098.     (
  1099.     HWTX hWtx /* WTX API handle */
  1100.     );
  1102. extern STATUS wtxToolDetach /* detach from the target server */
  1103.     (
  1104.     HWTX hWtx /* WTX API handle */
  1105.     );
  1107. extern UINT32 wtxToolIdGet /* return tool ID of current tool */
  1108.     (
  1109.     HWTX hWtx /* WTX API handle */
  1110.     );
  1112. extern WTX_TS_INFO * wtxTsInfoGet /* get info about target and server */
  1113.     (
  1114.     HWTX hWtx /* WTX API handle */
  1115.     );
  1117. extern STATUS wtxTsKill /* kill the target server */
  1118.     (
  1119.     HWTX hWtx /* WTX API handle */
  1120.     );
  1122. extern STATUS wtxTsLock /* lock server for exclusive access */
  1123.     (
  1124.     HWTX hWtx /* WTX API handle */
  1125.     );
  1127. extern STATUS wtxTsTimedLock /* lock target server a limited time */
  1128.     (
  1129.     HWTX hWtx, /* WTX API handle */
  1130.     UINT32 seconds /* duration of lock */
  1131.     );
  1133. extern const char * wtxTsNameGet /* get target server name */
  1134.     (
  1135.     HWTX hWtx /* WTX API handle */
  1136.     );
  1138. extern STATUS wtxTsRestart /* restart the target server */
  1139.     (
  1140.     HWTX hWtx /* WTX API handle */
  1141.     );
  1143. extern STATUS wtxTsUnlock /* unlock the connected target server */
  1144.     (
  1145.     HWTX hWtx /* WTX API handle */
  1146.     );
  1148. extern STATUS wtxUnregisterForEvent     /* Unregister for some events */
  1149.     (
  1150.     HWTX                hWtx,           /* WTX API handle */
  1151.     char *              regExp          /* regexp for the unwanted events */
  1152.     );
  1154. extern BOOL32 wtxVerify /* verify WTX handle is valid for use */
  1155.     (
  1156.     HWTX hWtx /* WTX API handle */
  1157.     );
  1159. extern INT32 wtxVioChanGet /* get a virtual I/O channel number */
  1160.     (
  1161.     HWTX hWtx /* WTX API handle */
  1162.     );
  1164. extern STATUS wtxVioChanRelease /* release a virtual I/O channel */
  1165.     (
  1166.     HWTX hWtx, /* WTX API handle */
  1167.     INT32 channel /* the channel number to release */
  1168.     );
  1170. extern STATUS wtxVioCtl /* poerform control operation on VIO */
  1171.     (
  1172.     HWTX hWtx, /* WTX API handle */
  1173.     INT32 channel, /* channel to do control operation on */
  1174.     UINT32 request, /* control operation to perform */
  1175.     UINT32 arg /* arg for call */
  1176.     );
  1178. extern WTX_VIO_FILE_DESC ** wtxVioFileList /* list server files */
  1179.     (
  1180.     HWTX hWtx /* WTX API handle */
  1181.     );
  1183. extern UINT32 wtxVioWrite /* write data to a VIO channel */
  1184.     (
  1185.     HWTX hWtx, /* WTX API handle */
  1186.     INT32 channel, /* channel to write to */
  1187.     void * pData, /* pointer to data to write */
  1188.     UINT32 numBytes /* number of bytes of data to write */
  1189.     );
  1191. extern char * wtxTsVersionGet /* return the Tornado version */
  1192.     (
  1193.     HWTX hWtx /* WTX API handle */
  1194.     );
  1196. #if (defined (WIN32))
  1197. long wtxEnvironRegistryOptionsGet
  1198.     (
  1199.     HKEY hKey, /* Win32 registry key handler         */
  1200.     char * dbDir, /* Tornado registry DB directory      */
  1201.     int * pPingDelay, /* target server ping delay           */
  1202.     int * pNUnsuccessPing, /* target server max unsuccess ping   */
  1203.     BOOL * pUsePmap /* do we use port mapper ?            */
  1204.     );
  1205. #endif /* WIN32 */
  1207. #ifdef HOST
  1208. extern DEMANGLER_STYLE wtxDefaultDemanglerStyle  /* appropriate demangling style for target tool */
  1209.     (
  1210.     HWTX hWtx                           /* WTX API handle */
  1211.     );
  1213. extern const char * wtxTargetToolFamilyGet /* returns toolchain family (e.g. "gnu" or "diab") */
  1214.     (
  1215.     HWTX hWtx                           /* WTX API handle */
  1216.     );
  1217. #endif
  1219. #ifdef __cplusplus
  1220. }
  1221. #endif
  1223. #endif /* __INCwtxh */