write(2)                      System Calls Manual                     write(2)

NUME
       write - scrie intr-un descriptor de fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

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

DESCRIERE
       write() scrie pana la count octe<?>i din memoria tampon care incepe la
       buf in fi<?>ierul la care se face referire prin descriptorul de
       fi<?>ier fd.

       Numarul de octe<?>i scri<?>i poate fi mai mic decat count daca, de
       exemplu, nu exista spa<?>iu suficient pe suportul fizic subiacent, daca
       este intalnita limita de resurse RLIMIT_FSIZE (a se vedea setrlimit(2))
       sau daca apelul a fost intrerupt de un gestionar de semnal dupa ce a
       scris mai pu<?>in de count octe<?>i. A se vedea <?>i pipe(7).

       Pentru un fi<?>ier care poate fi cautat (adica unul caruia i se poate
       aplica lseek(2), de exemplu, un fi<?>ier obi<?>nuit), scrierea are loc
       la pozi<?>ia fi<?>ierului, iar pozi<?>ia fi<?>ierului este incrementata
       cu numarul de octe<?>i scri<?>i efectiv. In cazul in care fi<?>ierul a
       fost deschis cu open(2) O_APPEND, pozi<?>ia fi<?>ierului este mai intai
       stabilita la sfar<?>itul fi<?>ierului inainte de scriere. Ajustarea
       decalajului fi<?>ierului <?>i opera<?>ia de scriere sunt efectuate ca
       un pas atomic.

       POSIX stipuleaza ca un read(2) despre care se poate dovedi ca apare
       dupa ce un write() a fost returnat va returna noile date. Re<?>ine<?>i
       ca nu toate sistemele de fi<?>iere sunt conforme cu POSIX.

       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, este returnat numarul de octe<?>i scri<?>i. In caz de
       eroare, este returnat -1, iar errno este configurata pentru a indica
       eroarea.

       Re<?>ine<?>i ca o opera<?>ie write() reu<?>ita poate transfera mai
       pu<?>in de count octe<?>i. Astfel de scrieri par<?>iale pot avea loc
       din diverse motive; de exemplu, pentru ca nu a existat spa<?>iu
       suficient pe dispozitivul de disc pentru a scrie to<?>i octe<?>ii
       solicita<?>i sau pentru ca un apel write() blocat catre un soclu,
       conducta sau similar a fost intrerupt de un gestionar de semnal dupa ce
       a transferat o parte, dar inainte de a transfera to<?>i octe<?>ii
       solicita<?>i. In cazul unei scrierii par<?>iale, apelantul poate
       efectua un alt apel write() pentru a transfera octe<?>ii rama<?>i.
       Apelul ulterior fie va transfera al<?>i octe<?>i, fie poate duce la o
       eroare (de exemplu, daca discul este acum plin).

       Daca count este zero <?>i fd se refera la un fi<?>ier obi<?>nuit,
       atunci write() poate returna o stare de e<?>ec daca este detectata una
       dintre erorile de mai jos. Daca nu sunt detectate erori sau daca
       detectarea erorilor nu este efectuata, se returneaza 0 fara a provoca
       alte efecte. Daca count este zero <?>i fd se refera la un alt fi<?>ier
       decat un fi<?>ier obi<?>nuit, rezultatele nu sunt specificate.

ERORI-IE<?>IRE
       EAGAIN Descriptorul de fi<?>ier fd se refera la un alt fi<?>ier decat
              un soclu <?>i a fost marcat ca fiind fara blocare (O_NONBLOCK),
              iar scrierea s-ar bloca. Consulta<?>i 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 fara blocare (O_NONBLOCK), iar scrierea s-ar
              bloca. POSIX.1-2001 permite returnarea oricarei erori in acest
              caz <?>i nu solicita 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 scriere.

       EDESTADDRREQ
              fd se refera la o priza de datagrama pentru care nu a fost
              definita o adresa de ma<?>ina partener folosind connect(2).

       EDQUOT Cota utilizatorului de blocuri de disc pe sistemul de fi<?>iere
              care con<?>ine fi<?>ierul men<?>ionat de fd a fost epuizata.

       EFAULT buf se afla in afara spa<?>iului dvs. de adrese accesibil.

       EFBIG  S-a incercat scrierea unui fi<?>ier care depa<?>e<?>te
              dimensiunea maxima a fi<?>ierului definita de implementare sau
              limita de dimensiune a fi<?>ierului procesului sau scrierea la o
              pozi<?>ie care depa<?>e<?>te decalajul maxim permis.

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

       EINVAL fd este ata<?>at unui obiect care nu este adecvat pentru
              scriere; sau fi<?>ierul a fost deschis cu fanionul O_DIRECT, iar
              adresa specificata in buf, valoarea specificata in count sau
              pozi<?>ia fi<?>ierului nu este aliniata corespunzator.

       EIO    S-a produs o eroare I/O de nivel scazut in timpul modificarii
              nodului-i. Aceasta eroare poate fi legata de scrierea inapoi
              (write-back) a datelor scrise de o opera<?>ie write()
              anterioara, care poate sa fi fost emisa catre un descriptor de
              fi<?>ier diferit pe acela<?>i fi<?>ier. Incepand cu Linux 4.13,
              erorile de la write-back vin cu promisiunea ca acestea pot fi
              raportate de urmatoarele. write(), <?>i will sa fie raportate de
              o cerere ulterioara fsync(2) (indiferent daca au fost sau nu
              raportate <?>i de write()). O alta cauza a EIO pe sistemele de
              fi<?>iere in re<?>ea este atunci cand un blocaj consultativ a
              fost luat pe descriptorul de fi<?>ier <?>i acest blocaj a fost
              pierdut. Consulta<?>i sec<?>iunea Blocari pierdute din fcntl(2)
              pentru detalii suplimentare.

       ENOSPC Dispozitivul care con<?>ine fi<?>ierul la care se face referire
              prin fd nu are spa<?>iu pentru date.

       EPERM  Opera<?>ia a fost impiedicata de o sigilare de fi<?>ier; a se
              vedea fcntl(2).

       EPIPE  fd este conectat la o conducta sau un soclu al carui capat de
              citire este inchis.  Atunci cand acest lucru se intampla,
              procesul de scriere va primi <?>i un semnal SIGPIPE; (astfel,
              valoarea de returnare a scrierii este vazuta numai daca
              programul capteaza, blocheaza sau ignora acest semnal).

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

STANDARDE
       POSIX.1-2008.

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

       Sub SVr4, o scriere poate fi intrerupta <?>i se poate returna EINTR in
       orice moment, nu doar inainte ca datele sa fie scrise.

NOTE
       O returnare cu succes de la write() nu garanteaza in niciun fel ca
       datele au fost stocate pe disc. Pe unele sisteme de fi<?>iere, inclusiv
       NFS, nu garanteaza nici macar ca spa<?>iul a fost rezervat cu succes
       pentru date. In acest caz, unele erori pot fi amanate pana la o
       viitoare opera<?>ie write(), fsync(2) sau chiar close(2). Singura
       modalitate de a fi siguri este sa apela<?>i fsync(2) dupa ce a<?>i
       terminat de scris toate datele.

       Daca o opera<?>ie write() este intrerupta de un gestionar de semnal
       inainte de scrierea oricarui octet, apelul e<?>ueaza cu eroarea EINTR;
       daca este intrerupt dupa scrierea a cel pu<?>in un octet, apelul
       reu<?>e<?>te <?>i returneaza numarul de octe<?>i scri<?>i.

       Pe Linux, write() (<?>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).

       O valoare returnata de eroare in timpul executarii write() folosind I/O
       direct nu inseamna ca intreaga scriere a e<?>uat. Se pot scrie date
       par<?>iale, iar datele de la pozi<?>ia fi<?>ierului pe care s-a
       incercat write() trebuie considerate inconsistente.

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 sunt write() <?>i writev(2). Iar
       printre efectele care ar trebui sa fie atomice intre fire (<?>i
       procese) se numara actualizarile pozi<?>iei fi<?>ierului.  Cu toate
       acestea, inainte de Linux 3.14, acest lucru nu se intampla: daca doua
       procese care impart o descriere de fi<?>ier deschis (a se vedea
       open(2)) efectueaza o opera<?>ie write() (sau writev(2)) in acela<?>i
       timp, atunci opera<?>iile I/O nu erau atomice in ceea ce prive<?>te
       actualizarea pozi<?>iei fi<?>ierului, avand ca rezultat suprapunerea
       (incorecta) a blocurilor de date emise de cele doua procese. Aceasta
       problema a fost rezolvata in Linux 3.14.

CONSULTA<?>I <?>I
       close(2), fcntl(2), fsync(2), ioctl(2), lseek(2), open(2), pwrite(2),
       read(2), select(2), writev(2), fwrite(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.9.1   2 mai 2024                          write(2)