iopl

Name

iopl -- change I/O privilege level

Synopsis

#include <sys/io.h> /* for glibc */

int iopl(int level);

Description

iopl changes the I/O privilege level of the current process, as specified 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 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 interrupts. This will probably crash the system, and is not recommended.

Permissions are inherited by fork and exec.

The I/O privilege level for a normal process is 0.

Return Value

On success, zero is returned. On error, -1 is returned, and errno is set appropriately.

Errors

EINVAL 

level is greater than 3.

EPERM 

The current user is not the super-user.