|SYMLINK(2)||Linux Programmer's Manual||SYMLINK(2)|
NAME¶symlink - 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
DESCRIPTION¶symlink() creates a symbolic link named newpath which contains the string oldpath.
RETURN VALUE¶On 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).)
- 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 TO¶SVr4, 4.3BSD, POSIX.1-2001.
NOTES¶No checking of oldpath is done.
SEE ALSO¶ln(1), lchown(2), link(2), lstat(2), open(2), readlink(2), rename(2), symlinkat(2), unlink(2), path_resolution(7), symlink(7)
COLOPHON¶This page is part of release 3.44 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/.