lio_listio(3)              Library Functions Manual              lio_listio(3)

NUME
       lio_listio - ini<?>iaza o lista de cereri de In/Ie<?>

BIBLIOTECA
       Biblioteca de timp real (librt, -lrt)

REZUMAT
       #include <aio.h>

       int lio_listio(int mode,
                      struct aiocb *restrict const aiocb_list[restrict],
                      int nitems, struct sigevent *restrict sevp);

DESCRIERE
       Func<?>ia lio_listio() ini<?>iaza lista de opera<?>ii de
       intrare/ie<?>ire descrise de matricea aiocb_list.

       Opera<?>ia mode are una dintre urmatoarele valori:

       LIO_WAIT
              Apelul se blocheaza pana cand toate opera<?>iile sunt
              finalizate. Argumentul sevp este ignorat.

       LIO_NOWAIT
              Opera<?>iile de In/Ie<?> sunt puse in coada pentru procesare,
              iar apelul returneaza imediat. Atunci cand toate opera<?>iile de
              intrare/ie<?>ire se finalizeaza, are loc o notificare asincrona,
              dupa cum se specifica prin argumentul sevp; a se vedea
              sigevent(3type) pentru detalii. In cazul in care sevp este NULL,
              nu are loc nicio notificare asincrona.

       Argumentul aiocb_list este o matrice de indicatori la structurile aiocb
       care descriu opera<?>iile de In/Ie<?>. Aceste opera<?>ii sunt executate
       intr-o ordine nespecificata. Argumentul nitems specifica dimensiunea
       matricei aiocb_list. Se ignora indicatoarele nule din aiocb_list.

       In fiecare bloc de control din aiocb_list, campul aio_lio_opcode
       specifica opera<?>ia de In/Ie<?> care urmeaza sa fie ini<?>iata, dupa
       cum urmeaza:

       LIO_READ
              Ini<?>iaza o opera<?>ie de citire. Opera<?>ia este pusa in coada
              de a<?>teptare ca pentru un apel la aio_read(3) care specifica
              acest bloc de control.

       LIO_WRITE
              Ini<?>iaza o opera<?>ie de scriere. Opera<?>ia este pusa in
              coada de a<?>teptare ca pentru un apel la aio_write(3) care
              specifica acest bloc de control.

       LIO_NOP
              Ignora acest bloc de control.

       Campurile ramase in fiecare bloc de control au acelea<?>i
       semnifica<?>ii ca <?>i pentru aio_read(3) <?>i aio_write(3).  Campurile
       aio_sigevent din fiecare bloc de control pot fi utilizate pentru a
       specifica notificari pentru opera<?>iile de In/Ie<?> individuale (a se
       vedea sigevent(7)).

VALOAREA RETURNATA
       Daca mode este LIO_NOWAIT, lio_listio() returneaza 0 daca toate
       opera<?>iile de In/Ie<?> sunt puse in coada cu succes. In caz contrar,
       se returneaza -1, iar errno este configurata pentru a indica eroarea.

       Daca mode este LIO_WAIT, lio_listio() returneaza 0 atunci cand toate
       opera<?>iile de In/Ie<?> s-au finalizat cu succes. In caz contrar, se
       returneaza -1, iar errno este configurata pentru a indica eroarea.

       Starea de returnare din lio_listio() ofera informa<?>ii numai despre
       apelul in sine, nu <?>i despre opera<?>iile individuale de In/Ie<?>.
       Una sau mai multe dintre opera<?>iile de In/Ie<?> pot e<?>ua, dar acest
       lucru nu impiedica finalizarea altor opera<?>ii. Starea opera<?>iilor
       individuale de In/Ie<?> din aiocb_list poate fi determinata cu ajutorul
       aio_error(3). Atunci cand o opera<?>ie s-a incheiat, starea de
       returnare a acesteia poate fi ob<?>inuta folosind aio_return(3).
       Opera<?>iile individuale de In/Ie<?> pot e<?>ua din motivele descrise
       in aio_read(3) <?>i aio_write(3).

ERORI-IE<?>IRE
       Func<?>ia lio_listio() poate e<?>ua din urmatoarele motive:

       EAGAIN Resurse insuficiente.

       EAGAIN Numarul de opera<?>ii de In/Ie<?> specificat de nitems ar duce
              la depa<?>irea limitei AIO_MAX.

       EINTR  mode a fost LIO_WAIT <?>i un semnal a fost captat inainte ca
              toate opera<?>iunile de In/Ie<?> sa se incheie; a se vedea
              signal(7); (acesta poate fi chiar unul dintre semnalele
              utilizate pentru notificarea asincrona a finalizarii In/Ie<?>).

       EINVAL mode nu este valid sau nitems depa<?>e<?>te limita
              AIO_LISTIO_MAX.

       EIO    Una sau mai multe dintre opera<?>iile specificate de aiocb_list
              au e<?>uat. Aplica<?>ia poate verifica starea fiecarei
              opera<?>ii utilizand aio_return(3).

       Daca lio_listio() e<?>ueaza cu eroarea EAGAIN, EINTR sau EIO, atunci
       este posibil ca unele dintre opera<?>iile din aiocb_list sa fi fost
       ini<?>iate. Daca lio_listio() e<?>ueaza din orice alt motiv, atunci
       niciuna dintre opera<?>iile In/Ie<?> nu a fost ini<?>iata.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |lio_listio()                          | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.1.  POSIX.1-2001.

NOTE
       Este o idee buna sa se puna la zero blocurile de control inainte de
       utilizare. Blocurile de control nu trebuie sa fie modificate in timp ce
       opera<?>iile de In/Ie<?> sunt in curs de desfa<?>urare. Zonele tampon
       in care se cite<?>te sau din care se scrie nu trebuie accesate in
       timpul opera<?>iilor, altfel pot aparea rezultate nedefinite. Zonele de
       memorie implicate trebuie sa ramana valide.

       Opera<?>iile de In/Ie<?> simultane care specifica aceea<?>i structura
       aiocb produc rezultate nedefinite.

CONSULTA<?>I <?>I
       aio_cancel(3), aio_error(3), aio_fsync(3), aio_return(3),
       aio_suspend(3), aio_write(3), aio(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                 lio_listio(3)