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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.