update the error return codes to reflect those in 4.3BSD
[unix-history] / usr / src / lib / libc / sys / link.2
index 9763a4f..eb5945c 100644 (file)
@@ -2,7 +2,7 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)link.2      6.1 (Berkeley) %G%
+.\"    @(#)link.2      6.2 (Berkeley) %G%
 .\"
 .TH LINK 2 ""
 .UC 4
 .\"
 .TH LINK 2 ""
 .UC 4
@@ -48,21 +48,29 @@ is set to indicate the error.
 will fail and no link will be created if one or more of the following
 are true:
 .TP 15
 will fail and no link will be created if one or more of the following
 are true:
 .TP 15
-[EPERM]
-Either pathname contains a byte with the high-order bit set.
-.TP 15
-[ENOENT]
-Either pathname was too long.
-.TP 15
 [ENOTDIR]
 A component of either path prefix is not a directory.
 .TP 15
 [ENOTDIR]
 A component of either path prefix is not a directory.
 .TP 15
+[EINVAL]
+Either pathname contains a character with the high-order bit set.
+.TP 15
+[ENAMETOOLONG]
+A component of either pathname exceeded 255 characters,
+or entire length of either path name exceeded 1023 characters.
+.TP 15
 [ENOENT]
 A component of either path prefix does not exist.
 .TP 15
 [EACCES]
 A component of either path prefix denies search permission.
 .TP 15
 [ENOENT]
 A component of either path prefix does not exist.
 .TP 15
 [EACCES]
 A component of either path prefix denies search permission.
 .TP 15
+[EACCES]
+The requested link requires writing in a directory with a mode
+that denies write permission.
+.TP 15
+[ELOOP]
+Too many symbolic links were encountered in translating one of the pathnames.
+.TP 15
 [ENOENT]
 The file named by \fIname1\fP does not exist.
 .TP 15
 [ENOENT]
 The file named by \fIname1\fP does not exist.
 .TP 15
@@ -77,9 +85,8 @@ user ID is not super-user.
 The link named by \fIname2\fP and the file named by \fIname1\fP
 are on different file systems.
 .TP 15
 The link named by \fIname2\fP and the file named by \fIname1\fP
 are on different file systems.
 .TP 15
-[EACCES]
-The requested link requires writing in a directory with a mode
-that denies write permission.
+[EIO]
+An I/O error occurred while making the directory entry.
 .TP 15
 [EROFS]
 The requested link requires writing in a directory on a read-only file
 .TP 15
 [EROFS]
 The requested link requires writing in a directory on a read-only file
@@ -88,8 +95,5 @@ system.
 [EFAULT]
 One of the pathnames specified
 is outside the process's allocated address space.
 [EFAULT]
 One of the pathnames specified
 is outside the process's allocated address space.
-.TP 15
-[ELOOP]
-Too many symbolic links were encountered in translating the pathname.
 .SH "SEE ALSO"
 symlink(2), unlink(2)
 .SH "SEE ALSO"
 symlink(2), unlink(2)