Home > Veritas Storage Foundation™ File System Manual Pages

FSCKPT_REMOVE (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

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.