aio_read(3)                Library Functions Manual                aio_read(3)

NUME
       aio_read - citire asincrona

BIBLIOTECA
       Biblioteca de timp real (librt, -lrt)

REZUMAT
       #include <aio.h>

       int aio_read(struct aiocb *aiocbp);

DESCRIERE
       Func<?>ia aio_read() pune in coada cererea de intrare/ie<?>ire descrisa
       de memoria tampon indicata de aiocbp.  Aceasta func<?>ie este analogul
       asincron al func<?>iei read(2).  Argumentele apelului

           read(fd, buf, count)

       corespund (in ordine) campurilor aio_fildes, aio_buf <?>i aio_nbytes
       din structura indicata de aiocbp. (A se vedea aio(7) pentru o descriere
       a structurii aiocb).

       Datele sunt citite incepand de la pozi<?>ia absoluta
       aiocbp->aio_offset, indiferent de pozi<?>ia indicatorului in fi<?>ier.
       Dupa apel, Datele sunt citite incepand de la pozi<?>ia absoluta
       aiocbp->aio_offset, indiferent de pozi<?>ia curenta a pointerului pe
       fi<?>ier. Dupa acest apel, valoarea pozi<?>iei curente a indicatorului
       fi<?>ierului este nespecificata.

       ,,Asincron" inseamna ca acest apel returneaza imediat ce cererea a fost
       pusa in coada; citirea poate fi sau nu finalizata atunci cand se
       returneaza apelul.  Se poate testa finalizarea folosind aio_error(3).
       Starea de returnare a unei opera<?>ii In/Ie<?> finalizate poate fi
       ob<?>inuta prin aio_return(3). Notificarea asincrona a finalizarii
       In/Ie<?> poate fi ob<?>inuta prin configurarea corespunzatoare a
       aiocbp->aio_sigevent; a se vedea sigevent(3type) pentru detalii.

       Daca _POSIX_PRIORITIZED_IO este definita, iar acest fi<?>ier o accepta,
       atunci opera<?>ia asincrona este transmisa cu o prioritate egala cu cea
       a procesului apelant minus aiocbp->aio_reqprio.

       Campul aiocbp->aio_lio_opcode este ignorat.

       Nu se citesc date dintr-un fi<?>ier normal dincolo de decalajul maxim
       al acestuia.

VALOAREA RETURNATA
       In caz de succes, se returneaza 0.  In caz de eroare, cererea nu este
       pusa in coada, se returneaza -1, iar errno este configurata pentru a
       indica eroarea. In cazul in care o eroare este detectata abia mai
       tarziu, aceasta va fi raportata prin intermediul aio_return(3)
       (returneaza starea -1) <?>i aio_error(3) (starea de eroare, oricare ar
       fi fost cea ob<?>inuta in errno, cum ar fi EBADF).

ERORI-IE<?>IRE
       EAGAIN Resurse insuficiente.

       EBADF  aio_fildes nu este un descriptor de fi<?>ier valid deschis
              pentru citire.

       EINVAL Unul sau mai multe dintre aio_offset, aio_reqprio, sau
              aio_nbytes nu sunt valide.

       ENOSYS aio_read() nu este implementata.

       EOVERFLOW
              Fi<?>ierul este un fi<?>ier obi<?>nuit, incepem sa citim inainte
              de sfar<?>itul fi<?>ierului <?>i dorim cel pu<?>in un octet, dar
              pozi<?>ia de pornire a depa<?>it decalajul maxim pentru acest
              fi<?>ier.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |aio_read()                            | 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 blocul de control inainte de
       utilizare.  Blocul de control nu trebuie sa fie modificat in timp ce
       opera<?>ia de citire este in desfa<?>urare.  Zona din memoria tampon
       din care se cite<?>te nu trebuie accesata in timpul opera<?>iei, 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.

EXEMPLE
       A se vedea aio(7).

CONSULTA<?>I <?>I
       aio_cancel(3), aio_error(3), aio_fsync(3), aio_return(3),
       aio_suspend(3), aio_write(3), lio_listio(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                   aio_read(3)