From ben@scientia.demon.co.uk  Thu Jun  1 07:21:59 2000
Return-Path: <ben@scientia.demon.co.uk>
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP id 3C5E237B9DB
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  1 Jun 2000 07:21:55 -0700 (PDT)
	(envelope-from ben@scientia.demon.co.uk)
Received: from magnesium.scientia.demon.co.uk ([192.168.91.34] ident=exim)
	by scientia.demon.co.uk with esmtp (Exim 3.12 #1)
	id 12xUcn-0003u9-00 for FreeBSD-gnats-submit@freebsd.org;
	Thu, 01 Jun 2000 14:03:01 +0100
Received: (from ben) by magnesium.scientia.demon.co.uk (Exim 3.12 #1)
	id 12xUcm-000KYY-00 for FreeBSD-gnats-submit@freebsd.org;
	Thu, 01 Jun 2000 14:03:00 +0100
Message-Id: <E12xUcm-000KYY-00@magnesium.scientia.demon.co.uk>
Date: Thu, 01 Jun 2000 14:03:00 +0100
From: Ben Smithurst <ben@scientia.demon.co.uk>
Reply-To: ben@scientia.demon.co.uk
To: FreeBSD-gnats-submit@freebsd.org
Subject: kernel options required but not mentioned in some manpages
X-Send-Pr-Version: 3.2

>Number:         18943
>Category:       docs
>Synopsis:       kernel options required but not mentioned in some manpages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    alex
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 01 07:30:00 PDT 2000
>Closed-Date:    Mon Jun 19 12:11:48 PDT 2000
>Last-Modified:  Mon Jun 19 12:12:09 PDT 2000
>Originator:     Ben Smithurst
>Release:        FreeBSD 3.4-STABLE i386
>Organization:
>Environment:

>Description:

The i386_{get,set}_{ioperm,ldt} and i386_vm86 functions require various
options to be present in the running kernel before they can be used, but
the manual pages doesn't state this.  I think they should.  (I haven't
actually tested the functions with and without the options present, I'm
just trusting the source code to be right, and me not to have mis-read
it.)

>How-To-Repeat:

>Fix:

There may be a better way to specify kernel options and so on...

Index: i386_get_ioperm.2
===================================================================
RCS file: /usr/cvs/src/lib/libc/i386/sys/i386_get_ioperm.2,v
retrieving revision 1.5
diff -u -r1.5 i386_get_ioperm.2
--- i386_get_ioperm.2	2000/05/06 12:07:48	1.5
+++ i386_get_ioperm.2	2000/06/01 12:48:36
@@ -56,6 +56,10 @@
 arguments to the state specified by the
 .Fa enable
 argument.
+.Pp
+Note that you must have
+.Dq options VM86
+in your kernel configuration file to use these functions.
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_get_ioperm
Index: i386_get_ldt.2
===================================================================
RCS file: /usr/cvs/src/lib/libc/i386/sys/i386_get_ldt.2,v
retrieving revision 1.8
diff -u -r1.8 i386_get_ldt.2
--- i386_get_ldt.2	2000/05/06 12:07:48	1.8
+++ i386_get_ldt.2	2000/06/01 12:48:25
@@ -69,6 +69,10 @@
 .Fd <i386/segments.h> .
 These structures are defined by the architecture
 as disjoint bit-fields, so care must be taken in constructing them.
+.Pp
+Note that you must have
+.Dq options USER_LDT
+in your kernel configuration file to use these functions.
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_get_ldt
Index: i386_vm86.2
===================================================================
RCS file: /usr/cvs/src/lib/libc/i386/sys/i386_vm86.2,v
retrieving revision 1.5
diff -u -r1.5 i386_vm86.2
--- i386_vm86.2	2000/05/06 12:07:48	1.5
+++ i386_vm86.2	2000/06/01 12:55:44
@@ -77,6 +77,10 @@
 with the correct machine context for vm86, and with the
 .Em PSL_VM
 bit set.  Control returns to the process upon delivery of a signal.
+.Pp
+Note that you must have
+.Dq options VM86
+in your kernel configuration file to use this function.
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_vm86

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->alex 
Responsible-Changed-By: alex 
Responsible-Changed-When: Mon Jun 12 09:50:01 PDT 2000 
Responsible-Changed-Why:  
Mine! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18943 
State-Changed-From-To: open->closed  
State-Changed-By: alex 
State-Changed-When: Mon Jun 19 12:11:48 PDT 2000 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18943 
>Unformatted:
