Veritas™ File System 5.0.1 Programmer's Reference Guide

Returns the FCL version number along with the state (on/off) of
the FCL file
vxfs_fcl_getinfo
Reads FCL records of interest to the user into a buffer passed in
by the user
vxfs_fcl_read
Copies an FCL record. If the source record contains pointers, it
relocates them to point to the new location.
vxfs_fcl_copyrec
Functions for seeking offsets and time stamps in the File
Change Log
Users have the option to seek to a particular point in the File Change Log based
on the offset from where they left off, or to the first record after a specified time.
The following functions can seek offsets and time stamps in the FCL:
Returns an opaque structure (referred to hereinafter as a cookie)
which embeds the current FCL activation time and the current
offset. This cookie can be saved and later passed into
vxfs_fcl_seek to continue reading from where the application
left off last time.
vxfs_fcl_getcookie
Extracts data from the cookie passed and seeks to the specified
offset. A cookie is embedded with the FCL activation time and file
offset.
vxfs_fcl_seek
Seeks to the first record in the FCL after the specified timevxfs_fcl_seektime
vxfs_fcl_open
The following is the syntax for the vxfs_fcl_open function:
int vxfs_fcl_open(char *pathname, int flags, void **handle);
This function opens the FCL file and returns a handle which should be used for
all further accesses to the FCL through the API (for example, vxfs_fcl_read,
vxfs_fcl_seek, etc.).
vxfs_fcl_open has two parameters: *pathname and **handle. The *pathname
can be a pointer to an FCL filename or a mount point. If *pathname is a mount
point, vxfs_fcl_open automatically determines if the FCL is activated on the
mount point and opens the FCL file associated with the mount point (currently
mount_point/lost+found/changelog).
vxfs_fcl_open then determines if it is a valid FCL file, and if the FCL file version
is compatible with the library. The vxfs_fcl_open function then assimilates
29File Change Log
Application programming interface for File Change Log