Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

readlink(2)							   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-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 ALSO
       stat(2), symlink(2), symlink(4), privileges(5), <unistd.h>.

STANDARDS CONFORMANCE
								   readlink(2)

Vote for polarhome