Return to link.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/link.2, revision 1.1

1.1     ! root        1: .TH LINK 2 "12 February 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: link \- make a hard link to a file
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .ft B
        !             8: link(name1, name2)
        !             9: char *name1, *name2;
        !            10: .fi
        !            11: .ft R
        !            12: .SH DESCRIPTION
        !            13: A hard link
        !            14: to
        !            15: .I name1
        !            16: is created;
        !            17: the link has the name
        !            18: .IR name2 .
        !            19: .I Name1
        !            20: must exist.
        !            21: .PP
        !            22: With hard links,
        !            23: both
        !            24: .I name1
        !            25: and
        !            26: .I name2
        !            27: must be in the same file system.
        !            28: Unless the caller is the super-user,
        !            29: .I name1
        !            30: must not be a directory.
        !            31: Both the old and the new
        !            32: .I link
        !            33: share equal access and rights to
        !            34: the underlying object.
        !            35: .SH "RETURN VALUE
        !            36: Upon successful completion, a value of 0 is returned.  Otherwise,
        !            37: a value of \-1 is returned and
        !            38: .I errno
        !            39: is set to indicate the error.
        !            40: .SH "ERRORS
        !            41: .I Link
        !            42: will fail and no link will be created if one or more of the following
        !            43: are true:
        !            44: .TP 15
        !            45: [EPERM]
        !            46: Either pathname contains a byte with the high-order bit set.
        !            47: .TP 15
        !            48: [ENOENT]
        !            49: Either pathname was too long.
        !            50: .TP 15
        !            51: [ENOTDIR]
        !            52: A component of either path prefix is not a directory.
        !            53: .TP 15
        !            54: [ENOENT]
        !            55: A component of either path prefix does not exist.
        !            56: .TP 15
        !            57: [EACCES]
        !            58: A component of either path prefix denies search permission.
        !            59: .TP 15
        !            60: [ENOENT]
        !            61: The file named by \fIname1\fP does not exist.
        !            62: .TP 15
        !            63: [EEXIST]
        !            64: The link named by \fIname2\fP does exist.
        !            65: .TP 15
        !            66: [EPERM]
        !            67: The file named by \fIname1\fP is a directory and the effective
        !            68: user ID is not super-user.
        !            69: .TP 15
        !            70: [EXDEV]
        !            71: The link named by \fIname2\fP and the file named by \fIname1\fP
        !            72: are on different file systems.
        !            73: .TP 15
        !            74: [EACCES]
        !            75: The requested link requires writing in a directory with a mode
        !            76: that denies write permission.
        !            77: .TP 15
        !            78: [EROFS]
        !            79: The requested link requires writing in a directory on a read-only file
        !            80: system.
        !            81: .TP 15
        !            82: [EFAULT]
        !            83: One of the pathnames specified
        !            84: is outside the process's allocated address space.
        !            85: .TP 15
        !            86: [ELOOP]
        !            87: Too many symbolic links were encountered in translating the pathname.
        !            88: .SH "SEE ALSO"
        !            89: symlink(2), unlink(2)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.