Veritas™ File System 5.0.1 Programmer's Reference Guide

■ The *cookie parameter should point to a valid cookie that has been returned
from a call to vxfs_fcl_getcookie() on the same FCL file or one of its
checkpoints or one of the dumped or restored copies of the same FCL file. It
is the responsibility of the user application to decide which FCL file is valid
for a particular cookie and to use them in a sensible combination.
Note: The *cookie parameter may be NULL if where has a value of FCL_SEEK_SET
or FCL_SEEK_END.
■ The where parameter should have a value of FCL_SEEK_SET, FCL_SEEK_END, or
FCL_SEEK_COOOKIE.
■ If where is FCL_SEEK_SET or FCL_SEEK_END, the *cookie parameter is ignored
and vxfs_fcl_seek() seeks to either the start or end of the FCL file
respectively, that is, where the first FCL record starts or where the last
record ends.
■ If where has a value of FCL_SEEK_COOKIE, vxfs_fcl_seek() extracts the
activation time and offset stored in the *cookie parameter.
If the FCL has been deactivated (switched off) from the time the application
last called the vxfs_fcl_getcookie() function, or if the record at the offset
contained in the *cookie was purged by a hole-punch, vxfs_fcl_seek() returns
an FCL_EMISSEDRECORD error. If not, vxfs_fcl_seek then sets the current file
position to the offset contained in the cookie. Further calls to vxfs_fcl_read()
return records from this offset.
Return values
A "0" indicates success; a non-zero indicates an error.
Note: vxfs_fcl_seek() returns FCL_EMISSEDRECORD if the FCL has been reactivated,
that is, the activation time in FCL is different than that passed in the cookie, or
the first valid offset in the FCL file is greater than the offset present in the cookie.
vxfs_fcl_seektime
The vxfs_fcl_seektime function seeks to the first record in the FCL file that has
a timestamp greater than or equal to the specified time.
Parameters
The following is the syntax for the vxfs_fcl_seektime function:
File Change Log
Application programming interface for File Change Log
34