[src/trunk]: src/lib/libc/sys Add readlinkat(2) specific errors.

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

details:   https://anonhg.NetBSD.org/src/rev/08b6cda9823b
branches:  trunk
changeset: 788921:08b6cda9823b
user:      njoly <njoly%NetBSD.org@localhost>
date:      Sun Jul 28 21:24:12 2013 +0000

description:
Add readlinkat(2) specific errors.

diffstat:

 lib/libc/sys/readlink.2 |  22 +++++++++++++++++++++-
 1 files changed, 21 insertions(+), 1 deletions(-)

diffs (43 lines):

diff -r a399d505d2c6 -r 08b6cda9823b lib/libc/sys/readlink.2
--- a/lib/libc/sys/readlink.2   Sun Jul 28 20:25:34 2013 +0000
+++ b/lib/libc/sys/readlink.2   Sun Jul 28 21:24:12 2013 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: readlink.2,v 1.30 2013/01/13 08:15:02 dholland Exp $
+.\"    $NetBSD: readlink.2,v 1.31 2013/07/28 21:24:12 njoly Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -107,6 +107,8 @@
 .Ed
 .Sh ERRORS
 .Fn readlink
+and
+.Fn readlinkat
 will fail if:
 .Bl -tag -width Er
 .It Bq Er EACCES
@@ -131,6 +133,24 @@
 .It Bq Er ENOTDIR
 A component of the path prefix is not a directory.
 .El
+.Pp
+In addition,
+.Fn readlinkat
+will fail if:
+.Bl -tag -width Er
+.It Bq Er EBADF
+.Fa path
+does not specify an absolute path and
+.Fa fd
+is neither
+.Dv AT_FDCWD
+nor a valid file descriptor open for reading or searching.
+.It Bq Er ENOTDIR
+.Fa path
+is not an absolute path and
+.Fa fd
+is a file descriptor associated with a non-directory file.
+.El
 .Sh SEE ALSO
 .Xr lstat 2 ,
 .Xr stat 2 ,