IOPERM(2)

BEZEICHNUNG
ioperm - setzt Port-Zugriffsrechte für Eingabe/Ausgabe

ÜBERSICHT
#include <unistd.h> /* für Libc5 */
#include <stdio.h> /* für Glibc */

int ioperm(unsigned long from, unsigned long num, int turn_on);

BESCHREIBUNG
ioperm() setzt die Bits für die Port-Zugriffsrechte des aufrufenden Prozesses ab der Port-Adresse from für num Byte auf den Wert turn_on. Wenn der Wert von turn_on nicht Null ist, muss der aufrufende Prozess privilegiert sein (CAP_SYS_RAWIO).

Mit Linux-Versionen älter als 2.6.8 können nur die ersten 0x3ff E/A-Ports auf diese Weise angegeben werden. Für weitere Ports muss der Systemaufruf iopl(2) verwendet werden, mit einem level-Argument von 3. Seit Linux 2.6.8 können 65536 Ports angegeben werden.

Von fork(2) erzeugte Kindprozesse erben die Zugriffsrechte nicht, das Kind muss die benötigten Zugriffsrechte selbst aktivieren. Die Rechte bleiben über Aufrufe von execve(2) erhalten. Das ist nützlich für die Gewährung von Port-Zugriffsberechtigungen für nicht privilegierte Programme.

Der Aufruf ist hauptsächlich für die i386-Architektur. Auf vielen anderen Architekturen existiert er nicht und wird immer einen Fehler zurückliefern.

RÜCKGABEWERT
Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno entsprechend gesetzt.

FEHLER

EINVAL
    ungültige Werte für from oder num

EIO (auf PowerPC) Dieser Aufruf wird nicht unterstützt.

ENOMEM
    Speicher aufgebraucht.

EPERM
    Der aufrufende Prozess hat unzureichende Rechte.

KONFORM ZU
ioperm() ist Linux-spezifisch und sollte nicht in Programmen verwendet werden, die portierbar sein sollen.

ANMERKUNGEN
Die Datei /proc/ioports zeigt die E/A-Ports, die aktuell im System zugewiesen sind.

Libc5 behandelt ioperm() als einen Systemaufruf und hat einen Prototyp in <unistd.h>. Glibc1 hat keinen Prototyp. Glibc2 hat einen Prototypen sowohl in <sys/io.h> als auch in <sys/perm.h>. Vermeiden Sie den Letzteren, weil er nur für i386 verfügbar ist.

SIEHE AUCH
iopl(2), outb(2), capabilities(7)

KOLOPHON
This page is part of release 3.54 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/.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <krd@gulu.net>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.