readlink(2)readlink(2)NAMEreadlink() - read the contents of a symbolic link
SYNOPSISDESCRIPTION
The function places the contents of the symbolic link referred to by
path in the buffer buf which has size bufsiz. If the number of bytes
in the symbolic link is less than bufsiz, the contents of the remainder
of buf are unspecified.
In systems conforming to AES standards, the returned string will be
null-terminated if the length of the path name string is less than buf‐
siz. If the length of the path name string is exactly bufsiz, the
string will not be null-terminated when returned. If the length of the
path name string exceeds the function returns and sets to
Note
The kernel tunable parameter can be queried to determine whether a
system conforms to AES standards.
RETURN VALUE
Upon successful completion, returns the count of bytes placed in the
buffer. Otherwise, it returns a value of leaves the buffer unchanged,
and sets to indicate the error.
ERRORS
The function will fail if:
[EACCES] Search permission is denied for a component of
the path prefix.
[EACCES] Read permission is denied for the directory.
[EFAULT] or points outside the process's allocated address
space. Reliable detection of this error is
implementation-dependent.
[EINVAL] The path argument names a file that is not a sym‐
bolic link.
[EIO] An I/O error occurred while reading from the file
system.
[ELOOP] Too many symbolic links were encountered in
resolving path.
[ENAMETOOLONG] The length of path exceeds or a pathname compo‐
nent is longer than In systems conforming to AES
standards, this error will be returned when the
path exceeds the bytes or a pathname component
exceeds the bytes while is in effect.
[ENAMETOOLONG] Pathname resolution of a symbolic link produced
an intermediate result whose length exceeds
[ENOENT] A component of path does not name an existing
file or path is an empty string.
[ENOTDIR] A component of the path prefix is not a direc‐
tory.
[ERANGE] The length of the name string read from the sym‐
bolic link exceeds
AUTHOR
was developed by the University of California, Berkeley.
SEE ALSOstat(2), symlink(2), symlink(4), privileges(5), <unistd.h>.
STANDARDS CONFORMANCEreadlink(2)