Veritas™ File System 5.0.1 Programmer's Reference Guide

information about the current position in the FCL file using vxfs_fcl_getcookie
and then store the cookie in a persistent structure such as a file. The next time
the application needs to perform an incremental operation, it reads the cookie
and passes it to vxfs_fcl_seek to seek to the point where it left off. This enables
the application to read only the new FCL records.
Parameters
The following is the syntax for the vxfs_fcl_getcookie function:
int vxfs_fcl_getcookie(void *handle, struct fcl_cookie *cookie)
The function parameters are as follows:
■ *handle is the FCL file handle returned by a call to vxf_fcl_open
■ *cookie is a pointer to an opaque data block defined as follows:
struct fcl_cookie {
char fc_bytes[24];
};
The data stored in the cookie is internal to the VxFS library. The application should
not assume any internal representation for the cookie or tamper with the data in
the cookie.
vxfs_fcl_seek
You can use vxfs_fcl_seek to seek to the start or end of an FCL file depending
on the flag passed to it.
See “vxfs_fcl_getcookie” on page 32.
Parameters
The following is the syntax for the vxfs_fcl_seek() function:
int vxfs_fcl_seek(void *handle, struct fcl_cookie *cookie, int where)
The function parameters are as follows:
■ The *handle parameter should be the same handle that was returned by the
most recent call to vxfs_fcl_open(). This is not necessarily the same handle
used in vxfs_fcl_getcookie(). The application may open the FCL file, get the
cookie, and close the FCL file in one session, and then open the FCL file and
submit the saved cookie in a later session. For each open session on the FCL
file, the valid handle is the one returned by vxfs_fcl_open() for that session.
33File Change Log
Application programming interface for File Change Log