sendfile(2)                   System Calls Manual                  sendfile(2)

NUME
       sendfile - transfera date intre descriptori de fi<?>iere

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <sys/sendfile.h>

       ssize_t sendfile(int out_fd, int in_fd, off_t *_Nullable offset,
                        size_t count);

DESCRIERE
       sendfile() copiaza date intre un descriptor de fi<?>ier <?>i altul.
       Deoarece aceasta copiere se face in interiorul nucleului, sendfile()
       este mai eficient decat combina<?>ia dintre read(2) <?>i write(2), care
       ar necesita transferul de date catre <?>i din spa<?>iul utilizatorului.

       in_fd trebuie sa fie un descriptor de fi<?>ier deschis pentru citire,
       iar out_fd trebuie sa fie un descriptor deschis pentru scriere.

       Daca offset nu este NULL, atunci indica o variabila care con<?>ine
       pozi<?>ia fi<?>ierului de la care sendfile() va incepe sa citeasca
       datele din in_fd. La returnarea lui sendfile(), aceasta variabila va fi
       stabilita la pozi<?>ia octetului care urmeaza ultimului octet citit.
       Daca offset nu este NULL, atunci sendfile() nu modifica pozi<?>ia in
       fi<?>ier a lui in_fd; in caz contrar, pozi<?>ia in fi<?>ier este
       ajustata pentru a reflecta numarul de octe<?>i citi<?>i din in_fd.

       Daca offset este NULL, atunci datele vor fi citite din in_fd incepand
       de la pozi<?>ia fi<?>ierului, iar pozi<?>ia fi<?>ierului va fi
       actualizata de apel.

       count este numarul de octe<?>i care trebuie copia<?>i intre
       descriptorii de fi<?>iere.

       Argumentul in_fd trebuie sa corespunda unui fi<?>ier care accepta
       opera<?>ii de tip mmap(2) (adica nu poate fi un soclu). Mai pu<?>in
       incepand cu Linux 5.12 <?>i daca out_fd este o conducta, caz in care
       sendfile() se transforma in splice(2) <?>i se aplica restric<?>iile
       sale.

       Inainte de Linux 2.6.33, out_fd trebuie sa se refere la un soclu.
       Incepand cu Linux 2.6.33, poate fi vorba de orice fi<?>ier. Daca acesta
       este explorabil, atunci sendfile() modifica in mod corespunzator
       pozi<?>ia fi<?>ierului.

VALOAREA RETURNATA
       In cazul in care transferul a avut succes, se returneaza numarul de
       octe<?>i scri<?>i in out_fd. Re<?>ine<?>i ca un apel reu<?>it la
       sendfile() poate scrie mai pu<?>ini octe<?>i decat cei solicita<?>i;
       apelantul trebuie sa fie pregatit sa reia apelul in cazul in care
       exista octe<?>i care nu au fost trimi<?>i. A se vedea, de asemenea,
       sec<?>iunea NOTE.

       In caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

ERORI-IE<?>IRE
       EAGAIN Ie<?>irea/ie<?>irea fara blocare a fost selectata folosind
              O_NONBLOCK <?>i scrierea s-ar bloca.

       EBADF  Fi<?>ierul de intrare nu a fost deschis pentru citire sau
              fi<?>ierul de ie<?>ire nu a fost deschis pentru scriere.

       EFAULT Adresa incorecta.

       EINVAL Descriptorul nu este valid sau blocat, sau o opera<?>ie de tip
              mmap(2) nu este disponibila pentru in_fd, sau count este
              negativ.

       EINVAL out_fd are activat fanionul O_APPEND. In prezent, acest lucru nu
              este acceptat de sendfile().

       EIO    Eroare nespecificata in timpul citirii din in_fd.

       ENOMEM Memorie insuficienta pentru a citi din in_fd.

       EOVERFLOW
              count este prea mare, opera<?>ia ar duce la depa<?>irea
              dimensiunii maxime a fi<?>ierului de intrare sau a fi<?>ierului
              de ie<?>ire.

       ESPIPE offset nu este NULL, dar fi<?>ierul de intrare nu poate fi
              explorat.

VERSIUNI
       Alte sisteme UNIX implementeaza sendfile() cu o semantica <?>i
       prototipuri diferite. Acesta nu ar trebui sa fie utilizat in programele
       portabile.

STANDARDE
       Niciunul.

ISTORIC
       Linux 2.2, glibc 2.1.

       In Linux 2.4 <?>i versiunile anterioare, out_fd se putea referi, de
       asemenea, la un fi<?>ier obi<?>nuit; aceasta posibilitate a disparut in
       seria de nuclee Linux 2.6.x, dar a fost restabilita in Linux 2.6.33.

       Apelul de sistem original Linux sendfile() nu a fost conceput pentru a
       gestiona pozi<?>ii din fi<?>iere mari. In consecin<?>a, Linux 2.4 a
       adaugat sendfile64(), cu un tip mai larg pentru argumentul offset.
       Func<?>ia de invaluire glibc sendfile() se ocupa in mod transparent de
       diferen<?>ele din nucleu.

NOTE
       sendfile() 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).

       Daca inten<?>iona<?>i sa utiliza<?>i sendfile() pentru a trimite
       fi<?>iere catre un soclu TCP, dar trebuie sa trimite<?>i unele date de
       antet inainte de con<?>inutul fi<?>ierului, ve<?>i gasi utila
       utilizarea op<?>iunii TCP_CORK, descrisa in tcp(7), pentru a minimiza
       numarul de pachete <?>i pentru a regla performan<?>a.

       Este posibil ca aplica<?>iile sa doreasca sa revina la read(2) <?>i
       write(2) in cazul in care sendfile() e<?>ueaza cu EINVAL sau ENOSYS.

       In cazul in care out_fd se refera la un soclu sau la o conducta cu
       suport de copiere zero, apelan<?>ii trebuie sa se asigure ca
       por<?>iunile transferate din fi<?>ierul la care face referire in_fd
       raman nemodificate pana cand cititorul de la celalalt capat al out_fd a
       consumat datele transferate.

       Apelul splice(2), specific Linux, permite transferul de date intre
       descriptori de fi<?>iere arbitrari, cu condi<?>ia ca unul (sau amandoi)
       dintre ei sa fie o conducta.

CONSULTA<?>I <?>I
       copy_file_range(2), mmap(2), open(2), socket(2), splice(2)

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 21 decembrie 2023                   sendfile(2)