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