GPFS: Administration and Programming Reference - IRA Home

gpfs_ireadlink() Subroutine
Name
gpfs_ireadlink() - Reads a symbolic link by inode number.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_ireadlink(gpfs_fssnap_handle_t *fssnapHandle,
gpfs_ino_t ino,
char *buffer,
int bufferSize);
Description
The gpfs_ireadlink() subroutine reads a symbolic link by inode number. Like gpfs_iopen(), use the same
fssnapHandle parameter that was used by the inode scan.
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.
ino inode number of the link file to read.
buffer Pointer to buffer for the returned link data.
bufferSize Size of the buffer.
Exit status
If the gpfs_ireadlink() subroutine is successful, it returns the number of bytes read.
If the gpfs_ireadlink() 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_ireadlink() subroutine is not available.
EPERM The caller does not have superuser privileges.
ERANGE The buffer is too small to return the symbolic link.
ESTALE Cached file system information was not valid.
GPFS_E_INVAL_FSSNAPHANDLE
The file system snapshot handle is not valid.
Chapter 9. GPFS programming interfaces 323