VxWorks Reference Manual : Libraries
ntPassFsLib - pass-through (to Windows NT) file system library
ntPassFsDevInit( ) - associate a device with ntPassFs file system functions
ntPassFsInit( ) - prepare to use the ntPassFs library
This module is only used with VxSim simulated versions of VxWorks.
This library provides services for file-oriented device drivers to use the Windows NT file standard. In general, the routines in this library are not to be called directly by users, but rather by the VxWorks I/O System.
Before any other routines in ntPassFsLib can be used, the routine ntPassFsInit( ) must be called to initialize this library. The ntPassFsDevInit( ) routine associates a device name with the ntPassFsLib functions. The parameter expected by ntPassFsDevInit( ) is a pointer to a name string, to be used to identify the volume/device. This will be part of the pathname for I/O operations which operate on the device. This name will appear in the I/O system device table, which may be displayed using the iosDevShow( ) routine.
As an example:
ntPassFsInit (1); ntPassFsDevInit ("host:");After the ntPassFsDevInit( ) call has been made, when ntPassFsLib receives a request from the I/O system, it calls the Windows NT I/O system to service the request. Only one volume may be created.
Directories on a ntPassFs volume may be searched using the opendir( ), readdir( ), rewinddir( ), and closedir( ) routines. These calls allow the names of files and sub-directories to be determined.
To obtain more detailed information about a specific file, use the fstat( ) or stat( ) function. Along with standard file information, the structure used by these routines also returns the file attribute byte from a ntPassFs directory entry.
Windows NT file date and time are passed through to VxWorks.
ntPassFsLib.h
ntPassFsLib, ioLib, iosLib, dirLib, ramDrv
ntPassFsDevInit( ) - associate a device with ntPassFs file system functions
void *ntPassFsDevInit ( char * devName /* device name */ )
This routine associates the name devName with the file system and installs it in the I/O System's device table. The driver number used when the device is added to the table is that which was assigned to the ntPassFs library during ntPassFsInit( ).
A pointer to the volume descriptor, or NULL if there is an error.
ntPassFsInit( ) - prepare to use the ntPassFs library
STATUS ntPassFsInit ( int nPassfs /* number of ntPass-through file systems */ )
This routine initializes the ntPassFs library. It must be called exactly once, before any other routines in the library. The argument specifies the number of ntPassFs devices that may be open at once. This routine installs ntPassFsLib as a driver in the I/O system driver table, allocates and sets up the necessary memory structures, and initializes semaphores.
Normally this routine is called from the root task, usrRoot( ), in usrConfig( ). To enable this initialization, define INCLUDE_PASSFS in configAll.h.
Maximum number of ntPass-through file systems is 1.
OK, or ERROR.