NUME¶

io_cancel - anulează o operație de intrare/ieșire asincronă în curs de desfășurare

REZUMAT¶

#include <linux/aio_abi.h>          /* Define tipurile necesare */

int io_cancel(aio_context_t ctx_id, struct iocb *iocb,
              struct io_event *result);

Notă: Nu există o funcție învăluitoare (wrapper) glibc pentru acest apel de sistem; a se vedea NOTE.

DESCRIERE¶

Apelul de sistem io_cancel() încearcă să anuleze o operație de intrare/ieșire asincronă transmisă anterior cu io_submit(2). Argumentul iocb descrie operația care urmează să fie anulată, iar argumentul ctx_id este contextul AIO la care a fost trimisă operația. Dacă operația este anulată cu succes, evenimentul va fi copiat în memoria indicată de result fără a fi plasat în coada de așteptare a completării.

VALOAREA RETURNATö

În caz de succes, io_cancel() returnează 0. Pentru returnarea în caz de eșec, a se vedea NOTE.

ERORI¶

EAGAIN

iocb specificată nu a fost anulată.

EFAULT

Una dintre structurile de date indică date nevalide.

EINVAL

Contextul AIO specificat de ctx_id nu este valid.

ENOSYS

io_cancel() nu este implementat pe această arhitectură.

VERSIUNI¶

Apelurile sistemului de In/Ieș asincrone au apărut pentru prima dată în Linux 2.5.

ÎN CONFORMITATE CU¶

io_cancel() este specific Linux și nu ar trebui să fie utilizată în programe care sunt destinate să fie portabile.

NOTE¶

Glibc nu oferă o funcție de învăluire pentru acest apel de sistem. Puteți să-l apelați folosind syscall(2). Dar, în schimb, probabil că doriți să folosiți funcția de învăluire io_cancel() furnizată de libaio.

Rețineți că funcția de învăluire libaio utilizează un tip diferit (io_context_t) pentru argumentul ctx_id. Rețineți, de asemenea, că funcția de învăluire libaio nu respectă convențiile obișnuite ale bibliotecii C pentru indicarea erorilor: în caz de eroare, aceasta returnează un număr de eroare negat (negativul uneia dintre valorile enumerate în ERRORS). Dacă apelul de sistem este invocat prin syscall(2), atunci valoarea de returnare urmează convențiile obișnuite pentru indicarea unei erori: -1, cu errno configurată la o valoare (pozitivă) care indică eroarea.

CONSULTAȚI ȘI¶

io_destroy(2), io_getevents(2), io_setup(2), io_submit(2), aio(7)

COLOFON -- NOTà FINALö

Această pagină face parte din versiunea 4.16 a proiectului Linux man-pages. O descriere a proiectului, informații despre raportarea erorilor și cea mai recentă versiune a acestei pagini pot fi găsite la https://www.kernel.org/doc/man-pages/.

TRADUCERE¶

Traducerea în limba română a acestui manual a fost creată de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă Nicio RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.