diff options
| -rw-r--r-- | lib/libarch/i386/i386_get_ioperm.2 | 28 | ||||
| -rw-r--r-- | lib/libarch/i386/i386_get_ldt.2 | 3 | ||||
| -rw-r--r-- | lib/libarch/i386/i386_iopl.2 | 9 |
3 files changed, 37 insertions, 3 deletions
diff --git a/lib/libarch/i386/i386_get_ioperm.2 b/lib/libarch/i386/i386_get_ioperm.2 index aaf8cfaecd3..aab8d7bdba4 100644 --- a/lib/libarch/i386/i386_get_ioperm.2 +++ b/lib/libarch/i386/i386_get_ioperm.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)fork.2 6.5 (Berkeley) 3/10/91 -.\" $Id: i386_get_ioperm.2,v 1.1 1995/10/18 08:41:19 deraadt Exp $ +.\" $NetBSD: i386_get_ioperm.2,v 1.2 1996/01/05 14:56:42 pk Exp $ .\" .Dd October 14, 1995 .Dt I386_GET_IOPERM 2 @@ -40,6 +40,7 @@ .Nm i386_set_ioperm .Nd manage i386 per-process I/O permission bitmap .Sh SYNOPSIS +.Fd #include <sys/types.h> .Fd #include <machine/sysarch.h> .Ft int .Fn i386_get_ioperm "u_long *iomap" @@ -54,6 +55,20 @@ copies the current I/O permission bitmap into the memory referenced by sets the I/O permission bitmap from the data pointed to by .Ar iomap . This call is restricted to the super-user. +.Pp +The permission bitmap contains +1024 +bits in 32 longwords. +If bit +.Va n +is clear in the bitmap, then access is granted to I/O port +.Va n . +If bit +.Va n +is set in the bitmap, then an attempt to access I/O port +.Va n +results in delivery of a SIGBUS signal unless the process's I/O +permission level would grant I/O access. .Sh RETURN VALUES Upon successful completion, .Fn i386_get_ioperm @@ -76,5 +91,16 @@ points outside the process's allocated address space. .It Bq Er EPERM The caller was not the super-user. .El +.Sh BUGS +The bitmap should really cover 65536 bits, but that's just too big for +allocation in a kernel structure. If you need access to ports beyond +1024, +use +.Xr i386_iopl 2 . +.Sh SEE ALSO +.Xr i386_iopl 2 .Sh REFERENCES i386 Microprocessor Programmer's Reference Manual, Intel +.Sh WARNING +You can really hose your machine if you enable user-level I/O and +write to hardware ports without care. diff --git a/lib/libarch/i386/i386_get_ldt.2 b/lib/libarch/i386/i386_get_ldt.2 index 8a9fd362cb7..ef29887af11 100644 --- a/lib/libarch/i386/i386_get_ldt.2 +++ b/lib/libarch/i386/i386_get_ldt.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)fork.2 6.5 (Berkeley) 3/10/91 -.\" $Id: i386_get_ldt.2,v 1.1 1995/10/18 08:41:19 deraadt Exp $ +.\" $NetBSD: i386_get_ldt.2,v 1.3 1996/01/05 14:56:44 pk Exp $ .\" .Dd September 20, 1993 .Dt I386_GET_LDT 2 @@ -40,6 +40,7 @@ .Nm i386_set_ldt .Nd manage i386 per-process Local Descriptor Table entries .Sh SYNOPSIS +.Fd #include <sys/types.h> .Fd #include <machine/segments.h> .Fd #include <machine/sysarch.h> .Ft int diff --git a/lib/libarch/i386/i386_iopl.2 b/lib/libarch/i386/i386_iopl.2 index 5bc72ef77eb..85ccc1d2ef6 100644 --- a/lib/libarch/i386/i386_iopl.2 +++ b/lib/libarch/i386/i386_iopl.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)fork.2 6.5 (Berkeley) 3/10/91 -.\" $Id: i386_iopl.2,v 1.1 1995/10/18 08:41:19 deraadt Exp $ +.\" $NetBSD: i386_iopl.2,v 1.2 1996/01/05 14:56:45 pk Exp $ .\" .Dd October 14, 1995 .Dt I386_IOPL 2 @@ -39,6 +39,7 @@ .Nm i386_iopl .Nd change the i386 I/O privilege level .Sh SYNOPSIS +.Fd #include <sys/types.h> .Fd #include <machine/sysarch.h> .Ft int .Fn i386_iopl "int iopl" @@ -62,5 +63,11 @@ will fail if: .It Bq Er EPERM The caller was not the super-user. .El +.Sh SEE ALSO +.Xr i386_set_ioperm 2 , +.Xr i386_get_ioperm 2 . .Sh REFERENCES i386 Microprocessor Programmer's Reference Manual, Intel +.Sh WARNING +You can really hose your machine if you enable user-level I/O and +write to hardware ports without care. |