📄 passfslib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/passFsLib.html - generated by refgen from passFsLib.c --> <title> passFsLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>passFsLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>passFsLib</strong> - pass-through (to UNIX) file system library (VxSim) </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./passFsLib.html#passFsDevInit">passFsDevInit</a>( )</b> - associate a device with passFs file system functions<br><b><a href="./passFsLib.html#passFsInit">passFsInit</a>( )</b> - prepare to use the passFs library<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This module is only used with VxSim simulated versions of VxWorks.<p>This library provides services for file-oriented device drivers to usethe UNIX file standard. This module takes care of all the buffering,directory maintenance, and file system details that are necessary.In general, the routines in this library are not to be called directly by users, but rather by the VxWorks I/O System.<p></blockquote><h4>INITIALIZING PASSFSLIB</h4><blockquote><p>Before any other routines in <b><a href="./passFsLib.html#top">passFsLib</a></b> can be used, the routine <b><a href="./passFsLib.html#passFsInit">passFsInit</a>( )</b>must be called to initialize this library.The <b><a href="./passFsLib.html#passFsDevInit">passFsDevInit</a>( )</b> routine associates a device name with the <b><a href="./passFsLib.html#top">passFsLib</a></b>functions. The parameter expected by <b><a href="./passFsLib.html#passFsDevInit">passFsDevInit</a>( )</b> is a pointer toa name string, to be used to identify the volume/device. This will be part ofthe pathname for I/O operations which operate on the device. Thisname will appear in the I/O system device table, which may be displayedusing the <b><a href="./iosShow.html#iosDevShow">iosDevShow</a>( )</b> routine.<p>As an example:<pre> passFsInit (1); passFsDevInit ("host:");</pre>After the <b><a href="./passFsLib.html#passFsDevInit">passFsDevInit</a>( )</b> call has been made, when <b><a href="./passFsLib.html#top">passFsLib</a></b> receives a request from the I/O system, it calls the UNIX I/O system to servicethe request. Only one volume may be created.<p></blockquote><h4>READING DIRECTORY ENTRIES</h4><blockquote><p>Directories on a passFs volume may be searched using the <b><a href="./dirLib.html#opendir">opendir</a>( )</b>,<b><a href="./dirLib.html#readdir">readdir</a>( )</b>, <b><a href="./dirLib.html#rewinddir">rewinddir</a>( )</b>, and <b><a href="./dirLib.html#closedir">closedir</a>( )</b> routines. These calls allow thenames of files and sub-directories to be determined.<p>To obtain more detailed information about a specific file, use the <b><a href="./dirLib.html#fstat">fstat</a>( )</b>or <b><a href="./dirLib.html#stat">stat</a>( )</b> function. Along with standard file information, the structureused by these routines also returns the file attribute byte from a passFsdirectory entry.<p></blockquote><h4>FILE DATE AND TIME</h4><blockquote><p>UNIX file date and time are passed though to VxWorks.<p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>passFsLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./ioLib.html#top">ioLib</a></b>, <b><a href="./iosLib.html#top">iosLib</a></b>, <b><a href="./dirLib.html#top">dirLib</a></b>, <b><a href="./ramDrv.html#top">ramDrv</a></b><hr><a name="passFsDevInit"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>passFsDevInit( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>passFsDevInit( )</strong> - associate a device with passFs file system functions</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void *passFsDevInit ( char * devName /* device name */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine associates the name <i>devName</i> with the file system and installs it in the I/O System's device table. The driver number used whenthe device is added to the table is that which was assigned to thepassFs library during <b><a href="./passFsLib.html#passFsInit">passFsInit</a>( )</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p>A pointer to the volume descriptor, or NULL if there is an error.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./passFsLib.html#top">passFsLib</a></b><hr><a name="passFsInit"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>passFsInit( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>passFsInit( )</strong> - prepare to use the passFs library</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS passFsInit ( int nPassfs /* number of pass-through file systems */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine initializes the passFs library. It must be called exactly once,before any other routines in the library. The argument specifies the numberof passFs devices that may be open at once. This routine installs<b><a href="./passFsLib.html#top">passFsLib</a></b> as a driver in the I/O system driver table, allocates and sets up the necessary memory structures, and initializes semaphores.<p>Normally this routine is called from the root task, <b><a href="./usrConfig.html#usrRoot">usrRoot</a>( )</b>,in <b>usrConfig( )</b>. This initialization is enabled when theconfiguration macro <b>INCLUDE_PASSFS</b> is defined.<p></blockquote><h4>NOTE</h4><blockquote><p>Maximum number of pass-through file systems is 1.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./passFsLib.html#top">passFsLib</a></b></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -