.\" -*- nroff -*-
.\"
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\" Portions extracted from linux/kernel/ioport.c (no copyright notice).
.\"
.\" 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.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Tue Aug  1 16:47    1995 by Jochen Karrer 
.\"                              <cip307@cip.physik.uni-wuerzburg.de>
.\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Fri Nov 27 14:50:36 CET 1998 by Andries Brouwer <aeb@cwi.nl>
.\"
.TH IOPL 2 "24/07/1993" "Linux 0.99.11" "Manual do Programador Linux"
.SH NOME
iopl \- altera o nível de privilégio de E/S
.SH SINOPSE
.B #include <unistd.h>
/* for libc5 */
.br
.B #include <sys/io.h>
/* for glibc */
.sp
.BI "int iopl(int " level );
.SH DESCRIÇÃO
.B iopl
altera o nível de privilégio de E/S de um processo aatual, como especificado em
.IR level .

Esta chamada é necessária para permitir a compatibilidade que servidores X 8514 rodem no
Linux. Desde então estes servidores X acessam todas as portas de E/S do 65536, a chamada
.B ioperm
não foi suficiente.

Em adição a concessão de acesso as portas de E/S irrestrito, rodando em um alto nível de
privilégio de E/S também permite ao processo desabilitar interrupções. Isto
irá provavelmente derrubar o sistema, e não é recomendado.

Permissões são herdadas através de fork e exec.

O nível de privilégio de E/S para um processo normal é 0.
.SH "VALORES RETORNADOS"
Em caso de sucesso, zero é retornado. Caso contrário, \-1 é retornado, e
.I errno
é selecionado adequamente.
.SH ERROS
.TP
.B EINVAL
.I level
é maior que 3.
.TP
.B EPERM
O usuário autal não é o superusuário.
.SH "NOTAS VINDAS DO FONTE DO KERNEL"
.B iopl
ela tem que ser usada quando você procura acessar as portas de E/S além do intervalo
0x3ff: para obter o mapa de bits completo do 65536 você precisaria de 8kB de
mapa de bits/processo,o que é um excesso de bits.
.SH "DE ACORDO COM"
\fBiopl\fP é específica do Linux e não deveria ser usada em processos
que pretendem ser portáveis.
.SH NOTAS
Libc5 trata com uma chamada de sistema e tem um tipo primitivo em
.IR <unistd.h> .
Glibc1 não tem um tipo primitivo. Glibc2 tem um tipo primitivo em
.I <sys/io.h>
e em
.IR <sys/perm.h> .
Evitar o segundo, ele está disponível somente nos i386.
.SH "VEJA TAMBÉM"
.BR ioperm (2)