RTEMS 4.7.2 On-Line Library
Files and Directories Manager readlink - Obtain the name of a symbolic link destination
RTEMS POSIX API User's Guide
4.4.15: readlink - Obtain the name of a symbolic link destination
CALLING SEQUENCE:
-
#include <unistd.h>
int readlink(
const char *path,
char *buf,
size_t bufsize
);
STATUS CODES:
- 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.
DESCRIPTION:
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.
NOTES:
NONE
RTEMS POSIX API User's Guide
Copyright © 1988-2004 OAR Corporation