Home > Veritas Storage Foundation™ File System Manual Pages

FSCKPT_RENAME (3)

Library Functions

Table of contents


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 a Storage Checkpoint previously created by the fsckpt_create() operation. 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)

Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.