Module Name: src
Committed By: enami
Date: Fri May 24 03:20:18 UTC 2013
Modified Files:
src/lib/libc/gen: realpath.3
Log Message:
Update ERRORS section:
- Remove some system calls from the list of functions which may set errno
during the execution of realpath(3) since they are no longer used
to implement it.
- Document some errno set by the realpath(3) itself.
To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/lib/libc/gen/realpath.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/gen/realpath.3
diff -u src/lib/libc/gen/realpath.3:1.16 src/lib/libc/gen/realpath.3:1.17
--- src/lib/libc/gen/realpath.3:1.16 Tue Mar 5 03:11:27 2013
+++ src/lib/libc/gen/realpath.3 Fri May 24 03:20:18 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: realpath.3,v 1.16 2013/03/05 03:11:27 enami Exp $
+.\" $NetBSD: realpath.3,v 1.17 2013/05/24 03:20:18 enami Exp $
.\"
.\" Copyright (c) 1994
.\" The Regents of the University of California. All rights reserved.
@@ -32,7 +32,7 @@
.\"
.\" from: @(#)realpath.3 8.2 (Berkeley) 2/16/94
.\"
-.Dd June 21, 2012
+.Dd May 24, 2013
.Dt REALPATH 3
.Os
.Sh NAME
@@ -100,15 +100,34 @@ The function
may fail and set the external variable
.Va errno
for any of the errors specified for the library functions
-.Xr chdir 2 ,
-.Xr close 2 ,
-.Xr fchdir 2 ,
+.\" First sorted by section, then by name.
.Xr lstat 2 ,
-.Xr malloc 3 ,
-.Xr open 2 ,
-.Xr readlink 2
+.Xr readlink 2 ,
+.Xr getcwd 3
and
-.Xr getcwd 3 .
+.Xr malloc 3 .
+.Pp
+In addition, the following errors may be reported:
+.Bl -tag -width Er
+.It Bq Er EINVAL
+The value of the
+.Fa pathname
+argument is
+.Dv NULL .
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the
+.Fa pathname .
+.It Bq Er ENAMETOOLONG
+The resulting absolute pathname exceeds MAXPATHLEN characters.
+.It Bq Er ENOENT
+The value of the
+.Fa pathname
+argument is an empty string.
+.It Bq Er ENOENT
+A symbolic link to an empty string is encountered.
+.It Bq Er ENOTDIR
+A component of the path prefix is not a directory.
+.El
.Sh SEE ALSO
.Xr getcwd 3
.Sh STANDARDS
