RTEMS 4.6.1 On-Line Library

Files and Directories Manager symlink - Creates a symbolic link to a file

RTEMS POSIX API User's Guide

#include <unistd.h>

int symlink(
  const char *topath,
  const char *frompath
);

EACCES: Search permission is denied for a directory in a file's path prefix
EEXIST: The named file already exists.
ENAMETOOLONG: Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is in effect.
ENOENT: A file or directory does not exist.
ENOSPC: No space left on disk.
ENOTDIR: A component of the specified pathname was not a directory when a directory was expected.
EPERM: Operation is not permitted. Process does not have the appropriate priviledges or permissions to perform the requested operations.
EROFS: Read-only file system.

The symlink() function creates a symbolic link from the frombath to the topath. The symbolic link will be interpreted at run-time.

If the symlink() function fails, no directories are modified.

The caller may (or may not) need permission to access the existing file.

NONE

RTEMS POSIX API User's Guide