[src/trunk]: src/lib/libc/gen Update ERRORS section:

[enami <enami%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/2f553ba24878
branches:  trunk
changeset: 786943:2f553ba24878
user:      enami <enami%NetBSD.org@localhost>
date:      Fri May 24 03:20:18 2013 +0000

description:
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.

diffstat:

 lib/libc/gen/realpath.3 |  37 ++++++++++++++++++++++++++++---------
 1 files changed, 28 insertions(+), 9 deletions(-)

diffs (60 lines):

diff -r 45e1ada87d67 -r 2f553ba24878 lib/libc/gen/realpath.3
--- a/lib/libc/gen/realpath.3   Fri May 24 02:35:28 2013 +0000
+++ b/lib/libc/gen/realpath.3   Fri May 24 03:20:18 2013 +0000
@@ -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 @@
 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