[src/trunk]: src/lib/libc/sys Better explain possible EBADF causes.

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

details:   https://anonhg.NetBSD.org/src/rev/511806f4adce
branches:  trunk
changeset: 467417:511806f4adce
user:      hubertf <hubertf%NetBSD.org@localhost>
date:      Wed Mar 24 13:40:51 1999 +0000

description:
Better explain possible EBADF causes.
Patches submitted by Greg A. Woods <woods%planix.com@localhost> in PR lib/7206.

diffstat:

 lib/libc/sys/intro.2  |  12 +++++++++---
 lib/libc/sys/revoke.2 |  21 +++++++++++----------
 2 files changed, 20 insertions(+), 13 deletions(-)

diffs (80 lines):

diff -r 55ccb23c30e8 -r 511806f4adce lib/libc/sys/intro.2
--- a/lib/libc/sys/intro.2      Wed Mar 24 13:19:26 1999 +0000
+++ b/lib/libc/sys/intro.2      Wed Mar 24 13:40:51 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: intro.2,v 1.17 1999/03/22 19:45:05 garbled Exp $
+.\"    $NetBSD: intro.2,v 1.18 1999/03/24 13:40:51 hubertf Exp $
 .\"
 .\" Copyright (c) 1980, 1983, 1986, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -122,8 +122,14 @@
 executable file.
 .It Er 9 EBADF Em "Bad file descriptor" .
 A file descriptor argument was out of range, referred to no open file,
-or a read (write) request was made to a file that was only open for
-writing (reading).
+had been revoked by
+.Xr revoke 2 ,
+or a
+.Xr read 2
+(or
+.Xr write 2 )
+request was made to a file that was
+only open for writing (or reading).
 .sp
 .It Er 10 ECHILD Em "\&No child processes" .
 A
diff -r 55ccb23c30e8 -r 511806f4adce lib/libc/sys/revoke.2
--- a/lib/libc/sys/revoke.2     Wed Mar 24 13:19:26 1999 +0000
+++ b/lib/libc/sys/revoke.2     Wed Mar 24 13:40:51 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: revoke.2,v 1.4 1998/08/29 08:32:41 lukem Exp $
+.\"    $NetBSD: revoke.2,v 1.5 1999/03/24 13:40:51 hubertf Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -36,7 +36,7 @@
 .\"
 .\"     @(#)revoke.2   8.1 (Berkeley) 6/4/93
 .\"
-.Dd June 4, 1993
+.Dd March 22, 1999
 .Dt REVOKE 2
 .Os
 .Sh NAME
@@ -65,11 +65,9 @@
 is called as if all open references to the file had been closed.
 .Pp
 Access to a file may be revoked only by its owner or the super user.
-The
+.Pp
 .Nm revoke
-function is currently supported only for block and character special
-device files.
-It is normally used to prepare a terminal device for a new login session,
+is normally used to prepare a terminal device for a new login session,
 preventing any access by a previous user of the terminal.
 .Sh RETURN VALUES
 A 0 value indicated that the call succeeded.  A \-1 return value
@@ -93,14 +91,17 @@
 .It Bq Er EFAULT
 .Fa path
 points outside the process's allocated address space.
-.It Bq Er EINVAL
-The named file is neither a character special or block
-special file.
 .It Bq Er EPERM
 The caller is neither the owner of the file nor the super user.
 .El
 .Sh SEE ALSO
-.Xr close 2
+.Xr close 2 ,
+.Xr dup 2 ,
+.Xr fcntl 2 ,
+.Xr flock 2 ,
+.Xr fstat 2 ,
+.Xr read 2 ,
+.Xr write 2
 .Sh HISTORY
 The
 .Nm revoke