posix_fadvise(2)              System Calls Manual             posix_fadvise(2)

NUME
       posix_fadvise - predeclara un model de acces pentru datele din
       fi<?>iere

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <fcntl.h>

       int posix_fadvise(int fd, off_t offset, off_t size, int advice);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       posix_fadvise():
           _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Programele pot utiliza posix_fadvise() pentru a anun<?>a inten<?>ia de
       a accesa in viitor datele unui fi<?>ier dupa un anumit model,
       permi<?>and astfel nucleului sa efectueze optimizarile corespunzatoare.

       Argumentul advice se aplica unei regiuni (care nu exista neaparat) care
       incepe la offset <?>i se intinde pe size octe<?>i (sau pana la
       sfar<?>itul fi<?>ierului daca size este 0) in cadrul fi<?>ierului la
       care se face referire prin fd. advice nu este obligatoriu; acesta
       constituie doar o a<?>teptare din partea aplica<?>iei.

       Valorile admise pentru advice includ:

       POSIX_FADV_NORMAL
              Indica faptul ca aplica<?>ia nu are nici o indica<?>ie ,,advice"
              de dat cu privire la modelul sau de acces pentru datele
              specificate.  In cazul in care nu se ofera niciun sfat pentru un
              fi<?>ier deschis, aceasta este presupunerea implicita.

       POSIX_FADV_SEQUENTIAL
              Aplica<?>ia se a<?>teapta sa acceseze datele specificate in mod
              secven<?>ial (cu citirea pozi<?>iilor inferioare inaintea celor
              superioare).

       POSIX_FADV_RANDOM
              Datele specificate vor fi accesate in ordine aleatorie.

       POSIX_FADV_NOREUSE
              Datele specificate vor fi accesate o singura data.

              Inainte de Linux 2.6.18, POSIX_FADV_NOREUSE avea aceea<?>i
              semantica ca POSIX_FADV_WILLNEED. Aceasta a fost probabil o
              eroare; de la Linux 2.6.18 pana la Linux 6.2, acest fanion a
              fost un no-op. Incepand cu Linux 6.3, POSIX_FADV_NOREUSE
              semnaleaza faptul ca algoritmul de inlocuire a paginilor din
              nucleu poate ignora accesul la memoria cache a paginilor
              cartografiate marcate de acest fanion. Acest lucru este util, de
              exemplu, in timpul transmiterii de fi<?>iere mari.

       POSIX_FADV_WILLNEED
              Datele specificate vor fi accesate in viitorul apropiat.

              POSIX_FADV_WILLNEED ini<?>iaza o citire fara blocaj a regiunii
              specificate in memoria cache de pagina. Cantitatea de date
              citite poate fi diminuata de catre nucleu in func<?>ie de
              incarcarea memoriei virtuale; (ca<?>iva megaocte<?>i vor fi de
              obicei pe deplin satisfacatori, iar mai mult este rareori util).

       POSIX_FADV_DONTNEED
              Datele specificate nu vor fi accesate in viitorul apropiat.

              POSIX_FADV_DONTNEED incearca sa elibereze paginile din memoria
              cache asociate cu regiunea specificata. Acest lucru este util,
              de exemplu, in timpul transmiterii in flux a fi<?>ierelor mari.
              Un program poate solicita periodic nucleului sa elibereze datele
              din memoria cache care au fost deja utilizate, astfel incat
              paginile mai utile din memoria cache sa nu fie eliminate in
              schimb.

              Solicitarile de eliminare a paginilor par<?>iale sunt ignorate.
              Este preferabil sa se pastreze datele necesare decat sa se
              renun<?>e la datele inutile. Daca aplica<?>ia cere ca datele sa
              fie luate in considerare pentru a fi eliminate, atunci offset
              <?>i size trebuie sa fie aliniate la pagina.

              Implementarea poate incerca sa scrie inapoi paginile ,,murdare"
              (scrise par<?>ial) din regiunea specificata, dar acest lucru nu
              este garantat. Toate paginile ,,murdare" nescrise nu vor fi
              eliberate. Daca aplica<?>ia dore<?>te sa se asigure ca paginile
              ,,murdare" vor fi eliberate, trebuie sa apeleze mai intai
              fsync(2) sau fdatasync(2).

VALOAREA RETURNATA
       In caz de succes, se returneaza zero. In caz de eroare, se returneaza
       un numar de eroare.

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

       EINVAL A fost specificata o valoare nevalida pentru advice.

       ESPIPE Descriptorul de fi<?>ier specificat se refera la o conducta sau
              FIFO; (ESPIPE este eroarea specificata de POSIX, dar inainte de
              Linux 2.6.16, Linux a returnat EINVAL in acest caz).

VERSIUNI
       In Linux, POSIX_FADV_NORMAL stabile<?>te fereastra de citire-anticipata
       la dimensiunea implicita pentru dispozitivul de rezerva;
       POSIX_FADV_SEQUENTIAL dubleaza aceasta dimensiune, iar
       POSIX_FADV_RANDOM dezactiveaza complet citire-anticipata a
       fi<?>ierelor. POSIX_FADV_NOREUSE nu modifica dimensiunea ferestrei de
       citire-anticipata. Aceste modificari afecteaza intregul fi<?>ier, nu
       doar regiunea specificata (dar alte gestionare de fi<?>ier deschise
       pentru acela<?>i fi<?>ier nu sunt afectate).

   Diferen<?>e intre biblioteca C <?>i nucleu
       Numele func<?>iei de invaluire din biblioteca C este posix_fadvise().
       Apelul de sistem subiacent se nume<?>te fadvise64() (sau, pe unele
       arhitecturi, fadvise64_64()); diferen<?>a dintre cele doua este ca
       primul apel de sistem presupune ca tipul argumentului size este size_t,
       in timp ce al doilea se a<?>teapta la loff_t.

   Variante specifice arhitecturii
       Unele arhitecturi necesita ca argumentele pe 64 de bi<?>i sa fie
       aliniate intr-o pereche adecvata de registre (a se vedea syscall(2)
       pentru mai multe detalii). Pe astfel de arhitecturi, semnatura de
       apelare a posix_fadvise() prezentata in SINOPSIS ar for<?>a irosirea
       unui registru ca umplutura intre argumentele fd <?>i offset. Prin
       urmare, aceste arhitecturi definesc o versiune a apelului de sistem
       care ordoneaza in mod corespunzator argumentele, dar care, in rest,
       este exact la fel ca posix_fadvise().

       De exemplu, incepand cu Linux 2.6.14, ARM are urmatorul apel de sistem:

           long arm_fadvise64_64(int fd, int advice,
                                 loff_t offset, loff_t size);

       Aceste detalii specifice arhitecturii sunt, in general, ascunse
       aplica<?>iilor de catre func<?>ia de invaluire glibc posix_fadvise(),
       care invoca apelul de sistem specific arhitecturii corespunzatoare.

STANDARDE
       POSIX.1-2024.

ISTORIC
       POSIX.1-2001.

       Suportul pentru nucleu a aparut pentru prima data in Linux 2.5.60;
       apelul de sistem subiacent se nume<?>te fadvise64(). Suportul pentru
       biblioteca a fost furnizat incepand cu glibc 2.2, prin intermediul
       func<?>iei de invaluire posix_fadvise().

       Incepand cu Linux 3.18, suportul pentru apelul de sistem subiacent este
       op<?>ional, in func<?>ie de valoarea op<?>iunii de configurare
       CONFIG_ADVISE_SYSCALLS.

       Tipul argumentului size a fost schimbat din size_t in off_t in
       POSIX.1-2001 TC1.

NOTE
       Con<?>inutul cache-ului tampon al nucleului poate fi <?>ters prin
       intermediul interfe<?>ei /proc/sys/vm/drop_caches descrisa in proc(5).

       Se poate ob<?>ine o imagine instantanee a paginilor dintr-un fi<?>ier
       care se afla in memoria cache tampon deschizand un fi<?>ier,
       cartografiindu-l cu mmap(2) <?>i apoi aplicand mincore(2) la
       cartografiere.

ERORI
       Inainte de Linux 2.6.6, daca lsize era specificat ca fiind 0, atunci
       acest lucru era interpretat literal ca fiind ,,zero octe<?>i", in loc
       sa insemne ,,to<?>i octe<?>ii pana la sfar<?>itul fi<?>ierului".

CONSULTA<?>I <?>I
       fincore(1), mincore(2), readahead(2), sync_file_range(2),
       posix_fallocate(3), posix_madvise(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.17 8 februarie 2026               posix_fadvise(2)