document that the i386* functions have to be compiled with -li386;

from er, Charlie Root;

Fixes PR 3114;
ok tholo@

4 files changed, 32 insertions, 4 deletions

diff --git a/lib/libarch/i386/i386_get_ioperm.2 b/lib/libarch/i386/i386_get_ioperm.2
index 3fffb1b2616..a098daf564b 100644
--- a/lib/libarch/i386/i386_get_ioperm.2
+++ b/lib/libarch/i386/i386_get_ioperm.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: i386_get_ioperm.2,v 1.10 2001/02/11 20:18:09 aaron Exp $
+.\"	$OpenBSD: i386_get_ioperm.2,v 1.11 2003/03/14 10:56:32 jmc Exp $
 .\"	$NetBSD: i386_get_ioperm.2,v 1.3 1996/02/27 22:57:17 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -71,6 +71,14 @@ is set in the bitmap, then an attempt to access I/O port
 results in delivery of a
 .Dv SIGBUS
 signal unless the process's I/O permission level would grant I/O access.
+.Pp
+.Sy Note:
+Code using the
+.Fn i386_get_ioperm
+and
+.Fn i386_set_ioperm
+functions must be compiled using
+.Cm -li386 .
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_get_ioperm
diff --git a/lib/libarch/i386/i386_get_ldt.2 b/lib/libarch/i386/i386_get_ldt.2
index 25b880d9ef0..5cbb61ccdff 100644
--- a/lib/libarch/i386/i386_get_ldt.2
+++ b/lib/libarch/i386/i386_get_ldt.2
@@ -68,6 +68,14 @@ can be either segment_descriptor or gate_descriptor, as defined in
 .Ao Pa i386/segments.h Ac .
 These structures are defined by the architecture
 as disjoint bit-fields, so care must be taken in constructing them.
+.Pp
+.Sy Note:
+Code using the
+.Fn i386_get_ldt
+and
+.Fn i386_set_ldt
+functions must be compiled using
+.Cm -li386 .
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_get_ldt
diff --git a/lib/libarch/i386/i386_iopl.2 b/lib/libarch/i386/i386_iopl.2
index a4a746f1319..5cc3fbaf0da 100644
--- a/lib/libarch/i386/i386_iopl.2
+++ b/lib/libarch/i386/i386_iopl.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: i386_iopl.2,v 1.10 2003/02/25 08:26:38 jmc Exp $
+.\"	$OpenBSD: i386_iopl.2,v 1.11 2003/03/14 10:56:32 jmc Exp $
 .\"	$NetBSD: i386_iopl.2,v 1.3 1996/02/27 22:57:25 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -51,6 +51,12 @@
 sets the i386 I/O privilege level to the value specified by
 .Ar iopl .
 This call is restricted to the superuser.
+.Pp
+.Sy Note:
+Code using the
+.Fn i386_iopl
+function must be compiled using
+.Cm -li386 .
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_iopl
diff --git a/lib/libarch/i386/i386_vm86.2 b/lib/libarch/i386/i386_vm86.2
index 4347d3e2922..82f19d7c998 100644
--- a/lib/libarch/i386/i386_vm86.2
+++ b/lib/libarch/i386/i386_vm86.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: i386_vm86.2,v 1.8 2003/02/25 08:26:38 jmc Exp $
+.\"	$OpenBSD: i386_vm86.2,v 1.9 2003/03/14 10:56:32 jmc Exp $
 .\"	$NetBSD: i386_vm86.2,v 1.1 1996/02/21 00:21:52 jtk Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -78,7 +78,7 @@ bit is set, then the process is
 delivered a signal when an INT instruction is executed.
 .Pp
 Since MS-DOS puts many DOS functions onto interrupt 21, it is handled
-specially:  the
+specially: the
 .Ar k Ns Li th
 bit in the
 .Ar vmcp->int21_byuser
@@ -88,6 +88,12 @@ is requested and the
 .Ar ah
 register is
 .Ar k .
+.Pp
+.Sy Note:
+Code using the
+.Fn i386_vm86
+function must be compiled using
+.Cm -li386 .
 .Sh RETURN VALUES
 This routine does not normally return: 32-bit mode will be restored by
 the delivery of a signal to the process.