Veritas™ File System 5.0.1 Programmer's Reference Guide

meta-information about the FCL file into an opaque internal data structure and
populates **handle with a pointer.
Just like the lseek(2) and read(2) system calls, the FCL file **handle has an internal
offset to indicate the position in the file from where the next read starts. When
the FCL file is successfully opened, this offset is set to the first valid offset in the
FCL file.
Return value
Upon successful completion, a “0” is returned to the caller and the handle is
non-NULL. Otherwise, the API returns a non-zero value is and the handle is set
to NULL. The global value errno is also set to indicate the error.
vxfs_fcl_close
vxfs_fcl_close closes the FCL file referenced by handle. All data structures
allocated with this handle are cleaned. You should not use this handle after a call
to vxfs_fcl_close.
Parameters
void vxfs_fcl_close(void *handle)
*handle is a valid handle returned by the previous call to vxfs_fcl_open.
vxfs_fcl_getinfo
int vxfs_fcl_getinfo(void *handle, struct fcl_info*fclinfo);
The vxfs_fcl_getinfo function returns information about the FCL file in the
FCL information structure pointed to by fcl_info. It obtains this information
from the FCL superblock.
struct fcl_info {
uint32_tfcl_version;
uint32_tfcl_state;
};
An intelligent application that is aware of the record types associated with each
can decide from fcl_version, whether the FCL file contains the needed
information. For instance, a Version 3 FCL file never contains access information
along with an FCL record. If fcl_state is FCLS_OFF, the application can then infer
that there are no records added to the FCL file due to file system activity.
File Change Log
Application programming interface for File Change Log
30