READLINK(2) DOMAIN/IX Reference Manual (SYS5) READLINK(2)
NAME
readlink - read value of a soft (or symbolic) link
USAGE
int readlink(path, buf, bufsiz)
char *path, *buf;
int bufsiz;
DESCRIPTION
The readlink call places the contents of the soft (or sym-
bolic) link name in the buffer buf that has size bufsiz.
The contents of the link are not null-terminated when
returned. The readlink call represents an addition to the
set of standard system calls normally available to UNIX sys-
tem customers.
RETURN VALUE
The call returns the count of characters placed in the
buffer if it succeeds. It returns -1 if an error occurs, and
then it places the error code in the global variable errno.
ERRORS
The readlink call fails and the file mode is unchanged under
the following conditions:
[EPERM] The path argument contained a byte with the
high-order bit set.
[ENOENT] The pathname is too long.
[ENOTDIR] A component of the path prefix is not a
directory.
[ENOENT] The named file does not exist.
[ENXIO] The named file is not a soft link.
[EACCES] Search permission is denied on a component of
the path prefix.
[EPERM] The effective user ID does not match the
owner of the file and the effective user ID
is not the super-user.
[EINVAL] The named file is not a soft link.
[EFAULT] The value of buf extends outside the
process's allocated address space.
[ELOOP] Too many soft links were encountered in
translating the pathname.
Printed 1/27/86 READLINK-1
READLINK(2) DOMAIN/IX Reference Manual (SYS5) READLINK(2)
RELATED INFORMATION
stat(2)
lstat(2)
soft_link(2)
soft_unlink(2)
READLINK-2 Printed 1/27/86