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

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. Bezüglich des Fehlerfalls siehe ANMERKUNGEN.

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¶

Die asynchronen E/A-Systemaufrufe erschienen erstmalig in Linux 2.5.

STANDARDS¶

io_destroy() ist Linux-spezifisch und sollte nicht in Programmen verwandt werden, die als portierbar gedacht sind.

ANMERKUNGEN¶

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.

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.