ioplのヘルプ・マニュアル
日本語 英語
iopl --help
man iopl
IOPL(2) Linux Programmer’s Manual IOPL(2)
名前
iopl - I/O 特権レベルを変更する
書式
#include
int iopl(int level);
説明
iopl() は呼び出し元のプロセスの I/O 特権レベルを level で指定した値に変
更する。
この関数は 8514 互換の X サーバを Linux で動作させるために必要である 。
なぜならこの X サーバは 65536 個の I/O ポート全てへのアクセスを要求する
ので ioperm(2) 関数では不十分だからである。
より高い I/O 特権レベルでの動作をさせることによって I/O ポートアクセ ス
の 制限を解除することに加えて、プロセスが割り込みを無効にすることもでき
るようになる。この機能は時としてシステムの破壊をもたらすので勧められ な
い。
fork(2) や exec(2) を行った場合、特権は継承される。
通常のプロセスの I/O 特権レベルは 0 である。
こ のシステムコールはほとんど i386 アーキテクチャのためだけのものである
。その他の多くのアーキテクチャでは存在しないか、常にエラーを返す。
返り値
成功した場合には 0 を返す。エラーの場合には -1 を返し、 errno に適切 な
値が設定される。
エラー
EINVAL 引き数 level が 3 より大きい。
ENOSYS こ の シ ス テ ムコールは実装されていない。呼び出し元プロセスに
iopl() を呼び出すのに十分な権限がなかった。 iopl() を呼び出す に
は CAP_SYS_RAWIO ケーパビリティが必要である。
準拠
iopl() は Linux 特有の関数であり、移植を意図したプログラムで使用しては
ならない。
注意
libc5 ではシステムコールとして扱い にプロトタイプが存在し て
い る 。 glibc1 にはプロトタイプは存在していない。 glibc2 は
と の両方にプロトタイプを持っている。後者は i386 のみで 利
用可能なので、使用すべきではない。
関連項目
ioperm(2), capabilities(7)
Linux 2004-05-27 IOPL(2)
IOPL(2) Linux Programmer’s Manual IOPL(2)
NAME
iopl - change I/O privilege level
SYNOPSIS
#include
int iopl(int level);
DESCRIPTION
iopl() changes the I/O privilege level of the calling process, as spec-
ified in level.
This call is necessary to allow 8514-compatible X servers to run under
Linux. Since these X servers require access to all 65536 I/O ports,
the ioperm(2) call is not sufficient.
In addition to granting unrestricted I/O port access, running at a
higher I/O privilege level also allows the process to disable inter-
rupts. This will probably crash the system, and is not recommended.
Permissions are inherited by fork(2) and execve(2).
The I/O privilege level for a normal process is 0.
This call is mostly for the i386 architecture. On many other architec-
tures it does not exist or will always return an error.
RETURN VALUE
On success, zero is returned. On error, -1 is returned, and errno is
set appropriately.
ERRORS
EINVAL level is greater than 3.
ENOSYS This call is unimplemented.
EPERM The calling process has insufficient privilege to call iopl();
the CAP_SYS_RAWIO capability is required.
CONFORMING TO
iopl() is Linux-specific and should not be used in processes intended
to be portable.
NOTES
Libc5 treats it as a system call and has a prototype in .
Glibc1 does not have a prototype. Glibc2 has a prototype both in
and in . Avoid the latter, it is available on
i386 only.
SEE ALSO
ioperm(2), capabilities(7)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2004-05-27 IOPL(2)