GPFS: Administration and Programming Reference - IRA Home

gpfs_iclose() Subroutine
Name
gpfs_iclose() - Closes a file given its inode file handle.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_iclose(gpfs_ifile_t *ifile);
Description
The gpfs_iclose() subroutine closes an open file descriptor created by gpfs_iopen().
For an overview of using gpfs_iclose() in a backup application, see “Using APIs to develop backup
applications” on page 24.
Notes:
1. Compile any program that uses this subroutine with the -lgpfs flag from the following library:
v libgpfs.a for AIX
v libgpfs.so for Linux
Parameters
ifile Pointer to gpfs_ifile_t from gpfs_iopen().
Exit status
If the gpfs_iclose() subroutine is successful, it returns a value of 0.
If the gpfs_iclose() 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
ENOSYS The gpfs_iclose() subroutine is not available.
EPERM The caller does not have superuser privileges.
ESTALE Cached file system information was not valid.
Examples
For an example using gpfs_iclose(), see /usr/lpp/mmfs/samples/util/tsbackup.C.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX, /usr/lpp/mmfs/lib/libgpfs.so for Linux
Chapter 9. GPFS programming interfaces 309