readlink(2)               SYSTEM CALLS                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  com-
                         ponent of the path prefix of path.

     EFAULT              path or buf extends  outside  the  allo-
                         cated 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 com-
                         ponent    exceeds    {NAMEMAX}    while
                         POSIXNOTRUNC is in effect.

     ENOENT              The named file does not exist.

     ENOSYS              The file system does  not  support  sym-
                         bolic 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)









                                                                1