io_cancel(2)

BEZEICHNUNG
io_cancel - Abbrechen einer ausstehenden asynchronen E/A-Aktion

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

Alternativ, asynchrone E/A-Bibliothek (libaio, -laio); siehe VERSIONEN.

ÜBERSICHT
#include <linux/aio_abi.h>    /* Definition der benötigten Typen */
#include <sys/syscall.h>      /* Definition der SYS_*-Konstanten */
#include <unistd.h>

int syscall(SYS_io_cancel, aio_context_t ctx_id, struct iocb *iocb,
            struct io_event *ergebnis);

BESCHREIBUNG
Hinweis: Diese Seite beschreibt die rohe Linux-Systemaufrufschnittstelle. Die durch libaio bereitgestellte Wrapper-Funktion verwendet einen anderen Typ für das Argument ctx_id. Siehe VERSIONEN.

Der Systemaufruf io_cancel() versucht, eine asynchrone E/A-Aktion, die vorher mit io_submit(2) eingereicht wurde, abzubrechen. Das Argument iocb beschreibt die abzubrechende Aktion und das Argument ctx_id ist der AIO-Kontext, in den die Aktion eingereicht wurde. Falls die Aktion erfolgreich abgebrochen wurde, wird das Ereignis in den Speicher kopiert, auf den ergebnis zeigt, ohne in die Abschluss-Warteschlange gelegt zu werden.

RÜCKGABEWERT
Im Erfolgsfall liefert io_cancel() 0 zurück. Informationen zur Rückgabe bei Fehlern finden Sie in VERSIONEN.

FEHLER

EAGAIN
    Die angegebe iocb wurde nicht abgebrochen.

EFAULT
    Eine der Datenstrukturen zeigt auf ungültige Daten.

EINVAL
    Der durch ctx_id festgelegte AIO-Kontext ist ungültig.

ENOSYS
    io_cancel() ist auf dieser Architektur nicht implementiert.

VERSIONEN
Wahrscheinlich wollen Sie die durch libaio bereitgestellte Wrapper-Funktion io_cancel() verwenden.

Beachten Sie, dass die Wrapper-Funktion libaio einen anderen Typ (io_context_t) für das Argument ctx_id verwendet. Beachten Sie auch, dass der libaio-Wrapper nicht der normalen Konvention der C-Bibliothek zum Anzeigen von Fehlern folgt: bei Fehlern liefert sie die negierte Fehlernummer (das Negative eines der in FEHLER aufgeführten Fehler) zurück. Falls der Systemaufruf mittels syscall(2) erfolgt, dann folgt der Rückgabewert den normalen Konventionen zur Anzeige von Fehlern: -1, wobei errno auf einen (positiven) Wert gesetzt ist, der den Fehler angibt.

STANDARDS
Linux.

GESCHICHTE
Linux 2.5.

SIEHE AUCH
io_destroy(2), io_getevents(2), io_setup(2), io_submit(2), aio(7)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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 die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.