wtextra.html

vxworks相关论文

If the module sections are to be loaded at particular
addresses, these can be specified in hexadecimal for the <i>textAddr</i>,
<i>dataAddr</i>, and <i>bssAddr</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The ID of the newly loaded module, followed by the text, data, and bss
addresses of the module sections.  If there are symbols in the module
that cannot be resolved against other modules on the target, a list of 
these is appended to the result.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>tcl&gt; wtxObjModuleLoad /folk/pascal/test.o
tcl&gt; wtxObjModuleLoad LOAD_LOCAL_SYMBOLS /folk/pascal/test.o
</pre>

</blockquote><h4>CAVEATS</h4><blockquote><p>
The address parameters are likely to change syntax.  The interface
and result must be able to deal with named sections and more than 
three sections.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_OBJ_MODULE_LOAD_2" >WTX_OBJ_MODULE_LOAD_2</a></b>, wtxObjModuleList, wtxObjModuleInfoGet,  
wtxObjModuleFind, wtxObjModuleUnload, wtxObjModuleByNameUnload,  
wtxObjModuleLoadStart, wtxObjModuleLoadProgressReport, wtxObjModuleLoadCancel

<hr>
<a name="wtxObjModuleLoadStart"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleLoadStart</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleLoadStart</strong> - Load a multiple section object file asynchronously</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleLoadStart [-ts] [flags] [textAddr] [dataAddr] [bssAddr] filename
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine loads a module onto the target and into the target server 
module table. It returns when the module is in the target server memory,
ready to be relocated and downloaded by the target server loader.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
Because this routine returns only <b>TCL_OK</b> or <b>TCL_ERROR</b>, the user
must call wtxObjModuleLoadProgressReport in order to have the module Id,
sections addresses and the undefined symbols.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>TCL_OK</b> or <b>TCL_ERROR</b> if something failed.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
Load  a module on the target, the file is opened by the client and get its
module Id by a wtxObjModuleLoadProgressReport request.
<p>
<pre>tcl&gt; wtxObjModuleLoadStart /folk/pascal/Board/ads860/objSampleWtxtclTest2.o
tcl&gt; wtxObjModuleLoadProgressReport
tcl&gt; 0xfec270 0x6c810 0xffffffff 0xffffffff
</pre>

<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_OBJ_MODULE_LOAD_2" >WTX_OBJ_MODULE_LOAD_2</a></b>, wtxObjModuleLoad,  
wtxObjModuleLoadProgressReport, wtxObjModuleLoadCancel

<hr>
<a name="wtxObjModuleLoadProgressReport"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleLoadProgressReport</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleLoadProgressReport</strong> - get the asynchronous load status</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleLoadProgressReport
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the current load context after a wtxObjModuleLoadStart
request.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<p>
Load a module on the target and its load status is evaluated.
<p>
<pre>tcl&gt; wtxObjModuleLoadStart /vobs/wpwr/target/lib/objMC68020gnutest/big.o
tcl&gt; wtxObjModuleLoadProgressReport
1 0 0
tcl&gt; wtxObjModuleLoadProgressReport
3 90092 45276
tcl&gt; wtxObjModuleLoadProgressReport
0xfec008 0x71640 0xffffffff 0xffffffff
tcl&gt; wtxObjModuleLoadProgressReport
WTX Error 0x10007 (SVR_EINVAL)
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
If the load is in progress, then status is returned in a 3 values list:<br>
&nbsp;&nbsp;&nbsp;&nbsp;x&nbsp;y&nbsp;z,&nbsp;where&nbsp;x&nbsp;is&nbsp;the&nbsp;load&nbsp;state;&nbsp;y&nbsp;and&nbsp;z&nbsp;are&nbsp;the&nbsp;max&nbsp;value&nbsp;for&nbsp;this<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;state&nbsp;and&nbsp;the&nbsp;current&nbsp;value.&nbsp;x&nbsp;can&nbsp;take&nbsp;3&nbsp;values:&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<b>LOAD_PENDING</b>&nbsp;(0),&nbsp;<b>LOAD_INITIALIZED</b>&nbsp;(1),&nbsp;<b>LOAD_DOWNLOADING</b>&nbsp;(3)><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;y&nbsp;and&nbsp;z&nbsp;are&nbsp;relevant&nbsp;only&nbsp;with&nbsp;<b>LOAD_DOWNLOADING</b>&nbsp;state.
If the load is done, the ID of the newly loaded module is returned, 
followed by the text, data, and bss addresses of the module sections.
If there are symbols in the module that cannot be resolved against other
modules on the target, a list of these is appended to the result.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_OBJ_MODULE_LOAD_2" >WTX_OBJ_MODULE_LOAD_2</a></b>, <b><i><a href="../wtxc/wtx.html#wtxObjModuleLoadStart" >wtxObjModuleLoadStart</a></i>(&nbsp;)</b>,  
<b><i><a href="../wtxc/wtx.html#wtxObjModuleLoad" >wtxObjModuleLoad</a></i>(&nbsp;)</b>, <b><i><a href="../wtxc/wtx.html#wtxObjModuleLoadCancel" >wtxObjModuleLoadCancel</a></i>(&nbsp;)</b>

<hr>
<a name="wtxObjModuleLoadCancel"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleLoadCancel</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleLoadCancel</strong> - Stop an asynchronous load request</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleLoadCancel
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine stops an asynchronous load request. If the load had been
already done or it can't be found, then it returns an error. 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>TCL_OK</b> or <b>TCL_ERROR</b> on error.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_COMMAND_SEND" >WTX_COMMAND_SEND</a></b>, wtxObjModuleLoadStart,  
wtxObjModuleLoadProgressReport

<hr>
<a name="wtxAsyncNotifyEnable"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxAsyncNotifyEnable</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxAsyncNotifyEnable</strong> - Start the asynchronous event notification</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxAsyncNotifyEnable userDefinedTclHookRoutine
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function creates a socket-based link between the target server and
the client.
<p>
In conjunction with wtxAsyncNotifyEnable, wtxRegisterForEvent (or
wtxUnregisterForEvent) must be used to specify which type of events must
be sent to the requester.
<p>
When this service is started, all requests wtxEventGet or wtxEventListGet
will return an empty result because when an event is coming in the target
server, it is staightaway sent to the client and not store in the target
server event list. So, an wtxEventGet request will find an empty list.
<p>
When an event is coming to the client, the event is put in a list in the
same ouput format as wtxEventGet: {eventstring [mblk]}.
<p>
All strings contained in the <b>EVENT_DESC</b> structure must be copied before to
be used because their life duration is depending on the events stream.
<p>
</blockquote><h4>RETURN</h4><blockquote><p>
<b>TCL_OK</b> or <b>TCL_ERROR</b> if something failed.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, wtxAsyncNotifyDisable

<hr>
<a name="wtxAsyncNotifyDisable"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxAsyncNotifyDisable</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxAsyncNotifyDisable</strong> - Stop the asynchronous event notification</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxAsyncNotifyDisable
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
his function sends to the target server an order to stop the asynchronous
notification of events.
<p>
</blockquote><h4>RETURN</h4><blockquote><p>
<b>TCL_OK</b> or <b>TCL_ERROR</b> if something failed.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
No error messages.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, wtxAsyncNotifyEnable

<hr>
<a name="wtxExecutableFind"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxExecutableFind</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxExecutableFind</strong> - WDB / WTX requests executable path via document name</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxExecutableFind filename
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function returns a pathname for the executable associated with <b>open</b>
Windows shell acction on a given type of document. File with filename must 
exist and have a registered Windows extension (e.g. .html, .doc, .bmp etc)
Function works on Win32 only and returns <b>TCL_ERROR</b> if called on Unix.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
Input filename can contain <b>\</b> or <b>/</b> characters as directory seprators in 
pathname. When wtxExecutableFind returns, returned pathname has forward
slashes "/" and may contain spaces. In recent versions of Win32 cannot be 
longer than 260 bytes and short-name equivavalent is returned.
The result may contain the path to the DDE server or DLL.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Full blown Win32 pathname starting with drive letter or pathname in UNC
form or [possibly] path to DDE server.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>tcl&gt; wtxExecutableFind c:/MyTestDocumentThatDoesExist.htm
C:\Program Files\Microsoft Internet\Iexplore.exe
</pre>

</blockquote><h4>ERRORS</h4><blockquote><p>
<dl>
<dt>
no association
<dd>

There is no association for the specified file type. 
<p>
<dt>
file not found
<dd>

The specified file was not found.
<p>
<dt>
path not found
<dd>

The specified path was not found.
<p>
<dt>
exe file is invalid
<dd>

The .EXE file is invalid (non-Win32 .EXE or error in .EXE image). 
<p>
<dt>
out of memory
<dd>

System is low on or out of memory. 
<p>
<dt>
unknown error
<dd>

System returned unexpected error. 
<p>
<dt>
not implemented
<dd>
 Not implemented for this platform. 
<p>
</dl>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, * wtxtcl

</body>
</html>