Home > Veritas Storage Foundation™ File System Manual Pages
FSCKPT_INFO (3) |
|
Library Functions |
Table of contents
fsckpt_info - return status information on a Storage Checkpoint
#include <fsckpt.h>
int fsckpt_info(void *fshandle, char *ckptname, int ckptindex struct c_info *cip);
VRTSvxfs
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.
fsckpt_finfo()
returns zero on success, non-zero on failure.
-
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.
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.