NAME

       rfio_readlink - get the content of a symbolic link

SYNOPSIS

       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_readlink (const char *path, char *buf, int length)

DESCRIPTION

       rfio_readlink gets the content of the symbolic link identified by path.

       buf content is not null terminated.
       Symbolic link content can be truncated to length if buf is too small.

RETURN VALUE

       This  routine  returns the count of bytes placed in buf if the operation was successful or
       -1 if the operation failed.  In the latter case, serrno is set appropriately.

ERRORS

       ENOENT       path does not exist.

       ENOMEM       Insufficient memory.

       EACCES       Search permission is denied on a component of the path prefix.

       EFAULT       path or buf is a NULL pointer.

       ENOTDIR      A component of the path prefix is not a directory.

       EINVAL       path is not a symbolic link or length is not positive.

       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length of  a  path  component
                    exceeds CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       SEOPNOTSUP   Not supported on Windows.

SEE ALSO

       Castor_limits(4), rfio_symlink(3), rfio_unlink(3)

AUTHOR

       LCG Grid Deployment Team