Symantec logo

fsckpt_remove

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)