RTEMS 4.6.1 On-Line Library

Files and Directories Manager readlink - Obtain the name of a symbolic link destination

RTEMS POSIX API User's Guide

#include <unistd.h>

int readlink(
  const char *path,
  char       *buf,
  size_t      bufsize
);

EACCES: Search permission is denied for a directory in a file's path prefix
ENAMETOOLONG: Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is in effect.
ENOENT: A file or directory does not exist.
ENOTDIR: A component of the prefix pathname was not a directory when a directory was expected.
ELOOP: Too many symbolic links were encountered in the pathname.
EINVAL: The pathname does not refer to a symbolic link
EFAULT: An invalid pointer was passed into the readlink() routine.

The readlink() function places the symbolic link destination into buf argument and returns the number of characters copied.

If the symbolic link destination is longer than bufsize characters the name will be truncated.

NONE

RTEMS POSIX API User's Guide