Return to symlink.2 CVS log

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

Annotation of cci/usr/src/man/man2/symlink.2, revision 1.1.1.1

1.1       root        1: .TH SYMLINK 2 "27 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: symlink \- make symbolic link to a file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: symlink(name1, name2)
                      9: char *name1, *name2;
                     10: .fi
                     11: .ft R
                     12: .SH DESCRIPTION
                     13: A symbolic link
                     14: .I name2
                     15: is created to
                     16: .IR name1
                     17: (\fIname2\fP is the name of the
                     18: file created, \fIname1\fP is the string
                     19: used in creating the symbolic link).
                     20: Either name may be an arbitrary path name; the files need not
                     21: be on the same file system.
                     22: .SH "RETURN VALUE
                     23: Upon successful completion, a zero value is returned.
                     24: If an error occurs, the error code is stored in \fIerrno\fP
                     25: and a \-1 value is returned.
                     26: .SH "ERRORS
                     27: The symbolic link is made unless on or more of the
                     28: following are true:
                     29: .TP 15
                     30: [EPERM]
                     31: Either
                     32: .I name1
                     33: or
                     34: .I name2
                     35: contains a character with the high-order bit set.
                     36: .TP 15
                     37: [ENOENT]
                     38: One of the pathnames specified was too long.
                     39: .TP 15
                     40: [ENOTDIR]
                     41: A component of the \fIname2\fP prefix is not a directory.
                     42: .TP 15
                     43: [EEXIST]
                     44: \fIName2\fP already exists.
                     45: .TP 15
                     46: [EACCES]
                     47: A component of the \fIname2\fP path prefix denies search permission.
                     48: .TP 15
                     49: [EROFS]
                     50: The file \fIname2\fP would reside on a read-only file system.
                     51: .TP 15
                     52: [EFAULT]
                     53: .I Name1
                     54: or
                     55: .I name2
                     56: points outside the process's allocated address space.
                     57: .TP 15
                     58: [ELOOP]
                     59: Too may symbolic links were encountered in translating the pathname.
                     60: .SH "SEE ALSO"
                     61: link(2), ln(1), unlink(2)

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