NUME¶

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

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

Alternativ, biblioteca de In/Ieș asincronă (libaio, -laio); a se vedea NOTE.

REZUMAT¶

#include <linux/aio_abi.h>    /* Definirea tipurilor necesare */
#include <sys/syscall.h>      /* Definirea constantelor SYS_* */
#include <unistd.h>

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

DESCRIERE¶

Notă: această pagină descrie interfața brută de apelare a sistemului Linux. Funcția de învăluire furnizată de libaio utilizează un tip diferit pentru argumentul ctx_id. A se vedea NOTE.

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.

STANDARDE¶

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

NOTE¶

Probabil că doriți să utilizaț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)

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.