usrlib.html

vxworks相关论文

directory entries on RT-11 disks (i.e., the entries that describe
unallocated sections of an RT-11 disk).
<p>
If no directory name is specified, the current working directory is listed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the directory cannot be opened.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="mkdir"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>mkdir</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>mkdir</i>(&nbsp;)</strong> - make a directory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS mkdir
    (
    char * dirName /* directory name */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command creates a new directory in a hierarchical file system.
The <i>dirName</i> string specifies the name to be used for the
new directory, and can be either a full or relative pathname.
<p>
This call is supported by the VxWorks NFS and dosFs file systems.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the directory cannot be created.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./usrLib.html#rmdir">rmdir</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="rmdir"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>rmdir</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>rmdir</i>(&nbsp;)</strong> - remove a directory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS rmdir
    (
    char * dirName /* name of directory to remove */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command removes an existing directory from a hierarchical file
system.  The <i>dirName</i> string specifies the name of the directory to
be removed, and may be either a full or relative pathname.
<p>
This call is supported by the VxWorks NFS and dosFs file systems.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the directory cannot be removed.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./usrLib.html#mkdir">mkdir</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="rm"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>rm</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>rm</i>(&nbsp;)</strong> - remove a file</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS rm
    (
    char * fileName /* name of file to remove */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command is provided for UNIX similarity.  It simply calls <b><i><a href="./ioLib.html#remove">remove</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the file cannot be removed.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./ioLib.html#remove">remove</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

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

</blockquote><h1><i>devs</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>devs</i>(&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><i><a href="./iosShow.html#iosDevShow">iosDevShow</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell, </i>
windsh,  
<i>Tornado User's Guide: Shell</i>

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

</blockquote><h1><i>lkup</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>lkup</i>(&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><i><a href="./usrLib.html#ld">ld</a></i>(&nbsp;)</b>.
<p>
By default, <b><i><a href="./usrLib.html#lkup">lkup</a></i>(&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><i><a href="./usrLib.html#lkup">lkup</a></i>(&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><i><a href="./symLib.html#symEach">symEach</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell, </i>
windsh,  
<i>Tornado User's Guide: Shell</i>

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

</blockquote><h1><i>lkAddr</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>lkAddr</i>(&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 
</ul>

<p>

<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><i><a href="./usrLib.html#ld">ld</a></i>(&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><i><a href="./symLib.html#symEach">symEach</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell, </i>
windsh,  
<i>Tornado User's Guide: Shell</i>

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

</blockquote><h1><i>mRegs</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>mRegs</i>(&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.
<p>
<dt>
<i>number</i>
<dd>

Set this register to <i>number</i>.
<p>
<dt>
. (dot)
<dd>

Do not change this register, and quit.
<p>
<dt>
EOF
<dd>
 Do not change this register, and quit. 
</dl>

<p>

All numbers are entered and displayed in hexadecimal, except
floating-point values, which may be entered in double precision.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the task or register does not exist.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./usrLib.html#m">m</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>
windsh,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="pc"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>pc</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>pc</i>(&nbsp;)</strong> - return the contents of the program counter</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int pc
    (
    int task /* task ID */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of the program counter for a specified
task from the task's TCB.  If <i>task</i> is omitted or 0, 
the current task is used.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the program counter.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrLib.html#top">usrLib</a></b>, <b><i><a href="./usrLib.html#ti">ti</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="printErrno"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>printErrno</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>printErrno</i>(&nbsp;)</strong> - print the definition of a specified error status value</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void printErrno
    (
    int errNo /* status code whose name is to be printed */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command displays the error-status string, corresponding to a
specified error-status value.  It is only useful if the error-status
symbol table has been built and included in the system.  If <i>errNo</i> is
zero, then the current task status is used by calling <b><i><a href="./errnoLib.html#errnoGet">errnoGet</a></i>(&nbsp;)</b>.
<p>
This facility is described in errnoLib.
<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="./errnoLib.html#top">errnoLib</a></b>, <b><i><a href="./errnoLib.html#errnoGet">errnoGet</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>
windsh,  
<i>Tornado User's Guide: Shell</i>

<hr>
<a name="printLogo"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>printLogo</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>printLogo</i>(&nbsp;)</strong> - print the VxWorks logo</p>

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

void printLogo (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command displays the VxWorks banner seen at boot time.  It also
displays the VxWorks version number and kern