READLINK(2)         RISC/os Reference Manual          READLINK(2)



NAME
     readlink - read value of a symbolic link

SYNOPSIS
     For -systype sysv and -systype bsd43:

     cc = readlink(path, buf, bufsiz)
     int cc;
     char *path, *buf;
     int bufsiz;

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

RETURN VALUE
     The call returns the count of characters placed in the
     buffer if it succeeds, or a -1 if an error occurs, placing
     the error code in the global variable errno.

ERRORS
     readlink will fail and the file mode will be unchanged if:

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

     [EINVAL]            The pathname contains a character with
                         the high-order bit set.

     [ENAMETOOLONG]      A component of a pathname exceeded 255
                         characters, or an entire path name
                         exceeded 1023 characters.

     [ENOENT]            The named file does not exist.

     [EACCES]            Search permission is denied for a com-
                         ponent of the path prefix.

     [ELOOP]             Too many symbolic links were encountered
                         in translating the pathname.

     [EINVAL]            The named file is not a symbolic link.

     [EIO]               An I/O error occurred while reading from
                         the file system.

     [EFAULT]            buf extends outside the process's allo-
                         cated address space.

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



                         Printed 1/15/91                   Page 1

READLINK(2)         RISC/os Reference Manual          READLINK(2)



NOTE
     When these routines are used in a program which is compiled
     in -systype sysv, they are not resolved by libc.a.  See
     intro(3-SysV) for more information.



















































 Page 2                  Printed 1/15/91