io_destroy(2)

BEZEICHNUNG
io_destroy - Einen asynchronen E/A-Kontext zerstören

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

ÜBERSICHT
#include <linux/aio_abi.h>    /* Definition von aio_context_t */
#include <sys/syscall.h>      /* Definition der SYS_*-Konstanten */
#include <unistd.h>

int syscall(SYS_io_destroy, aio_context_t ctx_id);

Hinweis: Glibc stellt keinen Wrapper für io_destroy() bereit; hierdurch wird die Verwendung von syscall(2) notwendig.

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_destroy() wird versuchen, alle ausstehenden asynchronen E/A-Aktionen gegen ctx_id abzubrechen, wird bis zum Abschluss aller Aktionen, die nicht abgebrochen werden können, blockieren und wird den Kontext ctx_id zerstören.

RÜCKGABEWERT
Im Erfolgsfall liefert io_destroy() 0 zurück. Für die Rückgabe im Fehlerfall siehe VERSIONEN.

FEHLER

EFAULT
    Der Kontext, auf den gezeigt wird, ist ungültig.

EINVAL
    Der durch ctx_id festgelegte AIO-Kontext ist ungültig.

ENOSYS
    io_destroy() ist auf dieser Architektur nicht implementiert.

VERSIONEN
Wahrscheinlich möchten Sie die von libaio bereitgestellte Wrapper-Funktion io_destroy() 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_cancel(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 (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.