Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation   
Manual: Library Functions (3)   

fsckpt_fopen

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.

SEE ALSO

fsckptadm (1M), fsckpt_create (3), fsckpt_createall (3), fsckpt_fsopen (3), fsckpt_intro (3)
 ^ Return to Top Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation  
Manual: Library Functions (3)  
VERITAS Software Corporation
www.veritas.com