Home > Veritas Storage Foundation™ File System Manual Pages

FSCKPT_INFO (3)

Library Functions

Table of contents


NAME

fsckpt_info - return status information on a Storage Checkpoint

SYNOPSIS

#include <fsckpt.h>

int fsckpt_info(void *fshandle, char *ckptname, int ckptindex struct c_info *cip);


AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_info() returns status information from a file system handle fshandle associated with the Storage Checkpoint specified by ckptname.

The contents of the structure pointed to by cip includes the following members:


unsigned int     ci_version;   /* API version number */
struct timeval   ci_ctime;     /* ckpt creation time */
struct timeval   ci_mtime;     /* ckpt modification time */
unsigned int     ci_ninodes;   /* number of inodes */
unsigned int     ci_nblocks;   /* number of blocks allocated */
int              ci_flags;     /* miscellaneous flags */
char             ci_name[FSCKPT_.SH NAMESZ];  /* ckpt name */

where flags are:

CI_DELAYED
Used in conjunction with CI_NODATA, the Storage Checkpoint is marked for delayed conversion to nodata.
CI_LARGEFILES
The Storage Checkpoint supports files larger than 2 gigabytes in size. Applications must be largefiles enabled (compiled to handle 64-bit file offsets) to properly access this Storage Checkpoint. Applications which are not large file enabled cannot operate on a CI_LARGEFILES Storage Checkpoint.
CI_MOUNTED
The Storage Checkpoint is mounted.
CI_NODATA
The Storage Checkpoint contains no data.
CI_NOMOUNT
The Storage Checkpoint cannot be mounted.
CI_REMOVABLE
The Storage Checkpoint was created with the CC_REMOVE flag. This means that this Storage Checkpoint could self-destruct on full file systems.
CI_ROOT
The Storage Checkpoint is the root fileset.

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

The ckptindex field is meaningful only when used on the primary file system image. A call with a value other than zero on a Storage Checkpoint name results in a error. When used on the primary image, this field is used to obtain status information on Storage Checkpoints by their creation time with a value of one representing the newest Storage Checkpoint, a value of two the second newest Storage Checkpoint and so forth. If the index value passed to this call is larger than the number of Storage Checkpoints, then an ENOENT error is returned. The ckptindex argument can be used to list all Storage Checkpoints in the file system.


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 on the device. The Storage Checkpoint could not be loaded.
ENOENT
The specified Storage Checkpoint ckptname does not exist.

SEE ALSO

fsckptadm(1M), fsckpt_cntl(3), fsckpt_create(3), fsckpt_createall(3), fsckpt_fsopen(3), fsckpt_intro(3),

Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.