sync_file_range(2)            System Calls Manual           sync_file_range(2)

NUME
       sync_file_range - sincronizeaza un segment de fi<?>ier cu discul

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #define _GNU_SOURCE         /* Consulta<?>i feature_test_macros(7) */
       #define _FILE_OFFSET_BITS 64
       #include <fcntl.h>

       int sync_file_range(int fd, off_t offset, off_t nbytes,
                           unsigned int flags);

DESCRIERE
       sync_file_range()  permite un control precis la sincronizarea
       fi<?>ierului deschis la care se refera descriptorul de fi<?>ier fd cu
       discul.

       offset este octetul de inceput al intervalului de fi<?>iere care
       urmeaza sa fie sincronizat. nbytes specifica lungimea intervalului care
       urmeaza sa fie sincronizat, in octe<?>i; daca nbytes este zero, atunci
       to<?>i octe<?>ii de la offset pana la sfar<?>itul fi<?>ierului sunt
       sincroniza<?>i. Sincronizarea se face in unita<?>i de dimensiune a
       paginii de sistem: offset este rotunjit in jos la limita paginii;
       (offset+nbytes-1) este rotunjit in sus la limita paginii.

       Argumentul masca de bi<?>i flags poate include oricare dintre
       urmatoarele valori:

       SYNC_FILE_RANGE_WAIT_BEFORE
              A<?>teapta scrierea tuturor paginilor din intervalul specificat
              care au fost deja trimise controlorului dispozitivului pentru
              scriere inainte de a efectua orice opera<?>ie de scriere.

       SYNC_FILE_RANGE_WRITE
              Ini<?>iaza scrierea tuturor paginilor murdare din intervalul
              specificat care nu sunt in prezent trimise pentru scriere.
              Re<?>ine<?>i ca chiar <?>i acest lucru poate bloca daca
              incerca<?>i sa scrie<?>i mai mult decat dimensiunea cozii de
              solicitari.

       SYNC_FILE_RANGE_WAIT_AFTER
              A<?>teapta scrierea tuturor paginilor din interval dupa
              efectuarea oricarei opera<?>ii de scriere.

       Specificarea flags ca 0 este permisa, ca o opera<?>ie fara efect.

   Aten<?>ie
       Acest apel de sistem este extrem de periculos <?>i nu trebuie utilizat
       in programe portabile. Niciuna dintre aceste opera<?>ii nu scrie
       metadatele fi<?>ierului. Prin urmare, cu excep<?>ia cazului in care
       aplica<?>ia efectueaza strict suprascrieri ale blocurilor de disc deja
       instan<?>iate, nu exista garan<?>ii ca datele vor fi disponibile dupa o
       blocare. Nu exista o interfa<?>a de utilizator care sa indice daca o
       scriere este pur <?>i simplu o suprascriere. Pe sistemele de fi<?>iere
       care utilizeaza semantica copiere la scriere (de exemplu, btrfs),
       suprascrierea blocurilor alocate existente este imposibila. Atunci cand
       se scrie in spa<?>iul prealocat, multe sisteme de fi<?>iere necesita,
       de asemenea, apeluri catre alocatorul de blocuri, pe care acest apel de
       sistem nu le sincronizeaza pe disc. Acest apel de sistem nu gole<?>te
       cache-urile de scriere pe disc <?>i, prin urmare, nu ofera nicio
       integritate a datelor pe sistemele cu cache-uri de scriere pe disc
       volatile.

   Cateva detalii
       SYNC_FILE_RANGE_WAIT_BEFORE <?>i SYNC_FILE_RANGE_WAIT_AFTER vor detecta
       orice erori de In/Ie<?> sau condi<?>ii ENOSPC <?>i le vor returna
       apelantului.

       Combina<?>ii utile ale bi<?>ilor flags sunt:

       SYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE
              Se asigura ca toate paginile din intervalul specificat care erau
              murdare cand a fost apelata func<?>ia sync_file_range()  sunt
              plasate sub scriere. Aceasta este o opera<?>ie de scriere
              ini<?>iala pentru integritatea datelor.

       SYNC_FILE_RANGE_WRITE
              Incepe scrierea tuturor paginilor murdare din intervalul
              specificat care nu sunt in prezent in curs de scriere. Aceasta
              este o operatie asincrona de golire pe disc. Aceasta nu este
              potrivita pentru opera<?>ii de integritate a datelor.

       SYNC_FILE_RANGE_WAIT_BEFORE (sau SYNC_FILE_RANGE_WAIT_AFTER)
              A<?>teapta finalizarea scrierii tuturor paginilor din intervalul
              specificat. Aceasta op<?>iune poate fi utilizata dupa o
              opera<?>ie anterioara SYNC_FILE_RANGE_WAIT_BEFORE |
              SYNC_FILE_RANGE_WRITE pentru a a<?>tepta finalizarea acelei
              opera<?>ii <?>i a ob<?>ine rezultatul acesteia.

       SYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE |
       SYNC_FILE_RANGE_WAIT_AFTER
              Aceasta este o opera<?>ie de scriere pentru integritatea datelor
              care va asigura ca toate paginile din intervalul specificat care
              erau murdare cand a fost apelata sync_file_range()  sunt salvate
              pe disc.

VALOAREA RETURNATA
       In caz de succes, sync_file_range()  returneaza 0; in caz de e<?>ec,
       returneaza -1 <?>i errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EBADF  descriptor-fi<?>ier nu este un descriptor de fi<?>ier valid.

       EINVAL flags specifica un bit nevalid; sau offset sau nbytes nu este
              valid.

       EIO    Eroare de In/Ie<?>.

       ENOMEM Memorie insuficienta.

       ENOSPC Spa<?>iu pe disc insuficient.

       ESPIPE fd se refera la altceva decat un fi<?>ier obi<?>nuit, un
              dispozitiv bloc sau un director.

VERSIUNI
   sync_file_range2()
       Unele arhitecturi (de exemplu, PowerPC, ARM) necesita ca argumentele pe
       64 de bi<?>i sa fie aliniate intr-o pereche adecvata de registre. Pe
       astfel de arhitecturi, semnatura apelului sync_file_range() prezentata
       in SINOPSIS ar for<?>a irosirea unui registru ca umplutura intre
       argumentele fd <?>i offset. (A se vedea syscall(2) pentru detalii.)
       Prin urmare, aceste arhitecturi definesc o apelare de sistem diferita
       care ordoneaza argumentele in mod adecvat:

           int sync_file_range2(int fd, unsigned int flags,
                                off_t offset, off_t nbytes);

       Comportamentul acestui apel de sistem este in rest identic cu cel al
       sync_file_range().

STANDARDE
       Linux.

ISTORIC
       Linux 2.6.17.

   sync_file_range2()
       Un apel de sistem cu aceasta semnatura a aparut pentru prima data pe
       arhitectura ARM in Linux 2.6.20, cu numele arm_sync_file_range(). A
       fost redenumit in Linux 2.6.22, cand a fost adaugat apelul de sistem
       analog pentru PowerPC.  Pe arhitecturile care ofera suport glibc, glibc
       incorporeaza in mod transparent sync_file_range2()  sub numele
       sync_file_range().

NOTE
       _FILE_OFFSET_BITS trebuie definit ca fiind 64 in codul care preia
       adresa sync_file_range, daca codul este destinat sa fie portabil pe
       platformele tradi<?>ionale x86 <?>i ARM pe 32 de bi<?>i, unde la<?>imea
       off_t este implicit de 32 de bi<?>i.

CONSULTA<?>I <?>I
       fdatasync(2), fsync(2), msync(2), sync(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.15    17 mai 2025               sync_file_range(2)