Documentation  |   Table of Contents   |  < Previous   |  Next >  

130    VFSMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

The VFS Manager APIs are largely unchanged.

Due to security and architectural requirements imposed by the new runtime model, Palm OS Cobalt doesn't support 68K-style file system plug-ins. Other changes in the file system plug-in architecture necessitated the removal of those functions used to mainpulate file system plug-ins. Because third-party applications were not likely to have been manipulating file system plug-ins, however, the removal of those functions should have little, if any effect on a applications.

Deleted APIs ^TOP^

Table 130.1  Deleted functions

Deleted API

Use instead

VFSInit()

Nothing. This function was documented as "System Use Only" and should not have been used by applications.

VFSInstallFSLib()

Nothing. Applications cannot manipulate file system plug-ins in Palm OS Cobalt, version 6.0.

VFSRemoveFSLib()

Nothing. Applications cannot manipulate file system plug-ins in Palm OS Cobalt, version 6.0.

Table 130.2  Deleted macros

Deleted API

Use instead

VFSMGR_TRAP()

Nothing. The VFS Manager is a standard part of the operating system in Palm OS Cobalt.

Table 130.3  Deleted #defines

Deleted API

Use instead

sysTrapVFSMgr

See "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

vfsMaxSelector

See "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

vfsMountClass_Simulator

One of the other mount classes. Note that in Palm OS Cobalt there are now big-endian variants of the supported mount classes.

vfsTrap...

See "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

Modified APIs ^TOP^

Table 130.4  Modified functions

Modified API

Description of change

status_t VFSExportDatabaseToFile (uint16_t, const char *, DatabaseID)

The card number parameter has been removed.

status_t VFSExportDatabaseToFileCustom (uint16_t, const char *, DatabaseID, VFSExportProcPtr, void *)

The card number parameter has been removed.

status_t VFSImportDatabaseFromFile (uint16_t, const char *, DatabaseID *)

The card number parameter has been removed.

status_t VFSImportDatabaseFromFileCustom (uint16_t, const char *, DatabaseID *, VFSImportProcPtr, void *)

The card number parameter has been removed.

Table 130.5  Modified structures

Modified API

Description of change

FileInfoType

A reserved field has been added to this structure.

VFSAnyMountParamType

The reserved field is now named size.

VFSPOSEMountParamType

Two reserved fields have been added to this structure.

Table 130.6  Modified #defines

Modified API

Description of change

#define vfsMgrVersionNum ((uint16_t)300)

Previously this had a value of 200.

Unchanged APIs ^TOP^

Table 130.7  Unchanged functions

VFSCustomControl()

VFSDirCreate()

VFSDirEntryEnumerate()

VFSFileClose()

VFSFileCreate()

VFSFileDBGetRecord()

VFSFileDBGetResource()

VFSFileDBInfo()

VFSFileDelete()

VFSFileEOF()

VFSFileGetAttributes()

VFSFileGetDate()

VFSFileOpen()

VFSFileRead()

VFSFileReadData()

VFSFileRename()

VFSFileResize()

VFSFileSeek()

VFSFileSetAttributes()

VFSFileSetDate()

VFSFileSize()

VFSFileTell()

VFSFileWrite()

VFSGetDefaultDirectory()

VFSRegisterDefaultDirectory()

VFSUnregisterDefaultDirectory()

VFSVolumeEnumerate()

VFSVolumeFormat()

VFSVolumeGetLabel()

VFSVolumeInfo()

VFSVolumeMount()

VFSVolumeSetLabel()

VFSVolumeSize()

VFSVolumeUnmount()

Table 130.8  Unchanged structures

VFSSlotMountParamType

VolumeInfoType

Table 130.9  Unchanged types

FileOrigin

FileRef

VFSAnyMountParamPtr

Table 130.10  Unchanged #defines 

vfsErrBadData

vfsErrBadName

vfsErrBufferOverflow

vfsErrDirectoryNotFound

vfsErrDirNotEmpty

vfsErrFileAlreadyExists

vfsErrFileBadRef

vfsErrFileEOF

vfsErrFileGeneric

vfsErrFileNotFound

vfsErrFilePermissionDenied

vfsErrFileStillOpen

vfsErrIsADirectory

vfsErrNameShortened

vfsErrNoFileSystem

vfsErrNotADirectory

vfsErrUnimplemented

vfsErrVolumeBadRef

vfsErrVolumeFull

vfsErrVolumeStillMounted

vfsFileAttrAll

vfsFileAttrArchive

vfsFileAttrDirectory

vfsFileAttrHidden

vfsFileAttrLink

vfsFileAttrReadOnly

vfsFileAttrSystem

vfsFileAttrVolumeLabel

vfsFileDateAccessed

vfsFileDateCreated

vfsFileDateModified

vfsFilesystemType_AFS

vfsFilesystemType_EXT2

vfsFilesystemType_FAT

vfsFilesystemType_FFS

vfsFilesystemType_HFS

vfsFilesystemType_HFSPlus

vfsFilesystemType_HPFS

vfsFilesystemType_MFS

vfsFilesystemType_NFS

vfsFilesystemType_Novell

vfsFilesystemType_NTFS

vfsFilesystemType_VFAT

vfsFtrIDDefaultFS

vfsFtrIDVersion

vfsHandledStartPrc

vfsHandledUIAppSwitch

vfsInvalidFileRef

vfsInvalidVolRef

vfsIteratorStart

vfsIteratorStop

vfsModeAll

vfsModeCreate

vfsModeExclusive

vfsModeLeaveOpen

vfsModeRead

vfsModeReadWrite

vfsModeTruncate

vfsModeVFSLayerOnly

vfsModeWrite

vfsMountClass_POSE

vfsMountClass_SlotDriver

vfsMountFlagsReserved1

vfsMountFlagsReserved2

vfsMountFlagsReserved3

vfsMountFlagsReserved4

vfsMountFlagsReserved5

vfsMountFlagsUseThisFileSystem

vfsOriginBeginning

vfsOriginCurrent

vfsOriginEnd

vfsVolumeAttrHidden

vfsVolumeAttrReadOnly

vfsVolumeAttrSlotBased

Table 130.11  Unchanged application-defined functions

VFSExportProcPtr()

VFSImportProcPtr()