flockfile(3)               Library Functions Manual               flockfile(3)

NUME
       flockfile, ftrylockfile, funlockfile, funlockfile - blocheaza un
       FI<?>IER pentru stdio (intrarea/ie<?>irea standard)

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdio.h>

       void flockfile(FI<?>IER *filehandle);
       int ftrylockfile(FI<?>IER *filehandle);
       void funlockfile(FI<?>IER *filehandle);

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

       Toate func<?>iile prezentate mai sus:
           /* Incepand cu glibc 2.24: */ _POSIX_C_SOURCE >= 199309L
               || /* Versiunile de glibc <= 2.23: */ _POSIX_C_SOURCE
               || /* Versiunile de glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Func<?>iile stdio sunt sigure pentru fire de execu<?>ie.  Acest lucru
       se realizeaza prin atribuirea la fiecare obiect FI<?>IER a unui numar
       de blocare <?>i (daca numarul de blocare este diferit de zero) a unui
       fir proprietar.  Pentru fiecare apel la biblioteca, aceste func<?>ii
       a<?>teapta pana cand obiectul FI<?>IER nu mai este blocat de un alt fir
       de execu<?>ie, apoi il blocheaza, efectueaza In/Ie<?> solicitata <?>i
       deblocheaza din nou obiectul.

       Nota: aceasta blocare nu are nimic de-a face cu blocarea fi<?>ierelor
       efectuata de func<?>ii precum flock(2) <?>i lockf(3).

       Toate acestea sunt invizibile pentru programatorul C, dar pot exista
       doua motive pentru a dori un control mai detaliat.  Pe de o parte,
       poate ca o serie de ac<?>iuni de intrare/ie<?>ire efectuate de un fir
       de execu<?>ie se potrivesc <?>i nu ar trebui sa fie intrerupte de
       intrarea/ie<?>irea unui alt fir de execu<?>ie.  Pe de alta parte, poate
       ca, pentru o mai mare eficien<?>a, ar trebui evitat blocajul.

       In acest scop, un fir de execu<?>ie poate bloca in mod explicit
       obiectul FI<?>IER, apoi poate efectua o serie de ac<?>iuni de
       intrare/ie<?>ire, dupa care poate fi deblocat.  Acest lucru impiedica
       alte fire sa intervina intre ele.  Daca motivul pentru care se
       procedeaza astfel ar fi acela de a ob<?>ine o mai mare eficien<?>a, se
       face In/Ie<?> cu versiunile fara blocare ale func<?>iilor stdio: cu
       getc_unlocked(3) <?>i putc_unlocked(3) in loc de getc(3) <?>i putc(3).

       Func<?>ia flockfile() a<?>teapta ca *filehandle sa nu mai fie blocat de
       un alt fir de execu<?>ie, apoi il face pe firul curent proprietar al
       *filehandle <?>i mare<?>te numarul de blocare.

       Func<?>ia funlockfile() decrementeaza numarul de blocare.

       Func<?>ia ftrylockfile() este o versiune fara blocare a flockfile().
       Aceasta nu face nimic in cazul in care un alt fir de execu<?>ie
       de<?>ine *filehandle, iar in caz contrar ob<?>ine proprietatea <?>i
       mare<?>te numarul de blocare.

VALOAREA RETURNATA
       Func<?>ia ftrylockfile() returneaza zero in caz de succes (blocarea a
       fost ob<?>inuta) <?>i o valoare diferita de zero in caz de e<?>ec.

ERORI-IE<?>IRE
       Niciunul.

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

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

ISTORIC
       POSIX.1-2001.

       Aceste func<?>ii sunt disponibile atunci cand este definita
       _POSIX_THREAD_SAFE_FUNCTIONS.

CONSULTA<?>I <?>I
       unlocked_stdio(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.06 31 octombrie 2023                  flockfile(3)