Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation   
Manual: Library Functions (3)   

fsckpt_finfo

NAME

fsckpt_finfo - return status information from a Storage Checkpointed file

SYNOPSIS


#include <fsckpt.h>
int fsckpt_finfo(void *filehandle, struct c_finfo *cfp);

AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_finfo() returns status information specific to a file handle in a Storage Checkpoint. The information returned is used to determine the type of activity in the file system (and file) and can be useful to better tune the application and file system.

The structure c_finfo pointed to by cfp contains the following fields:


unsigned    int cf_flags;      /* misc. flags */
unsigned    int cf_nblocks;    /* number of blocks allocated */

where flags are:

CF_DEPENDENT

Indicates that the Storage Checkpointed file has dependencies on other Storage Checkpointed files or the primary file in order to establish its full image.

A CF_DEPENDENT file also indicates that this file has a map of the blocks changed which does not include every block in the file.

All fields containing the number of blocks are given as 1K blocks.

RETURN VALUES

fsckpt_finfo() returns zero on success, non-zero on failure.

ERRORS

EINVAL

The function is being used incorrectly, or the arguments to the function could not be validated. This may occur when an application tries to use an fshandle that was not created by the same process.

EIO

An I/O error occurred while retrieving the information from disk.

SEE ALSO

fsckptadm (1M), fsckpt_create (3), fsckpt_createall (3), fsckpt_fsopen (3), fsckpt_intro (3)
 ^ Return to Top Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation  
Manual: Library Functions (3)  
VERITAS Software Corporation
www.veritas.com