readlink - read value of a symbolic link

---

SYNOPSIS

int readlink(path, buf, bufsiz)
char *path, *buf;
int 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.

RETURN VALUES

readlink() returns the number of characters placed in the buffer on success. On failure, it returns -1 and sets errno to indicate the error.

ERRORS

readlink() will fail and the buffer will be unchanged if:

EACCES

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

EFAULT

path or buf extends outside the process's allocated address space.

ELOOP

Too many symbolic links were encountered in translating path.

EINVAL

The named file is not a symbolic link.

EIO

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

ENAMETOOLONG

The length of the path argument exceeds {PATH_MAX}.

A pathname component is longer than {NAME_MAX} (see sysconf.2v while {_POSIX_NO_TRUNC} is in effect (see pathconf.2v

ENOENT

The named file does not exist.

SEE ALSO

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97