usrfslib.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#copy">copy</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>
<p>


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

</blockquote><h1>copy(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>copy(&nbsp;)</strong> - copy <i>in</i> (or stdin) to <i>out</i> (or stdout)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS copy
    (
    const char * in,          /* name of file to read (if NULL assume stdin) */
    const char * out          /* name of file to write (if NULL assume */
                              /* stdout) */ 
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command copies from the input file to the output file, until an
end-of-file is reached.
<p>
</blockquote><h4>EXAMPLES</h4><blockquote><p>
<p>
The following example displays the file <b>dog</b>, found on the default file
device:
<pre>    -&gt; copy &lt;dog
</pre>
This example copies from the console to the file <b>dog</b>, on device <b>/ct0/</b>,
until an EOF (default ^D) is typed:
<pre>    -&gt; copy &gt;/ct0/dog
</pre>
This example copies the file <b>dog</b>, found on the default file device, to
device <b>/ct0/</b>:
<pre>    -&gt; copy &lt;dog &gt;/ct0/dog
</pre>
This example makes a conventional copy from the file named <b>file1</b> to the file
named <b>file2</b>:
<pre>    -&gt; copy "file1", "file2"
</pre>
Remember that standard input and output are global; therefore, spawning
the first three constructs will not work as expected.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
OK, or
ERROR if <i>in</i> or <i>out</i> cannot be opened/created, or if there is an
error copying from <i>in</i> to <i>out</i>.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#copyStreams">copyStreams</a>(&nbsp;)</b>, <b><a href="./tyLib.html#tyEOFSet">tyEOFSet</a>(&nbsp;)</b>, <b><a href="./usrFsLib.html#cp">cp</a>(&nbsp;)</b>, <b><a href="./usrFsLib.html#xcopy">xcopy</a>(&nbsp;)</b>
<i>VxWorks Programmer's Guide: Target Shell</i>

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

</blockquote><h1>chkdsk(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>chkdsk(&nbsp;)</strong> - perform consistency checking on a MS-DOS file system</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS chkdsk
    (
    const char * pDevName,    /* device name */
    u_int        repairLevel, /* how to fix errors */
    u_int        verbose      /* verbosity level */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function invokes the integral consistency checking built
into the <b><a href="./dosFsLib.html#top">dosFsLib</a></b> file system, via FIOCHKDSK ioctl.
During the test, the file system will be blocked from application code
access, and will emit messages describing any inconsistencies found on
the disk, as well as some statistics, depending on the value of the
<i>verbose</i> argument.
Depending the value of <i>repairLevel</i>, the inconsistencies will be
repaired, and changes written to disk.
<p>
These are the values for <i>repairLevel</i>:
<table>
</tr>
<tr valign=top><td>
0
<td>Same as <b>DOS_CHK_ONLY</b> (1)
</tr>
<tr valign=top><td>
<b>DOS_CHK_ONLY</b> (1)
<td>Only report errors, do not modify disk.
</tr>
<tr valign=top><td>
<b>DOS_CHK_REPAIR</b> (2)
<td>Repair any errors found.
<p>
These are the values for <i>verbose</i>:
</tr>
<tr valign=top><td>
0
<td>similar to <b>DOS_CHK_VERB_1</b>
</tr>
<tr valign=top><td>
<b>DOS_CHK_VERB_SILENT</b> (0xff00)
<td>Do not emit any messages, except errors encountered.
</tr>
<tr valign=top><td>
<b>DOS_CHK_VERB_1</b> (0x0100)
<td>Display some volume statistics when done testing, as well
as errors encountered during the test.
</tr>
<tr valign=top><td>
<b>DOS_CHK_VERB_2</b> (0x0200)
<td>In addition to the above option, display path of every file, while it
is being checked. This option may significantly slow down
the test process.
<p>
Note that the consistency check procedure will
<i>unmount </i>
the file system, meaning the all currently open file descriptors will
be deemed unusable.
</table>

</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if device can not be checked or could not be repaired.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>

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

</blockquote><h1>dirList(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>dirList(&nbsp;)</strong> - list contents of a directory (multi-purpose)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS dirList
    (
    int    fd,                /* file descriptor to write on */
    char * dirName,           /* name of the directory to be listed */
    BOOL   doLong,            /* if TRUE, do long listing */
    BOOL   doTree             /* if TRUE, recurse into subdirs */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command is similar to UNIX ls.  It lists the contents of a directory
in one of two formats.  If <i>doLong</i> is FALSE, only the names of the files
(or subdirectories) in the specified directory are displayed.  If <i>doLong</i>
is TRUE, then the file name, size, date, and time are displayed.
If <i>doTree</i> flag is TRUE, then each subdirectory encountered
will be listed as well (i.e. the listing will be recursive).
<p>
The <i>dirName</i> parameter specifies the directory to be listed.
If <i>dirName</i> is omitted or NULL, the current working directory will be
listed. <i>dirName</i> may contain wildcard characters to list some
of the directory's contents.
<p>
</blockquote><h4>LIMITATIONS</h4><blockquote><p>
<table>
</tr>
<tr valign=top><td>
-
<td>With <b><a href="./dosFsLib.html#top">dosFsLib</a></b> file systems, MS-DOS volume label entries are not reported.
</tr>
<tr valign=top><td>
-
<td>Although an output format very similar to UNIX "ls" is employed,
some information items have no particular meaning on some
file systems.
</tr>
<tr valign=top><td>
-
<td>Some file systems which do not support the POSIX compliant <b>dirLib(&nbsp;)</b>
interface, can not support the <i>doLong</i> and <i>doTree</i> options.
</table>

</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./dirLib.html#top">dirLib</a></b>, <b><a href="./dosFsLib.html#top">dosFsLib</a></b>, <b><a href="./usrFsLib.html#ls">ls</a>(&nbsp;)</b>, <b><a href="./usrFsLib.html#ll">ll</a>(&nbsp;)</b>, <b><a href="./usrFsLib.html#lsr">lsr</a>(&nbsp;)</b>, <b><a href="./usrFsLib.html#llr">llr</a>(&nbsp;)</b>

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

</blockquote><h1>ls(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>ls(&nbsp;)</strong> - generate a brief listing of a directory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS ls
    (
    char * dirName,           /* name of dir to list */
    BOOL   doLong             /* switch on details */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function is simply a front-end for <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>, intended for
brevity and backward compatibility. It produces a list of files
and directories, without details such as file size and date,
and without recursion into subdirectories.
<p>
<i>dirName</i> is a name of a directory or file, and may contain wildcards.
<i>doLong</i> is provided for backward compatibility.
<p>
<dl>
<dt>
NOTE
<dd>
This is a target resident function, which manipulates the target I/O
system. It must be preceded with the
<b>@</b> letter if executed from the Tornado Shell (windsh), which has a
built-in command of the same name that operates on the Host's I/O
system.
</dl>

</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>

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

</blockquote><h1>ll(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>ll(&nbsp;)</strong> - generate a long listing of directory contents</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command causes a long listing of a directory's contents to be
displayed.  It is equivalent to:
<pre>    -&gt; dirList 1, dirName, TRUE, FALSE
</pre>

<i>dirName</i> is a name of a directory or file, and may contain wildcards.
<p>
<dl>
<dt>

</blockquote><h4>NOTE 1</h4><blockquote><p>

<dd>
This is a target resident function, which manipulates the target I/O
system. It must be preceded with the
<b>@</b> letter if executed from the Tornado Shell (windsh), which has a
built-in command of the same name that operates on the Host's I/O
system.
<p>
<dt>

</blockquote><h4>NOTE 2</h4><blockquote><p>

<dd>
When used with <b><a href="./netDrv.html#top">netDrv</a></b> devices (FTP or RSH), <b><a href="./usrFsLib.html#ll">ll</a>(&nbsp;)</b> does not give
directory information.  It is equivalent to an <b><a href="./usrFsLib.html#ls">ls</a>(&nbsp;)</b> call with no
long-listing option.
</dl>

</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>

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

</blockquote><h1>lsr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>lsr(&nbsp;)</strong> - list the contents of a directory and any of its subdirectories</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS lsr
    (
    char * dirName            /* name of dir to list */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function is simply a front-end for <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>, intended for
brevity and backward compatibility. It produces a list of files
and directories, without details such as file size and date,
with recursion into subdirectories.
<p>
<i>dirName</i> is a name of a directory or file, and may contain wildcards.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>

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

</blockquote><h1>llr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>llr(&nbsp;)</strong> - do a long listing of directory and all its subdirectories contents</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command causes a long listing of a directory's contents to be
displayed.  It is equivalent to:
<pre>    -&gt; dirList 1, dirName, TRUE, TRUE
</pre>
 *
<i>dirName</i> is a name of a directory or file, and may contain wildcards.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
When used with <b><a href="./netDrv.html#top">netDrv</a></b> devices (FTP or RSH), <b><a href="./usrFsLib.html#ll">ll</a>(&nbsp;)</b> does not give
directory information.  It is equivalent to an <b><a href="./usrFsLib.html#ls">ls</a>(&nbsp;)</b> call with no
long-listing option.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./usrFsLib.html#top">usrFsLib</a></b>, <b><a href="./usrFsLib.html#dirList">dirList</a>(&nbsp;)</b>

<hr>
<a name="cp"></a>