flock(2)                      System Calls Manual                     flock(2)

NUME
       flock - aplica sau elimina o blocare consultativa pe un fi<?>ier
       deschis

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <sys/file.h>

       int flock(int fd, int op);

DESCRIERE
       Aplica sau elimina o blocare consultativa pe fi<?>ierul deschis
       specificat de fd. Argumentul op este unul dintre urmatoarele:

           LOCK_SH  Plaseaza o blocare partajata.  Mai mult de un proces poate
                    de<?>ine o blocare partajata pentru un anumit fi<?>ier la
                    un moment dat.

           LOCK_EX  Plaseaza o blocare exclusiva. Un singur proces poate
                    de<?>ine o blocare exclusiva pentru un anumit fi<?>ier la
                    un moment dat.

           LOCK_UN  Elimina o blocare existenta de<?>inuta de acest proces.

       Un apel la flock() se poate bloca daca un alt proces de<?>ine o blocare
       incompatibila. Pentru a face o cerere neblocanta, include<?>i LOCK_NB
       (printr-un SAU logic) cu oricare dintre opera<?>iile de mai sus.

       Un singur fi<?>ier nu poate avea simultan blocaje partajate <?>i
       exclusive.

       Blocajele create de flock() sunt asociate cu o descriere de fi<?>ier
       deschis (a se vedea open(2)). Aceasta inseamna ca descriptorii de
       fi<?>ier duplica<?>i (crea<?>i, de exemplu, prin fork(2) sau dup(2)) se
       refera la acela<?>i blocaj, iar acest blocaj poate fi modificat sau
       eliberat utilizand oricare dintre ace<?>ti descriptori de fi<?>ier. In
       plus, blocajul este eliberat fie printr-o opera<?>ie explicita LOCK_UN
       asupra oricaruia dintre ace<?>ti descriptori de fi<?>ier duplicat, fie
       atunci cand to<?>i ace<?>ti descriptori de fi<?>ier au fost inchi<?>i.

       Daca un proces utilizeaza open(2) (sau similar) pentru a ob<?>ine mai
       mult de un descriptor de fi<?>ier pentru acela<?>i fi<?>ier, ace<?>ti
       descriptori de fi<?>ier sunt trata<?>i independent de flock(). O
       incercare de blocare a fi<?>ierului folosind unul dintre ace<?>ti
       descriptori de fi<?>ier poate fi refuzata de o blocare pe care procesul
       apelant a plasat-o deja printr-un alt descriptor de fi<?>ier.

       Un proces poate de<?>ine un singur tip de blocare (partajata sau
       exclusiva) pe un fi<?>ier. Apelurile ulterioare flock() pe un fi<?>ier
       deja blocat vor converti un blocaj existent in noul mod de blocare.

       Blocajele create de flock() sunt pastrate in timpul unui execve(2).

       O blocare partajata sau exclusiva poate fi plasata pe un fi<?>ier
       indiferent de modul in care a fost deschis fi<?>ierul.

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
       EBADF  fd nu este un descriptor de fi<?>ier deschis.

       EINTR  In timp ce a<?>tepta sa ob<?>ina un blocaj, apelul a fost
              intrerupt de livrarea unui semnal capturat de un gestionar; a se
              vedea signal(7).

       EINVAL op nu este valid.

       ENOLCK Nucleul a ramas fara memorie pentru alocarea inregistrarilor de
              blocare.

       EWOULDBLOCK
              Fi<?>ierul este blocat <?>i fanionul LOCK_NB a fost selectat.

VERSIUNI
       Incepand cu Linux 2.0, flock() este implementat ca un apel de sistem de
       sine statator in loc sa fie emulat in biblioteca GNU C ca un apel catre
       fcntl(2). Cu aceasta implementare, nu exista nicio interac<?>iune intre
       tipurile de blocare plasate de flock() <?>i fcntl(2), iar flock() nu
       detecteaza blocajul. Re<?>ine<?>i, totu<?>i, ca pe unele sisteme, cum
       ar fi BSD-urile moderne, blocajele flock() <?>i fcntl(2)
       interac<?>ioneaza intre ele.

   Detalii privind CIFS
       Pana la Linux 5.4, flock() nu este propagat prin SMB. Un fi<?>ier cu
       astfel de blocaje nu va aparea blocat pentru clien<?>ii de la
       distan<?>a.

       Incepand cu Linux 5.5, blocajele flock() sunt emulate cu blocari ale
       intervalului de octe<?>i SMB pe intregul fi<?>ier. In mod similar cu
       NFS, aceasta inseamna ca blocajele fcntl(2) <?>i flock()
       interac<?>ioneaza intre ele. Un alt efect secundar important este ca
       blocajele nu mai sunt consultative: orice IO pe un fi<?>ier blocat va
       e<?>ua intotdeauna cu EACCES atunci cand este efectuata de la un
       descriptor de fi<?>ier separat. Aceasta diferen<?>a provine din
       proiectarea blocajelor in protocolul SMB, care ofera o semantica de
       blocare obligatorie.

       Semantica blocarii la distan<?>a <?>i obligatorii poate varia in
       func<?>ie de protocolul SMB, op<?>iunile de montare <?>i tipul de
       server.  Consulta<?>i mount.cifs(8) pentru informa<?>ii suplimentare.

STANDARDE
       BSD.

ISTORIC
       4.4BSD (apelul flock() a aparut pentru prima data in 4.2BSD). O
       versiune a flock(), eventual implementata in termeni de fcntl(2), apare
       pe majoritatea sistemelor UNIX.

   Detalii privind NFS
       Pana la Linux 2.6.11, flock() nu bloca fi<?>iere prin NFS (adica,
       domeniul de aplicare al blocajelor era limitat la sistemul local). In
       schimb, se poate utiliza blocarea intervalului de octe<?>i fcntl(2),
       care func<?>ioneaza pe NFS, avand in vedere o versiune suficient de
       recenta de Linux <?>i un server care accepta blocarea.

       Incepand cu Linux 2.6.12, clien<?>ii NFS accepta blocajele flock() prin
       emularea lor ca blocari de interval de octe<?>i fcntl(2) pe intregul
       fi<?>ier. Aceasta inseamna ca blocajele fcntl(2) <?>i flock() do
       interac<?>ioneaza intre ele pe NFS. Aceasta inseamna, de asemenea, ca
       pentru a plasa o blocare exclusiva, fi<?>ierul trebuie sa fie deschis
       pentru scriere.

       Incepand cu Linux 2.6.37, nucleul accepta un mod de compatibilitate
       care permite ca blocajele flock() (<?>i, de asemenea, blocajele
       regiunii de octe<?>i fcntl(2)) sa fie tratate ca locale; a se vedea
       discu<?>ia despre op<?>iunea local_lock din nfs(5).

NOTE
       flock() plaseaza numai blocaje consultative; avand in vedere
       permisiunile adecvate asupra unui fi<?>ier, un proces este liber sa
       ignore utilizarea flock() <?>i sa efectueze I/O asupra fi<?>ierului.

       Blocajele flock() <?>i fcntl(2) au semantici diferite cu privire la
       procesele bifurcate <?>i dup(2). Pe sistemele care implementeaza
       flock() folosind fcntl(2), semantica lui flock() va fi diferita de cea
       descrisa in aceasta pagina de manual.

       Conversia unui blocaj (partajat in exclusiv sau viceversa) nu este
       garantata ca fiind atomica: blocajul existent este mai intai eliminat,
       iar apoi se stabile<?>te un nou blocaj. Intre ace<?>ti doi pa<?>i, o
       cerere de blocare in a<?>teptare din partea unui alt proces poate fi
       acordata, rezultatul fiind fie blocarea conversiei, fie e<?>ecul
       acesteia daca a fost specificat LOCK_NB; (acesta este comportamentul
       BSD original <?>i apare in multe alte implementari.)

CONSULTA<?>I <?>I
       flock(1), close(2), dup(2), execve(2), fcntl(2), fork(2), open(2),
       lockf(3), lslocks(8)

       Documentation/filesystems/locks.txt in arborele sursa al nucleului
       Linux (Documentation/locks.txt in nucleele mai vechi)

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