lseek(2)                      System Calls Manual                     lseek(2)

NUME
       lseek - repozi<?>ionarea indicatorului de pozi<?>ie pentru
       citirea/scrierea fi<?>ierului

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

       off_t lseek(int fd, off_t offset, int whence);

DESCRIERE
       lseek() repozi<?>ioneaza indicatorul pozi<?>iei de fi<?>ier al
       descrierii fi<?>ierului deschis asociat cu descriptorul de fi<?>ier fd
       la argumentul offset in conformitate cu directiva whence dupa cum
       urmeaza:

       SEEK_SET
              Indicatorul de pozi<?>ie al fi<?>ierului este definit la offset
              octe<?>i.

       SEEK_CUR
              Indicatorul de pozi<?>ie al fi<?>ierului este definit la
              loca<?>ia sa curenta plus offset octe<?>i.

       SEEK_END
              Indicatorul de pozi<?>ie al fi<?>ierului este definit la
              dimensiunea fi<?>ierului plus offset octe<?>i.

       lseek() permite ca indicatorul de pozi<?>ie al fi<?>ierului sa fie
       stabilit dincolo de sfar<?>itul fi<?>ierului (dar acest lucru nu
       modifica dimensiunea fi<?>ierului). Daca ulterior se scriu date in
       acest punct, citirile ulterioare ale datelor din spa<?>iu (o ,,gaura")
       returneaza octe<?>i nuli (,,\0") pana cand datele sunt scrise efectiv
       in spa<?>iu.

   Cautarea datelor <?>i a gaurilor din fi<?>iere
       Incepand cu Linux 3.1, Linux accepta urmatoarele valori suplimentare
       pentru whence:

       SEEK_DATA
              Ajusteaza indicatorul de pozi<?>ie al fi<?>ierului la urmatoarea
              loca<?>ie din fi<?>ier mai mare sau egala cu offset care
              con<?>ine date. Daca offset indica date, atunci indicatorul de
              pozi<?>ie al fi<?>ierului este stabilit la offset.

       SEEK_HOLE
              Ajusteaza indicatorul de pozi<?>ie al fi<?>ierului la urmatoarea
              gaura din fi<?>ier mai mare sau egala cu offset. Daca offset
              indica mijlocul unei gauri, atunci indicatorul de pozi<?>ie al
              fi<?>ierului este stabilit la offset. Daca nu exista nicio gaura
              dupa offset, atunci indicatorul de pozi<?>ie al fi<?>ierului
              este ajustat la sfar<?>itul fi<?>ierului (de exemplu, exista o
              gaura implicita la sfar<?>itul oricarui fi<?>ier).

       In ambele cazuri de mai sus, lseek() e<?>ueaza daca offset indica dupa
       sfar<?>itul fi<?>ierului.

       Aceste opera<?>ii permit aplica<?>iilor sa cartografieze gaurile
       dintr-un fi<?>ier dispers alocat. Acest lucru poate fi util pentru
       aplica<?>ii precum instrumentele de copie de rezerva a fi<?>ierelor,
       care pot economisi spa<?>iu la crearea copiilor de rezerva <?>i pot
       pastra gaurile, daca dispun de un mecanism de descoperire a gaurilor.

       In sensul acestor opera<?>ii, o gaura este o secven<?>a de zerouri care
       (in mod normal) nu a fost alocata in spa<?>iul de stocare subiacent al
       fi<?>ierului. Cu toate acestea, un sistem de fi<?>iere nu este obligat
       sa raporteze gaurile, astfel incat aceste opera<?>ii nu sunt un
       mecanism garantat pentru cartografierea spa<?>iului de stocare alocat
       efectiv unui fi<?>ier; (in plus, o secven<?>a de zerouri care a fost
       scrisa efectiv in spa<?>iul de stocare subiacent poate sa nu fie
       raportata ca o gaura). In cea mai simpla punere in aplicare, un sistem
       de fi<?>iere poate sus<?>ine aceste opera<?>ii facand ca SEEK_HOLE sa
       returneze intotdeauna pozi<?>ia de la sfar<?>itul fi<?>ierului <?>i
       facand ca SEEK_DATA sa returneze intotdeauna offset (adica, chiar daca
       loca<?>ia la care se refera offset este o gaura, se poate considera ca
       aceasta consta din date care sunt o secven<?>a de zerouri).

       Macrocomanda de testare a caracteristicilor _GNU_SOURCE trebuie
       definita pentru a ob<?>ine defini<?>iile SEEK_DATA <?>i SEEK_HOLE din
       <unistd.h>.

       Opera<?>iile SEEK_HOLE <?>i SEEK_DATA sunt acceptate pentru urmatoarele
       sisteme de fi<?>iere:

       o  Btrfs (incepand cu Linux 3.1)

       o  OCFS (incepand cu Linux 3.2)

       o  XFS (incepand cu Linux 3.5)

       o  ext4 (incepand cu Linux 3.8)

       o  tmpfs(5) (incepand cu Linux 3.8)

       o  NFS (incepand cu Linux 3.18)

       o  FUSE (incepand cu Linux 4.5)

       o  GFS2 (incepand cu Linux 4.15)

VALOAREA RETURNATA
       La finalizarea cu succes, lseek() returneaza loca<?>ia indicatorului de
       pozi<?>ie rezultata, masurata in octe<?>i de la inceputul fi<?>ierului.
       In caz de eroare, este returnata valoarea (off_t) -1, iar errno este
       configurata pentru a indica eroarea.

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

       EINVAL whence nu este valid. Sau: pozi<?>ia fi<?>ierului rezultat ar fi
              negativa sau dincolo de sfar<?>itul unui dispozitiv explorabil.

       ENXIO  whence este SEEK_DATA sau SEEK_HOLE, iar offset se afla dincolo
              de sfar<?>itul fi<?>ierului sau whence este SEEK_DATA <?>i
              offset se afla intr-o gaura la sfar<?>itul fi<?>ierului.

       EOVERFLOW
              Pozi<?>ia din fi<?>ier rezultata nu poate fi reprezentata
              intr-un off_t.

       ESPIPE fd este asociat cu o conducta, un soclu sau o FIFO (conducta cu
              nume).

VERSIUNI
       In Linux, utilizarea lseek() pe un dispozitiv de terminal e<?>ueaza cu
       eroarea ESPIPE.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr4, 4.3BSD.

       SEEK_DATA <?>i SEEK_HOLE sunt extensii non-standard prezente <?>i in
       Solaris, FreeBSD <?>i DragonFly BSD; se propune includerea lor in
       urmatoarea revizuire POSIX (edi<?>ia 8).

NOTE
       Consulta<?>i open(2) pentru o discu<?>ie a rela<?>iei dintre
       descriptorii de fi<?>iere, descrierile de fi<?>iere deschise <?>i
       fi<?>iere.

       Daca fanionul de stare a fi<?>ierului O_APPEND este activat la
       descrierea fi<?>ierului deschis, atunci un write(2) intotdeauna muta
       indicatorul de pozi<?>ie al fi<?>ierului la sfar<?>itul fi<?>ierului,
       indiferent de utilizarea lseek().

       Unele dispozitive sunt incapabile de cautare <?>i POSIX nu specifica
       care dispozitive trebuie sa ofere suport pentru lseek().

CONSULTA<?>I <?>I
       dup(2), fallocate(2), fork(2), open(2), fseek(3), lseek64(3),
       posix_fallocate(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.15    17 mai 2025                         lseek(2)