io_cancel(2)                  System Calls Manual                 io_cancel(2)

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

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

UBERSICHT
       #include <linux/aio_abi.h>    /* Definition der benotigten 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.

RUCKGABEWERT
       Bei Erfolg gibt io_cancel() 0 zuruck. Bei einem Fehler wird -1
       zuruckgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER
       EAGAIN Die angegebe iocb wurde nicht abgebrochen.

       EFAULT Eine der Datenstrukturen zeigt auf ungultige Daten.

       EINVAL Der durch ctx_id festgelegte AIO-Kontext ist ungultig.

       ENOSYS io_cancel() ist auf dieser Architektur nicht implementiert.

VERSIONEN
       libaio <https://pagure.io/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)

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge
       Kreutzmann <debian@helgefjell.de> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

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

Linux man-pages 6.18            11. April 2026                    io_cancel(2)