read(2)                       System Calls Manual                      read(2)

NUME
       read - cite<?>te dintr-un descriptor de fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <unistd.h>

       ssize_t read(int fd, void buf[.count], size_t count);

DESCRIERE
       read() incearca sa citeasca pana la count octe<?>i din descriptorul de
       fi<?>ier fd in memoria tampon care incepe la buf.

       In cazul fi<?>ierelor care accepta cautarea, opera<?>ia de citire
       incepe de la pozi<?>ia fi<?>ierului, iar pozi<?>ia fi<?>ierului este
       incrementata cu numarul de octe<?>i citi<?>i. In cazul in care
       pozi<?>ia fi<?>ierului se afla la sau dupa sfar<?>itul fi<?>ierului, nu
       se cite<?>te niciun octet, iar read() returneaza zero.

       Daca count este zero, read() poate detecta erorile descrise mai jos.
       In absen<?>a oricaror erori sau daca read() nu verifica daca exista
       erori, o citire read() cu count de 0 returneaza zero <?>i nu are alte
       efecte.

       In conformitate cu POSIX.1, daca count este mai mare decat SSIZE_MAX,
       rezultatul este definit de implementare; a se vedea NOTE pentru limita
       superioara in Linux.

VALOAREA RETURNATA
       In caz de succes, se returneaza numarul de octe<?>i citi<?>i (zero
       indica sfar<?>itul fi<?>ierului), iar pozi<?>ia fi<?>ierului este
       avansata cu acest numar. Nu este o eroare daca acest numar este mai mic
       decat numarul de octe<?>i cerut; acest lucru se poate intampla, de
       exemplu, pentru ca sunt disponibili mai pu<?>ini octe<?>i in acest
       moment (poate pentru ca am fost aproape de sfar<?>itul fi<?>ierului,
       pentru ca citim dintr-o conducta sau de la un terminal) sau pentru ca
       read() a fost intrerupt de un semnal. A se vedea, de asemenea,
       sec<?>iunea NOTE.

       In caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea. In acest caz, nu se specifica daca pozi<?>ia
       fi<?>ierului (daca exista) se modifica.

ERORI-IE<?>IRE
       EAGAIN Descriptorul de fi<?>ier fd se refera la un fi<?>ier, altul
              decat un soclu, <?>i a fost marcat ca neblocat (O_NONBLOCK), iar
              citirea ar trebui sa fie blocata. A se vedea open(2) pentru mai
              multe detalii privind marcajul O_NONBLOCK.

       EAGAIN sau EWOULDBLOCK
              Descriptorul de fi<?>ier fd se refera la un soclu <?>i a fost
              marcat ca fiind neblocat (O_NONBLOCK), iar citirea ar trebui sa
              fie blocata. POSIX.1-2001 permite returnarea oricarei erori in
              acest caz <?>i nu impune ca aceste constante sa aiba aceea<?>i
              valoare, astfel incat o aplica<?>ie portabila ar trebui sa
              verifice ambele posibilita<?>i.

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

       EFAULT memoria-tampon se afla in afara spa<?>iului dvs. de adrese
              accesibil.

       EINTR  Apelul a fost intrerupt de un semnal inainte ca datele sa fie
              citite; a se vedea signal(7).

       EINVAL fd este ata<?>at la un obiect care nu este adecvat pentru
              citire; sau fi<?>ierul a fost deschis cu fanionul O_DIRECT <?>i
              fie adresa specificata in buf, fie valoarea specificata in
              count, fie decalajul fi<?>ierului nu este aliniat corespunzator.

       EINVAL fd a fost creat printr-un apel la timerfd_create(2) <?>i o
              dimensiune gre<?>ita a memoriei tampon a fost furnizata lui
              read(); a se vedea timerfd_create(2) pentru informa<?>ii
              suplimentare.

       EIO    Eroare de In/Ie<?>. Acest lucru se va intampla, de exemplu,
              atunci cand procesul se afla intr-un grup de procese in fundal,
              incearca sa citeasca de la terminalul sau de control <?>i fie
              ignora sau blocheaza SIGTTIN, fie grupul sau de procese este
              orfan. Poate aparea, de asemenea, atunci cand exista o eroare de
              intrare/ie<?>ire de nivel scazut in timpul citirii de pe un disc
              sau de pe o banda. O alta cauza posibila a apari<?>iei EIO pe
              sistemele de fi<?>iere in re<?>ea este atunci cand a fost luat
              un blocaj consultativ pe descriptorul de fi<?>ier <?>i aceasta
              blocare a fost pierduta. Consulta<?>i sec<?>iunea Locuri
              pierdute din fcntl(2) pentru mai multe detalii.

       EISDIR fd se refera la un director.

       Pot aparea <?>i alte erori, in func<?>ie de obiectul conectat la fd.

STANDARDE
       POSIX.1-2008.

ISTORIC
       SVr4, 4.3BSD, POSIX.1-2001.

NOTE
       In Linux, read() (<?>i apelurile de sistem similare) va transfera cel
       mult 0x7ffff000 (2.147.479.552) octe<?>i, returnand numarul de octe<?>i
       transfera<?>i efectiv; (acest lucru este valabil atat pe sistemele pe
       32 de bi<?>i, cat <?>i pe cele pe 64 de bi<?>i).

       In cazul sistemelor de fi<?>iere NFS, citirea unor cantita<?>i mici de
       date va actualiza marca temporala numai prima data, iar apelurile
       ulterioare pot sa nu faca acest lucru. Acest lucru este cauzat de
       memoria cache a atributelor din partea clientului, deoarece
       majoritatea, daca nu chiar to<?>i clien<?>ii NFS lasa actualizarile
       st_atime (ultima ora de acces la fi<?>ier) la server, iar citirile din
       partea clientului satisfacute din memoria cache a clientului nu vor
       cauza actualizari st_atime pe server, deoarece nu exista citiri pe
       partea serverului. Semantica UNIX poate fi ob<?>inuta prin dezactivarea
       memorarii in cache a atributelor pe partea clientului, dar in
       majoritatea situa<?>iilor acest lucru va cre<?>te substan<?>ial sarcina
       serverului <?>i va scadea performan<?>a.

ERORI
       In conformitate cu POSIX.1-2008/SUSv4 sec<?>iunea XSI 2.9.7
       (,,Interac<?>iuni ale firelor de execu<?>ie cu opera<?>iile
       fi<?>ierelor obi<?>nuite"):

           Toate func<?>iile urmatoare trebuie sa fie atomice una fa<?>a de
           cealalta in efectele specificate in POSIX.1-2008 atunci cand
           opereaza cu fi<?>iere obi<?>nuite sau legaturi simbolice: ...

       Printre API-urile enumerate ulterior se numara read() <?>i readv(2).
       Iar printre efectele care ar trebui sa fie atomice intre fire de
       execu<?>ie (<?>i procese) se numara actualizarile pozi<?>iei
       fi<?>ierului. Cu toate acestea, inainte de Linux 3.14, acest lucru nu
       era valabil: daca doua procese care impart o descriere de fi<?>ier
       deschis (a se vedea open(2)) efectuau un read() (sau readv(2)) in
       acela<?>i timp, atunci opera<?>iile de In/Ie<?> nu erau atomice in ceea
       ce prive<?>te actualizarea pozi<?>iei fi<?>ierului, cu rezultatul ca
       citirile din cele doua procese se puteau suprapune (in mod incorect) in
       blocurile de date pe care le ob<?>ineau. Aceasta problema a fost
       rezolvata in Linux 3.14.

CONSULTA<?>I <?>I
       close(2), fcntl(2), ioctl(2), lseek(2), open(2), pread(2), readdir(2),
       readlink(2), readv(2), select(2), write(2), fread(3)

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                       read(2)