posix_fallocate(3)         Library Functions Manual         posix_fallocate(3)

NUME
       posix_fallocate - aloca spa<?>iu pentru fi<?>iere

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <fcntl.h>

       int posix_fallocate(int fd, off_t offset, off_t len);

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

       posix_fallocate():
           _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Func<?>ia posix_fallocate() asigura alocarea spa<?>iului pe disc pentru
       fi<?>ierul la care face referire descriptorul de fi<?>ier fd pentru
       octe<?>ii din intervalul care incepe la offset <?>i continua pentru len
       octe<?>i. Dupa un apel reu<?>it la posix_fallocate(), se garanteaza ca
       scrierile ulterioare pe octe<?>i din intervalul specificat nu vor
       e<?>ua din cauza lipsei de spa<?>iu pe disc.

       Daca dimensiunea fi<?>ierului este mai mica decat offset+len, atunci
       fi<?>ierul este marit la aceasta dimensiune; in caz contrar,
       dimensiunea fi<?>ierului este lasata neschimbata.

VALOAREA RETURNATA
       posix_fallocate() returneaza zero in caz de succes sau un numar de
       eroare in caz de e<?>ec. Re<?>ine<?>i ca errno nu este definita.

ERORI-IE<?>IRE
       EBADF  fd nu este un descriptor de fi<?>ier valid sau nu este deschis
              pentru scriere.

       EFBIG  offset+len depa<?>e<?>te dimensiunea maxima a fi<?>ierului.

       EINTR  Un semnal a fost captat in timpul execu<?>iei.

       EINVAL offset a fost mai mic decat 0, sau len a fost mai mic sau egal
              cu 0, sau sistemul de fi<?>iere subiacent nu accepta opera<?>ia.

       ENODEV fd nu se refera la un fi<?>ier obi<?>nuit.

       ENOSPC There is not enough space left on the device containing the file
              referred to by fd.

       EOPNOTSUPP
              Sistemul de fi<?>iere care con<?>ine fi<?>ierul la care se face
              referire prin fd nu accepta aceasta opera<?>ie.  Acest cod de
              eroare poate fi returnat de bibliotecile C care nu realizeaza
              emula<?>ia prezentata in NOTE, cum ar fi musl libc.

       ESPIPE fd se refera la o conducta.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +------------------+---------------------+-----------------------------+
       |Interfa<?>a       | Atribut             | Valoare                     |
       +------------------+---------------------+-----------------------------+
       |posix_fallocate() | Siguran<?>a firelor | MT-Safe (dar citi<?>i       |
       |                  |                     | sec<?>iunea NOTE)           |
       +------------------+---------------------+-----------------------------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.1.94. POSIX.1-2001

       POSIX.1-2008 spune ca o implementare trebuie sa dea eroarea EINVAL daca
       len a fost 0, sau offset a fost mai mic decat 0. POSIX.1-2001 spune ca
       o implementare trebuie sa dea eroarea EINVAL daca len este mai mic
       decat 0, sau offset a fost mai mic decat 0, <?>i poate sa dea eroarea
       daca len este egal cu zero.

AVERTISMENTE
       In implementarea glibc, posix_fallocate() este implementat utilizand
       apelul de sistem fallocate(2), care este sigur pentru MT. In cazul in
       care sistemul de fi<?>iere subiacent nu accepta fallocate(2), atunci
       opera<?>ia este emulata cu urmatoarele avertismente:

       o  Emula<?>ia este ineficienta.

       o  Exista o condi<?>ie de concuren<?>a in care scrierile simultane de
          la un alt fir sau proces ar putea fi suprascrise cu octe<?>i nuli.

       o  Exista o condi<?>ie de concuren<?>a in care cre<?>terile simultane
          ale dimensiunii fi<?>ierelor de catre un alt fir sau proces ar putea
          avea ca rezultat un fi<?>ier a carui dimensiune este mai mica decat
          cea a<?>teptata.

       o  Daca fd a fost deschis cu fanioanele O_APPEND sau O_WRONLY,
          func<?>ia e<?>ueaza cu eroarea EBADF.

       In general, emula<?>ia nu este sigura pentru MT. In Linux,
       aplica<?>iile pot utiliza fallocate(2) daca nu pot tolera
       avertismentele emula<?>iei. In general, acest lucru este recomandat
       numai daca aplica<?>ia inten<?>ioneaza sa incheie opera<?>ia in cazul
       in care se returneaza EOPNOTSUPP, altfel aplica<?>ia insa<?>i va trebui
       sa implementeze o solu<?>ie de rezerva cu acelea<?>i probleme ca <?>i
       emula<?>ia furnizata de glibc.

CONSULTA<?>I <?>I
       fallocate(1), fallocate(2), lseek(2), posix_fadvise(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 31 octombrie 2023            posix_fallocate(3)