Symantec logo

fsckpt_rename

NAME

fsckpt_rename - rename a Storage Checkpoint from a file system handle

SYNOPSIS

#include <fsckpt.h>

int fsckpt_rename(void *fshandle, char *oldckptname, char *newckptname);

AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_rename() renames any Storage Checkpoint. The name supplied by newckptname cannot currently exist.

RETURN VALUES

fsckpt_rename() 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.

EEXIST

The Storage Checkpoint name newckptname already exists in the file system Storage Checkpoint name space.

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 renamed.

ENOENT

The specified Storage Checkpoint oldckptname 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 renamed.

SEE ALSO

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