.\" -*- coding: UTF-8 -*-
.\" Copyright 2003, Free Software Foundation, Inc.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH io_cancel 2 "17. Mai 2025" "Linux man\-pages 6.17" 
.SH BEZEICHNUNG
io_cancel \- Abbrechen einer ausstehenden asynchronen E/A\-Aktion
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.P
Alternativ, asynchrone E/A\-Bibliothek (\fIlibaio\fP,\ \fI\-laio\fP); siehe
VERSIONEN.
.SH ÜBERSICHT
.nf
\fB#include <linux/aio_abi.h>\fP    /* Definition der benötigten Typen */
\fB#include <sys/syscall.h>\fP      /* Definition der \fBSYS_*\fP\-Konstanten */
\fB#include <unistd.h>\fP
.P
\fBint syscall(SYS_io_cancel, aio_context_t \fP\fIctx_id\fP\fB, struct iocb *\fP\fIiocb\fP\fB,\fP
\fB            struct io_event *\fP\fIergebnis\fP\fB);\fP
.fi
.SH BESCHREIBUNG
\fIHinweis\fP: Diese Seite beschreibt die rohe
Linux\-Systemaufrufschnittstelle. Die durch \fIlibaio\fP bereitgestellte
Wrapper\-Funktion verwendet einen anderen Typ für das Argument
\fIctx_id\fP. Siehe VERSIONEN.
.P
Der Systemaufruf \fBio_cancel\fP() versucht, eine asynchrone E/A\-Aktion, die
vorher mit \fBio_submit\fP(2) eingereicht wurde, abzubrechen. Das Argument
\fIiocb\fP beschreibt die abzubrechende Aktion und das Argument \fIctx_id\fP 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 \fIergebnis\fP zeigt, ohne in die Abschluss\-Warteschlange gelegt zu
werden.
.SH RÜCKGABEWERT
Im Erfolgsfall liefert \fBio_cancel\fP() 0 zurück. Informationen zur Rückgabe
bei Fehlern finden Sie in VERSIONEN.
.SH FEHLER
.TP 
\fBEAGAIN\fP
Die angegebe \fIiocb\fP wurde nicht abgebrochen.
.TP 
\fBEFAULT\fP
Eine der Datenstrukturen zeigt auf ungültige Daten.
.TP 
\fBEINVAL\fP
Der durch \fIctx_id\fP festgelegte AIO\-Kontext ist ungültig.
.TP 
\fBENOSYS\fP
\fBio_cancel\fP() ist auf dieser Architektur nicht implementiert.
.SH VERSIONEN
.\" http://git.fedorahosted.org/git/?p=libaio.git
Wahrscheinlich wollen Sie die durch \fIlibaio\fP bereitgestellte
Wrapper\-Funktion \fBio_cancel\fP() verwenden.
.P
.\" But glibc is confused, since <libaio.h> uses 'io_context_t' to declare
.\" the system call.
Beachten Sie, dass die Wrapper\-Funktion \fIlibaio\fP einen anderen Typ
(\fIio_context_t\fP) für das Argument \fIctx_id\fP verwendet. Beachten Sie auch,
dass der \fIlibaio\fP\-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 \fBsyscall\fP(2) erfolgt, dann folgt der
Rückgabewert den normalen Konventionen zur Anzeige von Fehlern: \-1, wobei
\fIerrno\fP auf einen (positiven) Wert gesetzt ist, der den Fehler angibt.
.SH STANDARDS
Linux.
.SH GESCHICHTE
Linux 2.5.
.SH "SIEHE AUCH"
\fBio_destroy\fP(2), \fBio_getevents\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2),
\fBaio\fP(7)
.\" .SH AUTHOR
.\" Kent Yoder.
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer:
.MT debian-l10n-german@lists.debian.org
.ME .