BEZEICHNUNG¶

io_cancel - Abbrechen einer ausstehenden asynchronen E/A-Aktion

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

Ü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: Wahrscheinlich wollen Sie die durch libaio bereitgestellte Wrapper-Funktion io_getevents(3) verwenden; 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¶

Bei Erfolg gibt io_cancel() 0 zurück. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

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¶

libaio provides a wrapper function with the same name, but different prototype and return value. You probably want to use that wrapper.

STANDARDS¶

Linux.

GESCHICHTE¶

Linux 2.5.

SIEHE AUCH¶

io_destroy(2), io_getevents(2), io_setup(2), io_submit(2), io_cancel(3), 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 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.