usrlib.html

来自「Vxworks API操作系统和驱动程序设计API。压缩的HTML文件」· HTML 代码 · 共 1,413 行 · 第 1/4 页

<pre>void td
    (
    int taskNameOrId          /* task name or task ID */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command deletes a specified task.  It simply calls <b><a href="./taskLib.html#taskDelete">taskDelete</a>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./taskLib.html#taskDelete">taskDelete</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="version"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>version(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>version(&nbsp;)</strong> - print VxWorks version information</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void version (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command prints the VxWorks version number, the date this copy of
VxWorks was made, and other pertinent information.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>-&gt; version
VxWorks (for Mizar 7170) version 5.1
Kernel: WIND version 2.1.
Made on Tue Jul 27 20:26:23 CDT 1997.
Boot line:
enp(0,0)host:/usr/wpwr/target/config/mz7170/vxWorks e=90.0.0.50 h=90.0.0.4 u=target
value = 1 = 0x1
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="m"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>m(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>m(&nbsp;)</strong> - modify memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void m
    (
    void * adrs,              /* address to change */
    int    width              /* width of unit to be modified (1, 2, 4, 8) */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command prompts the user for modifications to memory in byte, short
word, or long word specified by <i>width</i>, starting at the specified address.
It prints each address and the current contents of that address, in turn.
If <i>adrs</i> or <i>width</i> is zero or absent, it defaults to the previous value.
The user can respond in one of several ways:
<dl>
<dt>
RETURN
<dd>
Do not change this address, but continue, prompting at the next address.
<dt>
<i>number</i>
<dd>
Set the content of this address to <i>number</i>.
<dt>
. (dot)
<dd>
Do not change this address, and quit.
<dt>
EOF
<dd>
Do not change this address, and quit.
</dl>
All numbers entered and displayed are in hexadecimal.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./usrLib.html#mRegs">mRegs</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>
<p>


<hr>
<a name="d"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>d(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>d(&nbsp;)</strong> - display memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void d
    (
    void * adrs,              /* address to display (if 0, display next block */
    int    nunits,            /* number of units to print (if 0, use default) */
    int    width              /* width of displaying unit (1, 2, 4, 8) */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command displays the contents of memory, starting at <i>adrs</i>.
If <i>adrs</i> is omitted or zero, <b><a href="./usrLib.html#d">d</a>(&nbsp;)</b> displays the next memory block, starting
from where the last <b><a href="./usrLib.html#d">d</a>(&nbsp;)</b> command completed.
<p>
Memory is displayed in units specified by <i>width</i>.  If <i>nunits</i> is omitted
or zero, the number of units displayed defaults to last use.  If
<i>nunits</i> is non-zero, that number of units is displayed and that number
then becomes the default.  If <i>width</i> is omitted or zero, it defaults
to the previous value.  If <i>width</i> is an invalid number, it is set to 1.
The valid values for <i>width</i> are 1, 2, 4, and 8.  The number of units <b><a href="./usrLib.html#d">d</a>(&nbsp;)</b>
displays is rounded up to the nearest number of full lines.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./usrLib.html#m">m</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="ld"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>ld(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>ld(&nbsp;)</strong> - load an object module into memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>MODULE_ID ld
    (
    int    syms,              /* -1, 0, or 1 */
    BOOL   noAbort,           /* TRUE = don't abort script on error */
    char * name               /* name of object module, NULL = standard input */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command loads an object module from a file or from standard input.
The object module must be in UNIX <b>a.out</b> format.  External references in
the module are resolved during loading.  The <i>syms</i> parameter determines how
symbols are loaded; possible values are:
<p>
&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;-&nbsp;Add&nbsp;global&nbsp;symbols&nbsp;to&nbsp;the&nbsp;system&nbsp;symbol&nbsp;table.<br>
&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;-&nbsp;Add&nbsp;global&nbsp;and&nbsp;local&nbsp;symbols&nbsp;to&nbsp;the&nbsp;system&nbsp;symbol&nbsp;table.<br>
&nbsp;&nbsp;&nbsp;-1&nbsp;-&nbsp;Add&nbsp;no&nbsp;symbols&nbsp;to&nbsp;the&nbsp;system&nbsp;symbol&nbsp;table.
<p>
If there is an error during loading (e.g., externals undefined, too many
symbols, etc.), then <b><a href="./shellLib.html#shellScriptAbort">shellScriptAbort</a>(&nbsp;)</b> is called to stop any script that
this routine was called from.  If <i>noAbort</i> is TRUE, errors are noted but
ignored.
<p>
The normal way of using <b><a href="./usrLib.html#ld">ld</a>(&nbsp;)</b> is to load all symbols (<i>syms</i> = 1) during
debugging and to load only global symbols later.
<p>
The routine <b><a href="./usrLib.html#ld">ld</a>(&nbsp;)</b> is a <b>shell command</b>.  That is, it is designed to
be used only in the shell, and not in code running on the target.
In future releases, calling <b><a href="./usrLib.html#ld">ld</a>(&nbsp;)</b> directly from code may not be
supported.
<p>
</blockquote><h4>COMMON SYMBOLS</h4><blockquote><p>
On the target shell, for the <b>ld</b> command only, common symbol behavior is 
determined by the value of the global variable, ldCommonMatchAll.
The reasoning for ldCommonMatchAll matches the purpose
of the windsh environment variable, <b>LD_COMMON_MATCH_ALL</b> as explained below.
<p>
If ldCommonMatchAll is set to TRUE (equivalent to windsh
"<b>LD_COMMON_MATCH_ALL</b>=on"), the loader trys to match a common symbol
with an existing one.  If a symbol with the same name is already
defined, the loader takes its address. Otherwise, the loader creates
a new entry. If set to FALSE (equivalent to windsh
"<b>LD_COMMON_MATCH_ALL</b>=off"), the loader does not try to find an
existing symbol. It creates an entry for each common symbol.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
The following example loads the <b>a.out</b> file <b>module</b> from the default file
device into memory, and adds any global symbols to the symbol table:
<pre>    -&gt; ld &lt;module
</pre>
This example loads <b>test.o</b> with all symbols:
<pre>    -&gt; ld 1,0,"test.o"
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
<b>MODULE_ID</b>, or
NULL if there are too many symbols, the object file format is invalid, or
there is an error reading the file.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./loadLib.html#top">loadLib</a></b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="devs"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>devs(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>devs(&nbsp;)</strong> - list all system-known devices</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void devs (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command displays a list of all devices known to the I/O system.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./iosShow.html#iosDevShow">iosDevShow</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="lkup"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>lkup(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>lkup(&nbsp;)</strong> - list symbols</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void lkup
    (
    char * substr             /* substring to match */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command lists all symbols in the system symbol table whose names
contain the string <i>substr</i>.  If <i>substr</i> is omitted or is 0, a short
summary of symbol table statistics is printed.  If <i>substr</i> is the empty
string (""), all symbols in the table are listed.  
<p>
This command also displays symbols that are local, i.e., symbols found in
the system symbol table only because their module was loaded by <b><a href="./usrLib.html#ld">ld</a>(&nbsp;)</b>.
<p>
By default, <b><a href="./usrLib.html#lkup">lkup</a>(&nbsp;)</b> displays 22 symbols at a time.  This can be changed 
by modifying the global variable <b>symLkupPgSz</b>.  If this variable is set
to 0, <b><a href="./usrLib.html#lkup">lkup</a>(&nbsp;)</b> displays all the symbols without interruption.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./symLib.html#top">symLib</a></b>, <b><a href="./symLib.html#symEach">symEach</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="lkAddr"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>lkAddr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>lkAddr(&nbsp;)</strong> - list symbols whose values are near a specified value</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void lkAddr
    (
    unsigned int addr         /* address around which to look */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command lists the symbols in the system symbol table that
are near a specified value.  The symbols that are displayed include:
<ul>

<li>symbols whose values are immediately less than the specified value</li>
<li>symbols with the specified value</li>
<li>succeeding symbols, until at least 12 symbols have been displayed</li>
</ul>

<p>

This command also displays symbols that are local, i.e., symbols found in
the system symbol table only because their module was loaded by <b><a href="./usrLib.html#ld">ld</a>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><a href="./symLib.html#top">symLib</a></b>, <b><a href="./symLib.html#symEach">symEach</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell,  </i>
<b><a href="../../tornado/tools/windsh.html#top" >windsh</a></b>,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="mRegs"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>mRegs(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>mRegs(&nbsp;)</strong> - modify registers</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS mRegs
    (
    char * regName,           /* register name, NULL for all */
    int    taskNameOrId       /* task name or task ID, 0 = default task */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command modifies the specified register for the specified task.
If <i>taskNameOrId</i> is omitted or zero, the last task referenced is assumed.
If the specified register is not found, it prints out the valid register list
and returns ERROR.  If no register is specified, it sequentially prompts
the user for new values for a task's registers.  It displays each register
and the current contents of that register, in turn.  The user can respond
in one of several ways:
<dl>
<dt>
RETURN
<dd>
Do not change this register, but continue, prompting at the next register.
<dt>
<i>number</i>
<dd>
Set this register to <i>number</i>.
<dt>
. (dot)
<dd>
Do not change this register, and quit.