gpfs_iclose() subroutine
Closes a file given its inode file handle.
Library
GPFS Library (libgpfs.a for AIX®, libgpfs.so for Linux®)
Synopsis
#include <gpfs.h>
void 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.
Note: Compile any program that uses this subroutine with the -lgpfs flag
from the following library:
- libgpfs.a for AIX
- libgpfs.so for Linux
Parameters
- ifile
- Pointer to gpfs_ifile_t from gpfs_iopen().
Exit status
The gpfs_iclose() subroutine returns void.
Exceptions
None.
Error status
Error codes include but are not limited to the following:
- 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/tsreaddir.c.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX
/usr/lpp/mmfs/lib/libgpfs.so for Linux