Date: Thu, 01 Jun 2000 14:03:00 +0100 From: Ben Smithurst <ben@scientia.demon.co.uk> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/18943: kernel options required but not mentioned in some manpages Message-ID: <E12xUcm-000KYY-00@magnesium.scientia.demon.co.uk>
next in thread | raw e-mail | index | archive | help
>Number: 18943
>Category: docs
>Synopsis: kernel options required but not mentioned in some manpages
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Jun 01 07:30:00 PDT 2000
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?E12xUcm-000KYY-00>