Return to symlink.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/symlink.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)symlink.2   6.3 (Berkeley) 8/26/85
                      6: .\"
                      7: .TH SYMLINK 2 "August 26, 1985"
                      8: .UC 5
                      9: .SH NAME
                     10: symlink \- make symbolic link to a file
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: symlink(name1, name2)
                     15: char *name1, *name2;
                     16: .fi
                     17: .ft R
                     18: .SH DESCRIPTION
                     19: A symbolic link
                     20: .I name2
                     21: is created to
                     22: .IR name1
                     23: (\fIname2\fP is the name of the
                     24: file created, \fIname1\fP is the string
                     25: used in creating the symbolic link).
                     26: Either name may be an arbitrary path name; the files need not
                     27: be on the same file system.
                     28: .SH "RETURN VALUE
                     29: Upon successful completion, a zero value is returned.
                     30: If an error occurs, the error code is stored in \fIerrno\fP
                     31: and a \-1 value is returned.
                     32: .SH "ERRORS
                     33: The symbolic link is made unless on or more of the
                     34: following are true:
                     35: .TP 15
                     36: [ENOTDIR]
                     37: A component of the \fIname2\fP prefix is not a directory.
                     38: .TP 15
                     39: [EINVAL]
                     40: Either \fIname1\fP or \fIname2\fP
                     41: contains a character with the high-order bit set.
                     42: .TP 15
                     43: [ENAMETOOLONG]
                     44: A component of either pathname exceeded 255 characters,
                     45: or the entire length of either path name exceeded 1023 characters.
                     46: .TP 15
                     47: [ENOENT]
                     48: The named file does not exist.
                     49: .TP 15
                     50: [EACCES]
                     51: A component of the \fIname2\fP path prefix denies search permission.
                     52: .TP 15
                     53: [ELOOP]
                     54: Too many symbolic links were encountered in translating the pathname.
                     55: .TP 15
                     56: [EEXIST]
                     57: \fIName2\fP already exists.
                     58: .TP 15
                     59: [EIO]
                     60: An I/O error occurred while making the directory entry for \fIname2\fP,
                     61: or allocating the inode for \fIname2\fP,
                     62: or writing out the link contents of \fIname2\fP.
                     63: .TP 15
                     64: [EROFS]
                     65: The file \fIname2\fP would reside on a read-only file system.
                     66: .TP 15
                     67: [ENOSPC]
                     68: The directory in which the entry for the new symbolic link is being placed
                     69: cannot be extended because there is no space left on the file
                     70: system containing the directory.
                     71: .TP 15
                     72: [ENOSPC]
                     73: The new symbolic link cannot be created because there
                     74: there is no space left on the file
                     75: system that will contain the symbolic link.
                     76: .TP 15
                     77: [ENOSPC]
                     78: There are no free inodes on the file system on which the
                     79: symbolic link is being created.
                     80: .TP 15
                     81: [EDQUOT]
                     82: The directory in which the entry for the new symbolic link
                     83: is being placed cannot be extended because the
                     84: user's quota of disk blocks on the file system
                     85: containing the directory has been exhausted.
                     86: .TP 15
                     87: [EDQUOT]
                     88: The new symbolic link cannot be created because the user's
                     89: quota of disk blocks on the file system that will
                     90: contain the symbolic link has been exhausted.
                     91: .TP 15
                     92: [EDQUOT]
                     93: The user's quota of inodes on the file system on
                     94: which the symbolic link is being created has been exhausted.
                     95: .TP 15
                     96: [EIO]
                     97: An I/O error occurred while making the directory entry or allocating the inode.
                     98: .TP 15
                     99: [EFAULT]
                    100: .I Name1
                    101: or
                    102: .I name2
                    103: points outside the process's allocated address space.
                    104: .SH "SEE ALSO"
                    105: 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.