RTEMS Logo

RTEMS 4.9.4 On-Line Library


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

PREV UP NEXT Bookshelf RTEMS POSIX API User's Guide

4.4.14: symlink - Creates a symbolic link to a file

CALLING SEQUENCE:

#include <unistd.h>

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

STATUS CODES:

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.

DESCRIPTION:

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.

NOTES:

NONE


PREV UP NEXT Bookshelf RTEMS POSIX API User's Guide

Copyright © 1988-2008 OAR Corporation