table of contents
other versions
- wheezy 3.44-1
- jessie 3.74-1
- jessie-backports 4.10-2~bpo8+1
- testing 4.10-2
- unstable 4.10-2
other sections
SYMLINK(2) | Linux Programmer's Manual | SYMLINK(2) |
NAME¶
symlink - make a new name for a fileSYNOPSIS¶
#include <unistd.h>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.ERRORS¶
- EACCES
- 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).)
- EEXIST
- newpath already exists.
- EFAULT
- oldpath or newpath points outside your accessible address space.
- EIO
- An I/O error occurred.
- ELOOP
- Too many symbolic links were encountered in resolving newpath.
- ENAMETOOLONG
- oldpath or newpath was too long.
- ENOENT
- A directory component in newpath does not exist or is a dangling symbolic link, or oldpath is the empty string.
- ENOMEM
- Insufficient kernel memory was available.
- ENOSPC
- The device containing the file has no room for the new directory entry.
- ENOTDIR
- A component used as a directory in newpath is not, in fact, a directory.
- EPERM
- The file system containing newpath does not support the creation of symbolic links.
- EROFS
- 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/.2010-09-20 | Linux |