readlink(2)                                                     readlink(2)


   NAME
         readlink - read the value of a symbolic link

   SYNOPSIS
         #include <unistd.h>

         int readlink(const char *path, void *buf, sizet bufsiz);

   DESCRIPTION
         readlink places the contents of the symbolic link referred to by path
         in the buffer buf, which has size bufsiz.  The contents of the link
         are not null-terminated when returned.

         readlink fails and the buffer remains unchanged if:

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

         EFAULT              path or buf extends outside the allocated address
                             space of the process.

         EINVAL              The named file is not a symbolic link.

         EIO                 An I/O error occurs while reading from or writing
                             to the file system.

         ELOOP               Too many symbolic links are encountered in
                             translating path.

         ENAMETOOLONG        The length of the path argument exceeds
                             {PATHMAX}, or the length of a path component
                             exceeds {NAMEMAX} while POSIXNOTRUNC is in
                             effect.

         ENOENT              The named file does not exist.

         ENOSYS              The file system does not support symbolic links.

   DIAGNOSTICS
         Upon successful completion readlink returns the number of characters
         placed in the buffer; otherwise, it returns -1 and places an error
         code in errno.

   SEE ALSO
         lstat(2), stat(2), symlink(2).








   8/91                                                                 Page 1