gpfs_clone_unsnap() subroutine
Changes a clone parent with no file clones back to a regular file.
Library
GPFS Library (libgpfs.a for AIX®, libgpfs.so for Linux®)
Synopsis
#include <gpfs.h>
int gpfs_clone_unsnap(gpfs_file_t fileDesc);Description
The gpfs_clone_unsnap() subroutine changes a clone parent with no file clones back to a regular file.
Parameters
- fileDesc
- File descriptor for the clone parent to convert back to a regular file.
Exit status
If the gpfs_clone_unsnap() subroutine is successful, it returns a value of 0.
If the gpfs_clone_unsnap() subroutine is unsuccessful, it returns a value of -1 and sets the global error variable errno to indicate the nature of the error.
Exceptions
None.
Error status
Error codes include but are not limited to the following:
- EACCESS
- Permission denied when writing to the target file.
- EBADF
- The file descriptor is not valid or is not a GPFS file.
- EINVAL
- An argument to the function was not valid.
- ENOSYS
- The gpfs_clone_unsnap() subroutine is not available.
- EPERM
- The file descriptor does not refer to a regular file or a clone parent.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX
/usr/lpp/mmfs/lib/libgpfs.so for Linux