NUME¶

io_setup - creează un context de In/Ieș asincron

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

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

REZUMAT¶

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

long io_setup(unsigned int nr_events, aio_context_t *ctx_idp);

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

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_idp. A se vedea NOTE.

Apelul de sistem io_setup() creează un context de intrare/ieșire asincron adecvat pentru procesarea simultană a operațiunilor nr_events. Argumentul ctx_idp nu trebuie să indice un context AIO care există deja și trebuie inițializat la 0 înainte de apel. La crearea cu succes a contextului AIO, *ctx_idp este completat cu gestionarul rezultat.

VALOAREA RETURNATö

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

ERORI¶

EAGAIN

Valoarea nr_events specificată depășește limita evenimentelor disponibile, așa cum este definită în /proc/sys/fs/aio-max-nr (a se vedea proc(5)).

EFAULT

Un indicator nevalid este transmis pentru ctx_idp.

EINVAL

ctx_idp nu este inițializat sau nr_events specificat depășește limitele interne. nr_events trebuie să fie mai mare decât 0.

ENOMEM

Nu au fost disponibile suficiente resurse pentru nucleu.

ENOSYS

io_setup() 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_setup() 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_setup() furnizată de libaio.

Rețineți că funcția de învăluire libaio utilizează un tip diferit (io_context_t *) pentru argumentul ctx_idp. 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 ERORI). 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_cancel(2), io_destroy(2), io_getevents(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.