Return to i386_iopl.2 CVS log

Up to [cvs.NetBSD.org] / src / lib / libarch / i386

Annotation of src/lib/libarch/i386/i386_iopl.2, Revision 1.17

1.17    ! martin      1: .\"    $NetBSD: i386_iopl.2,v 1.16 2006/04/13 21:08:33 wiz Exp $
1.3       jtc         2: .\"
                      3: .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
1.1       mycroft     4: .\" All rights reserved.
                      5: .\"
1.3       jtc         6: .\" This code is derived from software contributed to The NetBSD Foundation
                      7: .\" by John T. Kohl and Charles M. Hannum.
                      8: .\"
1.1       mycroft     9: .\" Redistribution and use in source and binary forms, with or without
                     10: .\" modification, are permitted provided that the following conditions
                     11: .\" are met:
                     12: .\" 1. Redistributions of source code must retain the above copyright
                     13: .\"    notice, this list of conditions and the following disclaimer.
                     14: .\" 2. Redistributions in binary form must reproduce the above copyright
                     15: .\"    notice, this list of conditions and the following disclaimer in the
                     16: .\"    documentation and/or other materials provided with the distribution.
                     17: .\"
1.3       jtc        18: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
                     19: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
                     20: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
1.6       jtc        21: .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
                     22: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
1.3       jtc        23: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
                     24: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                     25: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                     26: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
                     27: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
                     28: .\" POSSIBILITY OF SUCH DAMAGE.
1.1       mycroft    29: .\"
1.16      wiz        30: .Dd April 12, 2004
1.10      kleink     31: .Dt I386_IOPL 2 i386
1.8       garbled    32: .Os
1.1       mycroft    33: .Sh NAME
                     34: .Nm i386_iopl
                     35: .Nd change the i386 I/O privilege level
1.7       perry      36: .Sh LIBRARY
                     37: .Lb libi386
1.1       mycroft    38: .Sh SYNOPSIS
1.14      wiz        39: .In sys/types.h
                     40: .In machine/sysarch.h
1.1       mycroft    41: .Ft int
                     42: .Fn i386_iopl "int iopl"
                     43: .Sh DESCRIPTION
                     44: .Fn i386_iopl
                     45: sets the i386 I/O privilege level to the value specified by
1.4       fvdl       46: .Ar iopl .
1.1       mycroft    47: This call is restricted to the super-user.
                     48: .Sh RETURN VALUES
                     49: Upon successful completion,
                     50: .Fn i386_iopl
                     51: returns 0.
1.13      wiz        52: Otherwise, a value of \-1 is returned and the global
1.1       mycroft    53: variable
                     54: .Va errno
                     55: is set to indicate the error.
                     56: .Sh ERRORS
                     57: .Fn i386_iopl
                     58: will fail if:
                     59: .Bl -tag -width [EINVAL]
                     60: .It Bq Er EPERM
1.5       tls        61: The caller was not the super-user, or the operation was not permitted at the
                     62: current security level.
1.1       mycroft    63: .El
                     64: .Sh REFERENCES
                     65: i386 Microprocessor Programmer's Reference Manual, Intel
1.2       pk         66: .Sh WARNING
                     67: You can really hose your machine if you enable user-level I/O and
                     68: write to hardware ports without care.