io_cancel(2)

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 eingestellt 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
    Der angegebene 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 (https://pagure.io/libaio) stellt eine Wrapper-Funktion mit dem gleichen Namen, aber anderem Prototyp und Rückgabewert bereit. Wahrscheinlich möchten Sie den Wrapper verwenden.

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