|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Calls link(2)
NAME
link - link to a file
SYNOPSIS
#include <unistd.h>
int link(const char *existing, const char *new);
DESCRIPTION
The link() function creates a new link (directory entry) for
the existing file and increments its link count by one. The
existing argument points to a path name naming an existing
file. The new argument points to a pathname naming the new
directory entry to be created.
To create hard links, both files must be on the same file
system. Both the old and the new link share equal access and
rights to the underlying object. Privileged processes can
make multiple links to a directory. Unless the caller is
privileged, the file named by existing must not be a direc-
tory.
Upon successful completion, link() marks for update the
st_ctime field of the file. Also, the st_ctime and st_mtime
fields of the directory that contains the new entry are
marked for update.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is
returned, no link is created, and errno is set to indicate
the error.
ERRORS
The link() function will fail if:
EACCES A component of either path prefix denies
search permission, or the requested link
requires writing in a directory with a mode
that denies write permission.
EDQUOT The directory where the entry for the new
link is being placed cannot be extended
because the user's quota of disk blocks on
that file system has been exhausted.
EEXIST The link named by new exists.
SunOS 5.10 Last change: 20 Jan 2003 1
System Calls link(2)
EFAULT The existing or new argument points to an
illegal address.
EINTR A signal was caught during the execution of
the link() function.
ELOOP Too many symbolic links were encountered in
translating path.
EMLINK The maximum number of links to a file would
be exceeded.
ENAMETOOLONG The length of the existing or new argument
exceeds PATH_MAX, or the length of a exist-
ing or new component exceeds NAME_MAX while
_POSIX_NO_TRUNC is in effect.
ENOENT The existing or new argument is a null path-
name; a component of either path prefix does
not exist; or the file named by existing
does not exist.
ENOLINK The existing or new argument points to a
remote machine and the link to that machine
is no longer active.
ENOSPC The directory that would contain the link
cannot be extended.
ENOTDIR A component of either path prefix is not a
directory.
EPERM The file named by existing is a directory
and the {PRIV_SYS_LINKDIR} privilege is not
SunOS 5.10 Last change: 20 Jan 2003 2
System Calls link(2)
asserted in the effective set of the calling
process.
The effective user ID does not match the
owner of the file and the
{PRIV_FILE_LINK_ANY} privilege is not
asserted in the effective set of the calling
process.
EROFS The requested link requires writing in a
directory on a read-only file system.
EXDEV The link named by new and the file named by
existing are on different logical devices
(file systems).
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
| MT-Level | Async-Signal-Safe |
|_____________________________|_____________________________|
SEE ALSO
symlink(2), unlink(2), attributes(5), privileges(5), stan-
dards(5)
SunOS 5.10 Last change: 20 Jan 2003 3
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:27:01 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5323 hits)
(openSUSE 10.2)
svn man page (5185 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4865 hits)
(Solaris 10 11_06)
CPAN man page (4602 hits)
(Suse Linux 10.1)
ssh man page (4337 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2843 hits)
(Solaris 10 11_06)
netcat man page (2691 hits)
(Suse Linux 10.1)
pprosetup man page (2474 hits)
(Solaris 10 11_06)
startproc man page (2457 hits)
(Suse Linux 10.1)
signal man page (2396 hits)
(Suse Linux 10.1)
|
Man Pages 
