GPFS: Administration and Programming Reference - IRA Home

gpfs_get_snapdirname() Subroutine
Name
gpfs_get_snapdirname() – Obtains the name of the directory containing snapshots.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_get_snapdirname(gpfs_fssnap_handle_t *fssnapHandle,
char *snapdirName, int bufLen);
Description
The gpfs_get_snapdirname() subroutine obtains the name of the directory that is used to contain
snapshots.
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.
snapdirName Buffer into which the name of the snapshot directory will be copied.
bufLen The size of the provided buffer.
Exit status
If the gpfs_get_snapdirname() subroutine is successful, it returns a value of 0 and the snapdirName and
bufLen parameters are set as described above.
If the gpfs_get_snapdirname() subroutine is unsuccessful, it returns a value of -1 and the global error
variable errno is set to indicate the nature of the error.
Exceptions
None.
Error status
ENOMEM Unable to allocate memory for this request.
ENOSYS The gpfs_get_snapdirname() subroutine is not available.
EPERM The caller does not have superuser privileges.
ERANGE The buffer is too small to return the snapshot directory name.
ESTALE The cached file system information was not valid.
GPFS_E_INVAL_FSSNAPHANDLE
The file system snapshot handle is not valid.
302 GPFS: Administration and Programming Reference