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).)
- EDQUOT
- 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.
- 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.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/.2013-01-27 | Linux |