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) Alternativ, asynchrone E/A-Bibliothek (libaio, -laio); siehe VERSIONEN. UBERSICHT #include /* Definition der benotigten Typen */ #include /* Definition der SYS_*-Konstanten */ #include 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 fur 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. RUCKGABEWERT Im Erfolgsfall liefert io_cancel() 0 zuruck. Informationen zur Ruckgabe bei Fehlern finden Sie in VERSIONEN. 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 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) fur 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 aufgefuhrten Fehler) zuruck. Falls der Systemaufruf mittels syscall(2) erfolgt, dann folgt der Ruckgabewert 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) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 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: . Linux man-pages 6.17 17. Mai 2025 io_cancel(2)