Home > Veritas Storage Foundation™ File System Manual Pages
FSCKPT_FBMAP (3) |
Library Functions |
int fsckpt_fbmap(void *filehandle, ckptoff_t *off, struct c_extent *cep);
ckptoff_t ce_len; /* extent length */ unsigned int ce_flags; /* extent flags */
where flags are:
When the relckpt argument to the fsckpt_fopen() function is NULL, the fsckpt_fbmap() function returns the extent map of the opened file. This mode is useful for applications to find the holes in sparse files.
When the relckpt argument to the fsckpt_fopen() function is not NULL, fsckpt_fbmap() can determine the extents changed between the current Storage Checkpoint and a relative Storage Checkpoint. The result of such an operation returns the union of all changed blocks between the Storage Checkpoints in question.
The relative Storage Checkpoint must be an existing Storage Checkpoint.
The file offset specified by the argument off and the extent length specified by the ce_len field of the c_extent structure are declared to use the ckptoff_t type. This type is platform specific. It is defined as a 64-bit quantity on all platforms that support file offsets larger than two gigabytes, otherwise, it is defined as a 32-bit quantity.
Applications using this function must be compiled accordingly. Some platforms that can handle large files, however, have compilation options that allow an application to define the file offset as a 32-bit quantity. These applications either cannot use this function, or must ensure that they never operate on a Storage Checkpoint that is large file enabled (that is, has CI_LARGEFILES set).
Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.