Home > Veritas Storage Foundation™ File System Manual Pages

FSCKPT_FOPEN (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

NAME

fsckpt_fopen - open a Storage Checkpoint file

SYNOPSIS

#include <fsckpt.h>

int fsckpt_fopen(void *fshandle, char *relckpt, char *filename, void **filehandle);

AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_fopen() opens a file specified by filename for use by the Storage Checkpoint API library. fsckpt_fopen() associates the file specified by filehandle and returns the handle to the caller. All arguments are checked before creating a validated file handle. The file handle is then used for all subsequent Storage Checkpoint file operations.

relckpt indicates a relative Storage Checkpoint for the fsckpt_fbmap() function to operate against. See the fsckp_fbmap(3) man page for more information.

RETURN VALUES

fsckpt_fopen() returns zero on success, non-zero on failure.

ERRORS

EACCES: The file name specified by filename does not exist, or is read-only and user does not have permission to perform the operation.
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 relative Storage Checkpoint relckpt does not exist.
ENOMEM: Memory could not be allocated to support the API.
EROFS: The file system is mounted as read-only; no updates are allowed on the file system and the Storage Checkpoint cannot be modified.