GPFS: Administration and Programming Reference - IRA Home

gpfs_get_fsname_from_fssnaphandle() Subroutine
Name
gpfs_get_fsname_from_fssnaphandle() - Obtains the file system’s name from a GPFS file system
snapshot handle.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
const char *gpfs_get_fsname_from_fssnaphandle
(gpfs_fssnap_handle_t *fssnapHandle);
Description
The gpfs_get_fsname_from_fssnaphandle() subroutine returns a pointer to the name of file system that
is uniquely identified by the file system snapshot handle.
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
fssnapHandle File system snapshot handle.
Exit status
If the gpfs_get_fsname_from_fssnaphandle() subroutine is successful, it returns a pointer to the name
of the file system identified by the file system snapshot handle.
If the gpfs_get_fsname_from_fssnaphandle() subroutine is unsuccessful, it returns NULL and sets the
global error variable errno to indicate the nature of the error.
Exceptions
None.
Error status
ENOSYS The gpfs_get_fsname_from_fssnaphandle() subroutine is not available.
EPERM The caller does not have superuser privileges.
GPFS_E_INVAL_FSSNAPHANDLE
The file system snapshot handle is not valid.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX, /usr/lpp/mmfs/lib/libgpfs.so for Linux
294 GPFS: Administration and Programming Reference