hpux man page for readlink

readlink(2)							System Calls Manual						       readlink(2)

NAME
       readlink() - read the contents of a symbolic link

SYNOPSIS
DESCRIPTION
       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-depen-
			     dent.

	      [EINVAL]	     The path argument names a file that is not a symbolic 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 component 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 directory.

	      [ERANGE]	     The length of the name string read from the symbolic link exceeds

AUTHOR
       was developed by the University of California, Berkeley.

SEE ALSO
       stat(2), symlink(2), symlink(4), privileges(5), <unistd.h>.

STANDARDS CONFORMANCE
																       readlink(2)