Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
symlink(2)
Edit
PageHistory
Diff
Info
LikePages
SYMLINK !!!SYMLINK NAME SYNOPSIS DESCRIPTION RETURN VALUE ERRORS NOTES CONFORMING TO SEE ALSO ---- !!NAME symlink - make a new name for a file !!SYNOPSIS __#include __ __int symlink(const char *__''oldpath''__, const char *__''newpath''__);__ !!DESCRIPTION __symlink__ creates a symbolic link named ''newpath'' which contains the string ''oldpath''. Symbolic links are interpreted at run-time as if the contents of the link had been substituted into the path being followed to find a file or directory. Symbolic links may contain __..__ path components, which (if used at the start of the link) refer to the parent directories of that in which the link resides. A symbolic link (also known as a soft link) may point to an existing file or to a nonexistent one; the latter case is known as a dangling link. The permissions of a symbolic link are irrelevant; the ownership is ignored when following the link, but is checked when removal or renaming of the link is requested and the link is in a directory with the sticky bit set. If ''newpath'' exists it will ''not'' be overwritten. !!RETURN VALUE On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately. !!ERRORS __EPERM__ The filesystem containing ''newpath'' does not support the creation of symbolic links. __EFAULT__ ''oldpath'' or ''newpath'' points outside your accessible address space. __EACCES__ Write access to the directory containing ''newpath'' is not allowed for the process's effective uid, or one of the directories in ''newpath'' did not allow search (execute) permission. __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. __ENOTDIR__ A component used as a directory in ''newpath'' is not, in fact, a directory. __ENOMEM__ Insufficient kernel memory was available. __EROFS__ ''newpath'' is on a read-only filesystem. __EEXIST__ ''newpath'' already exists. __ELOOP__ Too many symbolic links were encountered in resolving ''newpath''. __ENOSPC__ The device containing the file has no room for the new directory entry. __EIO__ An I/O error occurred. !!NOTES No checking of ''oldpath'' is done. Deleting the name referred to by a symlink will actually delete the file (unless it also has other hard links). If this behaviour is not desired, use __link__. !!CONFORMING TO SVr4, SVID, POSIX, BSD 4.3. SVr4 documents additional error codes SVr4, SVID, BSD 4.3, X/OPEN. SVr4 documents additional error codes EDQUOT and ENOSYS. See open(2) re multiple files with the same name, and NFS. !!SEE ALSO readlink(2), link(2), unlink(2), rename(2), open(2), lstat(2), ln(1) ----
5 pages link to
symlink(2)
:
Man2s
syscalls(2)
link(2)
readlink(2)
rename(2)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
