test veritas logo


fsckpt_remove(3)

NAME

fsckpt_remove - remove a Storage Checkpoint from a file system handle

SYNOPSIS

#include <fsckpt.h>

int fsckpt_remove(void *fshandle, char *ckptname, int flags);

AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_remove() removes a Storage Checkpoint previously created by the fsckpt_create() operation. The name supplied by ckptname must exist and cannot currently be used by other applications. The following flag is defined:
CC_SYNC Removes the Storage Checkpoint synchronously. The calling function is blocked until all of the checkpoint’s files and the Storage Checkpoint itself are removed.
The Storage Checkpoint remove operation is asynchronous by default.

RETURN VALUES

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

ERRORS

EACCES The user does not have permission to perform the operation. Only privileged users can create Storage Checkpoints.
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.
ENOSYS The system does not have a valid license to perform the operation.
EROFS The file system is mounted as read-only; no updates are allowed on the file system and the Storage Checkpoint cannot be removed.

SEE ALSO

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


VxFS 7.4.1 fsckpt_remove(3)