Subject: Re: CVS commit: sharesrc/share/man/man4/man4.i386
To: None <hubertf@netbsd.org>
From: Klaus Klein <kleink@reziprozitaet.de>
List: source-changes
Date: 07/03/2001 11:34:52
Hubert Feyrer <hubertf@netbsd.org> writes:

> Module Name:	sharesrc
> Committed By:	hubertf
> Date:		Mon Jul  2 22:59:25 UTC 2001
> 
> Modified Files:
> 	sharesrc/share/man/man4/man4.i386: Makefile
> Added Files:
> 	sharesrc/share/man/man4/man4.i386: io.4
> 
> Log Message:
> Add a manpage for /dev/io, and tell people the True Way.
> Most of the manpage is from FreeBSD - thanks guys! :)

I'm a bit disturbed about the following differences between the
implementation and this manual page:

* Unlike FreeBSD, where this `feature' is always available,
  NetBSD requires COMPAT_10 for it.  Not a great difference,
  but the manual ought to cover it.  (In this light the deprecation
  notice is far too weak.)

* Unlike FreeBSD, NetBSD requires a write-enabled file descriptor
  to /dev/io to set IOPL.  Again, not a great functional difference,
  but in this case the manual says explicitly otherwise; any
  objections to removing the read-only access for group kmem completely?

Please make sure when importing such documentation that it actually
describes the NetBSD behaviour.


- Klaus