dirlib.html

vxworks相关论文

</blockquote><h1><i>rewinddir</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>rewinddir</i>(&nbsp;)</strong> - reset position to the start of a directory (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void rewinddir
    (
    DIR * pDir /* pointer to directory descriptor */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine resets the position pointer in a directory descriptor (DIR).
The <i>pDir</i> parameter is the directory descriptor pointer that was returned
by <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b>.
<p>
As a result, the next <b><i><a href="./dirLib.html#readdir">readdir</a></i>(&nbsp;)</b> will cause the current directory data to be
read in again, as if an <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b> had just been performed.  Any changes
in the directory that have occurred since the initial <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b> will now
be visible.  The first entry in the directory will be returned by the
next <b><i><a href="./dirLib.html#readdir">readdir</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b>, <b><i><a href="./dirLib.html#readdir">readdir</a></i>(&nbsp;)</b>, <b><i><a href="./dirLib.html#closedir">closedir</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>closedir</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>closedir</i>(&nbsp;)</strong> - close a directory (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS closedir
    (
    DIR * pDir /* pointer to directory descriptor */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine closes a directory which was previously opened using
<b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b>.  The <i>pDir</i> parameter is the directory descriptor pointer
that was returned by <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#opendir">opendir</a></i>(&nbsp;)</b>, <b><i><a href="./dirLib.html#readdir">readdir</a></i>(&nbsp;)</b>, <b><i><a href="./dirLib.html#rewinddir">rewinddir</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>fstat</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>fstat</i>(&nbsp;)</strong> - get file status information (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS fstat
    (
    int           fd,   /* file descriptor for file to check */
    struct stat * pStat /* pointer to stat structure */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine obtains various characteristics of a file (or directory).
The file must already have been opened using <b><i><a href="./ioLib.html#open">open</a></i>(&nbsp;)</b> or <b><i><a href="./ioLib.html#creat">creat</a></i>(&nbsp;)</b>.
The <i>fd</i> parameter is the file descriptor returned by <b><i><a href="./ioLib.html#open">open</a></i>(&nbsp;)</b> or <b><i><a href="./ioLib.html#creat">creat</a></i>(&nbsp;)</b>.
<p>
The <i>pStat</i> parameter is a pointer to a <b>stat</b> structure (defined
in <b>stat.h</b>).  This structure must be allocated before <b><i><a href="./dirLib.html#fstat">fstat</a></i>(&nbsp;)</b> is called.
<p>
Upon return, the fields in the <b>stat</b> structure are updated to
reflect the characteristics of the file.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#stat">stat</a></i>(&nbsp;)</b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>stat</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>stat</i>(&nbsp;)</strong> - get file status information using a pathname (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS stat
    (
    char *        name, /* name of file to check */
    struct stat * pStat /* pointer to stat structure */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine obtains various characteristics of a file (or directory).
This routine is equivalent to <b><i><a href="./dirLib.html#fstat">fstat</a></i>(&nbsp;)</b>, except that the <i>name</i> of the file
is specified, rather than an open file descriptor.
<p>
The <i>pStat</i> parameter is a pointer to a <b>stat</b> structure (defined
in <b>stat.h</b>).  This structure must have already been allocated before
this routine is called.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
When used with <b><a href="./netDrv.html#top">netDrv</a></b> devices (FTP or RSH), <b><i><a href="./dirLib.html#stat">stat</a></i>(&nbsp;)</b> returns the size
of the file and always sets the mode to regular; <b><i><a href="./dirLib.html#stat">stat</a></i>(&nbsp;)</b> does not distinguish
between files, directories, links, etc.
<p>
Upon return, the fields in the <b>stat</b> structure are updated to
reflect the characteristics of the file.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#fstat">fstat</a></i>(&nbsp;)</b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>fstatfs</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>fstatfs</i>(&nbsp;)</strong> - get file status information (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS fstatfs
    (
    int             fd,   /* file descriptor for file to check */
    struct statfs * pStat /* pointer to statfs structure */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine obtains various characteristics of a file system.
A file in the file system must already have been opened using <b><i><a href="./ioLib.html#open">open</a></i>(&nbsp;)</b> or <b><i><a href="./ioLib.html#creat">creat</a></i>(&nbsp;)</b>.
The <i>fd</i> parameter is the file descriptor returned by <b><i><a href="./ioLib.html#open">open</a></i>(&nbsp;)</b> or <b><i><a href="./ioLib.html#creat">creat</a></i>(&nbsp;)</b>.
<p>
The <i>pStat</i> parameter is a pointer to a <b>stat</b> structure (defined
in <b>stat.h</b>).  This structure must be allocated before <b><i><a href="./dirLib.html#fstat">fstat</a></i>(&nbsp;)</b> is called.
<p>
Upon return, the fields in the <b>statfs</b> structure are updated to
reflect the characteristics of the file.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#statfs">statfs</a></i>(&nbsp;)</b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>statfs</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>statfs</i>(&nbsp;)</strong> - get file status information using a pathname (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS statfs
    (
    char *          name, /* name of file to check */
    struct statfs * pStat /* pointer to statfs structure */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine obtains various characteristics of a file system.
This routine is equivalent to <b><i><a href="./dirLib.html#fstatfs">fstatfs</a></i>(&nbsp;)</b>, except that the <i>name</i> of the file
is specified, rather than an open file descriptor.
<p>
The <i>pStat</i> parameter is a pointer to a <b>statfs</b> structure (defined
in <b>stat.h</b>).  This structure must have already been allocated before
this routine is called.
<p>
Upon return, the fields in the <b>statfs</b> structure are updated to
reflect the characteristics of the file.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#fstatfs">fstatfs</a></i>(&nbsp;)</b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>utime</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>utime</i>(&nbsp;)</strong> - update time on a file</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int utime
    (
    char *           file,
    struct utimbuf * newTimes
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dirLib.html#top">dirLib</a></b>, <b><i><a href="./dirLib.html#stat">stat</a></i>(&nbsp;)</b>, <b><i><a href="./dirLib.html#fstat">fstat</a></i>(&nbsp;)</b>, <b><i><a href="./usrLib.html#ls">ls</a></i>(&nbsp;)</b>

</body>
</html>