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 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.