LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / iopl.2

diff --git a/original/man2/iopl.2 b/original/man2/iopl.2
index a734686..83697c7 100644 (file)
--- a/original/man2/iopl.2
+++ b/original/man2/iopl.2
@@ -1,8 +1,7 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
 .\" Portions extracted from linux/kernel/ioport.c (no copyright notice).
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -22,6 +21,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified Tue Aug  1 16:47    1995 by Jochen Karrer
 .\"                              <cip307@cip.physik.uni-wuerzburg.de>
@@ -30,7 +30,7 @@
 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"     Added notes on capability requirements
 .\"
-.TH IOPL 2 2004-05-27 "Linux" "Linux Programmer's Manual"
+.TH IOPL 2 2013-03-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 iopl \- change I/O privilege level
 .SH SYNOPSIS
@@ -39,7 +39,8 @@ iopl \- change I/O privilege level
 .BI "int iopl(int " level );
 .SH DESCRIPTION
 .BR iopl ()
-changes the I/O privilege level of the calling process, as specified in
+changes the I/O privilege level of the calling process,
+as specified by the two least significant bits in
 .IR level .
 
 This call is necessary to allow 8514-compatible X servers to run under
@@ -62,7 +63,7 @@ The I/O privilege level for a normal process is 0.
 This call is mostly for the i386 architecture.
 On many other architectures it does not exist or will always
 return an error.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success, zero is returned.
 On error, \-1 is returned, and
 .I errno
@@ -81,10 +82,11 @@ The calling process has insufficient privilege to call
 .BR iopl ();
 the
 .B CAP_SYS_RAWIO
-capability is required.
-.SH "CONFORMING TO"
+capability is required to raise the I/O privilege level
+above its current value.
+.SH CONFORMING TO
 .BR iopl ()
-is Linux-specific and should not be used in processes
+is Linux-specific and should not be used in programs that are
 intended to be portable.
 .SH NOTES
 Libc5 treats it as a system call and has a prototype in
@@ -95,6 +97,16 @@ Glibc2 has a prototype both in
 and in
 .IR <sys/perm.h> .
 Avoid the latter, it is available on i386 only.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR ioperm (2),
+.BR outb (2),
 .BR capabilities (7)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.