lockf(3)                   Library Functions Manual                   lockf(3)

NUME
       lockf - aplica, testeaza sau elimina o blocare POSIX pe un fi<?>ier
       deschis

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <unistd.h>

       int lockf(int fd, int cmd, off_t len);

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

       lockf():
           _XOPEN_SOURCE >= 500
               || /* glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Aplica, testeaza sau elimina un blocaj POSIX pe o sec<?>iune a unui
       fi<?>ier deschis.  Fi<?>ierul este specificat prin fd, un descriptor de
       fi<?>ier deschis pentru scriere, ac<?>iunea prin cmd, iar sec<?>iunea
       este formata din pozi<?>iile de octe<?>i pos..pos+len-1 daca len este
       pozitiv <?>i pos-len. pos-1 daca len este negativ, unde pos este
       pozi<?>ia curenta a fi<?>ierului, iar daca len este zero, sec<?>iunea
       se extinde de la pozi<?>ia curenta a fi<?>ierului pana la infinit,
       cuprinzand pozi<?>iile prezente <?>i viitoare de sfar<?>it de fi<?>ier.
       In toate cazurile, sec<?>iunea se poate extinde dincolo de sfar<?>itul
       curent al fi<?>ierului.

       In Linux, lockf() este doar o interfa<?>a peste blocarea fcntl(2).
       Multe alte sisteme implementeaza lockf() in acest mod, dar re<?>ine<?>i
       ca POSIX.1 lasa nespecificata rela<?>ia dintre blocarile lockf() <?>i
       fcntl(2).  O aplica<?>ie portabila ar trebui probabil sa evite
       amestecarea apelurilor la aceste interfe<?>e.

       Opera<?>iile valide sunt prezentate mai jos:

       F_LOCK Stabile<?>te o blocare exclusiva pe sec<?>iunea specificata a
              fi<?>ierului. Daca aceasta sec<?>iune (sau o parte a acesteia)
              este deja blocata, apelul se blocheaza pana la eliberarea
              blocarii anterioare. In cazul in care aceasta sec<?>iune se
              suprapune peste o sec<?>iune blocata anterior, ambele sunt
              fuzionate. Blocajele de fi<?>ier sunt eliberate imediat ce
              procesul care de<?>ine blocajele inchide un descriptor de
              fi<?>ier pentru acest fi<?>ier. Un proces copil nu
              mo<?>tene<?>te aceste blocaje.

       F_TLOCK
              Acela<?>i lucru ca F_LOCK, dar apelul nu se blocheaza niciodata
              <?>i returneaza o eroare daca fi<?>ierul este deja blocat.

       F_ULOCK
              Deblocheaza sec<?>iunea indicata din fi<?>ier.  Acest lucru
              poate face ca o sec<?>iune blocata sa fie impar<?>ita in doua
              sec<?>iuni blocate.

       F_TEST Testeaza blocarea: returneaza 0 daca sec<?>iunea specificata
              este deblocata sau blocata de acest proces; returneaza -1,
              stabile<?>te errno la EAGAIN (EACCES pe alte sisteme), daca un
              alt proces de<?>ine o blocare.

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
       EACCES sau EAGAIN
              Fi<?>ierul este blocat <?>i a fost specificat F_TLOCK sau
              F_TEST, sau opera<?>iunea este interzisa deoarece fi<?>ierul a
              fost plasat in memorie de un alt proces.

       EBADF  fd nu este un descriptor de fi<?>ier deschis; sau cmd este
              F_LOCK sau F_TLOCK <?>i fd nu este un descriptor de fi<?>ier
              inscriptibil.

       EDEADLK
              Comanda a fost F_LOCK <?>i aceasta opera<?>ie de blocare ar fi
              provocat un blocaj.

       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 A fost specificata o opera<?>ie nevalida in cmd.

       ENOLCK Prea multe blocari de segment deschise, tabelul de blocare este
              plin.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |lockf()                               | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr4.

CONSULTA<?>I <?>I
       fcntl(2), flock(2)

       locks.txt <?>i mandatory-locking.txt in directorul sursa al nucleului
       Linux Documentation/filesystems (pe nucleele mai vechi, aceste
       fi<?>iere se afla direct sub directorul Documentation, iar
       mandatory-locking.txt se nume<?>te mandatory.txt).

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                      lockf(3)