truncate(2)                   System Calls Manual                  truncate(2)

NUME
       truncate, ftruncate - trunchiaza un fi<?>ier la o lungime specificata

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

       int truncate(const char *path, off_t length);
       int ftruncate(int fd, off_t length);

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

       truncate():
           _XOPEN_SOURCE >= 500
               || /* Incepand cu glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
               || /* glibc <= 2.19: */ _BSD_SOURCE

       ftruncate():
           _XOPEN_SOURCE >= 500
               || /* incepand cu glibc 2.3.5: */ _POSIX_C_SOURCE >= 200112L
               || /* glibc <= 2.19: */ _BSD_SOURCE

DESCRIERE
       Func<?>iile truncate() <?>i ftruncate() fac ca fi<?>ierul obi<?>nuit
       numit de path sau la care face referire fd sa fie trunchiat la o
       dimensiune de exact length octe<?>i.

       Daca fi<?>ierul a fost anterior mai mare decat aceasta dimensiune,
       datele suplimentare sunt pierdute.  Daca fi<?>ierul a fost anterior mai
       scurt, acesta este extins, iar partea extinsa este citita ca octe<?>i
       nuli (,,\0").

       Indicatorul de pozi<?>ie al fi<?>ierului nu este modificat.

       Daca dimensiunea s-a modificat, campurile st_ctime <?>i st_mtime
       (respectiv, ora ultimei schimbari de stare <?>i ora ultimei modificari;
       a se vedea inode(7)) pentru fi<?>ier sunt actualizate, iar bi<?>ii de
       mod set-user-ID <?>i set-group-ID pot fi <?>ter<?>i.

       Cu ftruncate(), fi<?>ierul trebuie sa fie deschis pentru scriere; cu
       truncate(), fi<?>ierul trebuie sa poata fi scris.

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

ERORI-IE<?>IRE
       Pentru truncate():

       EACCES Permisiunea de cautare este refuzata pentru o componenta a
              prefixului rutei, sau fi<?>ierul numit nu poate fi scris de
              catre utilizator; (a se vedea <?>i path_resolution(7).)

       EFAULT Argumentul path indica in afara spa<?>iului de adrese alocat
              procesului.

       EFBIG  Argumentul length este mai mare decat dimensiunea maxima a
              fi<?>ierului. (XSI)

       EINTR  In timp ce era blocat in a<?>teptarea finalizarii, apelul a fost
              intrerupt de un gestionar de semnal; a se vedea fcntl(2) <?>i
              signal(7).

       EINVAL Argumentul length este negativ sau mai mare decat dimensiunea
              maxima a fi<?>ierului.

       EIO    A aparut o eroare de In/Ie<?> la actualizarea nodului-i.

       EISDIR Fi<?>ierul numit este un director.

       ELOOP  S-au intalnit prea multe legaturi simbolice la conversia numelui
              de ruta.

       ENAMETOOLONG
              O componenta a unui nume de ruta a depa<?>it 255 de caractere
              sau un nume de ruta intreg a depa<?>it 1023 de caractere.

       ENOENT Fi<?>ierul numit nu exista.

       ENOTDIR
              O componenta a prefixului de ruta nu este un director.

       EPERM  Sistemul de fi<?>iere subiacent nu accepta extinderea unui
              fi<?>ier dincolo de dimensiunea sa curenta.

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

       EROFS  Fi<?>ierul numit se afla pe un sistem de fi<?>iere
              numai-pentru-citire.

       ETXTBSY
              Fi<?>ierul este un fi<?>ier executabil care este in curs de
              execu<?>ie.

       Pentru ftruncate() se aplica acelea<?>i erori, dar in loc de lucruri
       care pot fi gre<?>ite cu path, avem acum lucruri care pot fi gre<?>ite
       cu descriptorul de fi<?>ier, fd:

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

       EBADF sau EINVAL
              fd nu este deschis pentru scriere.

       EINVAL fd nu face referire la un fi<?>ier obi<?>nuit sau la un obiect
              de memorie partajata POSIX.

       EINVAL sau EBADF
              Descriptorul de fi<?>ier fd nu este deschis pentru scriere.
              POSIX permite, iar aplica<?>iile portabile ar trebui sa
              gestioneze, ambele erori pentru acest caz; (Linux produce
              EINVAL).

VERSIUNI
       Detaliile din DESCRIERE sunt pentru sistemele compatibile XSI.  Pentru
       sistemele neconforme cu XSI, standardul POSIX permite doua
       comportamente pentru ftruncate() atunci cand length depa<?>e<?>te
       lungimea fi<?>ierului (re<?>ine<?>i ca truncate() nu este specificata
       deloc intr-un astfel de mediu): fie returnarea unei erori, fie
       extinderea fi<?>ierului. Ca majoritatea implementarilor UNIX, Linux
       respecta cerin<?>a XSI atunci cand are de-a face cu sisteme de
       fi<?>iere native. Cu toate acestea, unele sisteme de fi<?>iere
       non-native nu permit ca truncate() <?>i ftruncate() sa fie utilizate
       pentru a extinde un fi<?>ier dincolo de lungimea sa curenta: un exemplu
       notabil pe Linux este VFAT.

       Pe unele arhitecturi pe 32 de bi<?>i, semnatura de apelare pentru
       aceste apeluri de sistem difera, din motivele descrise in syscall(2).

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, 4.4BSD, SVr4 (a aparut prima data in 4.2BSD).

       Apelurile de sistem originale Linux truncate() <?>i ftruncate() nu au
       fost concepute pentru a gestiona decalaje de fi<?>iere mari. In
       consecin<?>a, Linux 2.4 a adaugat apelurile de sistem truncate64() <?>i
       ftruncate64() care gestioneaza fi<?>iere mari. Cu toate acestea, aceste
       detalii pot fi ignorate de aplica<?>iile care utilizeaza glibc, ale
       carui func<?>ii de invaluire utilizeaza in mod transparent apelurile de
       sistem mai recente, acolo unde acestea sunt disponibile.

NOTE
       ftruncate() poate fi, de asemenea, utilizat pentru a defini dimensiunea
       unui obiect de memorie partajata POSIX; consulta<?>i shm_open(3).

ERORI
       O eroare a fi<?>ierului de antet in glibc 2.12 insemna ca valoarea
       minima a _POSIX_C_SOURCE necesara pentru a expune declara<?>ia
       ftruncate() era 200809L in loc de 200112L.  Acest lucru a fost remediat
       in versiunile glibc ulterioare.

CONSULTA<?>I <?>I
       truncate(1), open(2), stat(2), path_resolution(7)

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                      truncate(2)