io_getevents(2)               System Calls Manual              io_getevents(2)

NUME
       io_getevents - cite<?>te evenimentele de In/Ie<?> asincrone din coada
       de completare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

       Alternativ, biblioteca de In/Ie<?> asincrona (libaio, -laio); a se
       vedea VERSIUNI.

SINOPSIS
       #include <linux/aio_abi.h>    /* Defini<?>ia tipului *io_*. */
       #include <sys/syscall.h>      /* Defini<?>ia constantelor SYS_* */
       #include <unistd.h>

       int syscall(SYS_io_getevents, aio_context_t ctx_id,
                   long min_nr, long nr, struct io_event *events,
                   struct timespec *timeout);

       Nota: glibc nu ofera o func<?>ie invaluitoare pentru io_getevents(),
       fiind necesara utilizarea syscall(2).

DESCRIERE
       Nota: aceasta pagina descrie interfa<?>a bruta de apelare a sistemului
       Linux. Func<?>ia de invaluire furnizata de libaio utilizeaza un tip
       diferit pentru argumentul ctx_id. A se vedea VERSIUNI.

       Apelul de sistem io_getevents() incearca sa citeasca cel pu<?>in min_nr
       evenimente <?>i pana la nr evenimente din coada de completare a
       contextului AIO specificat de ctx_id.

       Argumentul timeout specifica timpul de a<?>teptare a evenimentelor <?>i
       este specificat ca un timp de a<?>teptare relativ intr-o structura
       timespec(3).

       Timpul specificat va fi rotunjit la granularitatea (fine<?>ea) ceasului
       de sistem <?>i se garanteaza ca nu va expira mai devreme.

       Specificarea timeout ca NULL inseamna blocarea pe termen nedefinit pana
       cand se ob<?>in cel pu<?>in min_nr evenimente.

VALOAREA RETURNATA
       In caz de succes, io_getevents() returneaza numarul de evenimente
       citite.  Acesta poate fi 0, sau o valoare mai mica decat min_nr, daca
       timeout a expirat.  Poate fi, de asemenea, o valoare diferita de zero,
       mai mica decat min_nr, daca apelul a fost intrerupt de un gestionar de
       semnal.

       Pentru returnarea e<?>ecului, a se vedea VERSIUNI.

ERORI-IE<?>IRE
       EFAULT Fie events, fie timeout este un indicator nevalid.

       EINTR  Intrerupt de un gestionar de semnal; a se vedea signal(7).

       EINVAL ctx_id nu este valid. min_nr este in afara intervalului sau nr
              este in afara intervalului.

       ENOSYS io_getevents() nu este implementat pe aceasta arhitectura.

VERSIUNI
       Probabil ca dori<?>i sa utiliza<?>i func<?>ia de invaluire
       io_getevents() furnizata de libaio.

       Re<?>ine<?>i ca func<?>ia de invaluire libaio utilizeaza un tip diferit
       (io_context_t) pentru argumentul ctx_id. Re<?>ine<?>i, de asemenea, ca
       func<?>ia de invaluire libaio nu respecta conven<?>iile obi<?>nuite ale
       bibliotecii C pentru indicarea erorilor: in caz de eroare, aceasta
       returneaza un numar de eroare negat (negativul uneia dintre valorile
       enumerate in ERRORS). Daca apelul de sistem este invocat prin
       syscall(2), atunci valoarea de returnare urmeaza conven<?>iile
       obi<?>nuite pentru indicarea unei erori: -1, cu errno configurata la o
       valoare (pozitiva) care indica eroarea.

STANDARDE
       Linux.

ISTORIC
       Linux 2.5.

ERORI
       Un ctx_id nevalid poate cauza o eroare de segmentare in loc sa genereze
       eroarea EINVAL.

CONSULTA<?>I <?>I
       io_cancel(2), io_destroy(2), io_setup(2), io_submit(2), timespec(3),
       aio(7), time(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.15    17 mai 2025                  io_getevents(2)