From owner-freebsd-doc Thu Jun 1 7:30: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id E774637BA2F for ; Thu, 1 Jun 2000 07:30:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA81689; Thu, 1 Jun 2000 07:30:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13]) by hub.freebsd.org (Postfix) with ESMTP id 3C5E237B9DB for ; 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: Date: Thu, 01 Jun 2000 14:03:00 +0100 From: Ben Smithurst Reply-To: ben@scientia.demon.co.uk To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18943: kernel options required but not mentioned in some manpages Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >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 . 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