test veritas logo


fsckpt_rename(3)

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)


VxFS 8.0 fsckpt_rename(3)