|SYMLINK(2)||Linux Programmer's Manual||SYMLINK(2)|
NAMEsymlink - make a new name for a file
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
_BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _POSIX_C_SOURCE >= 200112L
DESCRIPTIONsymlink() creates a symbolic link named newpath which contains the string oldpath.
RETURN VALUEOn success, zero is returned. On error, -1 is returned, and errno is set appropriately.
- Write access to the directory containing newpath is denied, or one of the directories in the path prefix of newpath did not allow search permission. (See also path_resolution(7).)
- The user's quota of resources on the file system has been exhausted. The resources could be inodes or disk blocks, depending on the file system implementation.
- newpath already exists.
- oldpath or newpath points outside your accessible address space.
- An I/O error occurred.
- Too many symbolic links were encountered in resolving newpath.
- oldpath or newpath was too long.
- A directory component in newpath does not exist or is a dangling symbolic link, or oldpath is the empty string.
- Insufficient kernel memory was available.
- The device containing the file has no room for the new directory entry.
- A component used as a directory in newpath is not, in fact, a directory.
- The file system containing newpath does not support the creation of symbolic links.
- newpath is on a read-only file system.
CONFORMING TOSVr4, 4.3BSD, POSIX.1-2001.
NOTESNo checking of oldpath is done.
SEE ALSOln(1), lchown(2), link(2), lstat(2), open(2), readlink(2), rename(2), symlinkat(2), unlink(2), path_resolution(7), symlink(7)
COLOPHONThis page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.