|
|
|
|
|
fsckpt_fopen - open a Storage Checkpoint file
int fsckpt_fopen(void *fshandle, char *relckpt, char *filename, void **filehandle);
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.
fsckpt_fopen() returns zero on success, non-zero on failure.
The file name specified by filename does not exist, or is read-only and user does not have permission to perform the operation.
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.
An I/O error occurred on the device. The Storage Checkpoint could not be loaded.
The relative Storage Checkpoint relckpt does not exist.
Memory could not be allocated to support the API.
The file system is mounted as read-only; no updates are allowed on the file system and the Storage Checkpoint cannot be modified.
There is no existing license for the checkpoint feature. This error is returned when the user attempts to obtain a handle with fsckpt_fsopen().
fsckptadm(1M), fsckpt_create(3), fsckpt_createall(3), fsckpt_fsopen(3), fsckpt_intro(3)