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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                     io_destroy(2)