NAZWA

       flockfile, ftrylockfile, funlockfile - blokowanie strumienia FILE dla stdio

SKŁADNIA

       #include <stdio.h>

       void flockfile(FILE *filehandle);
       int ftrylockfile(FILE *filehandle);
       void funlockfile(FILE *filehandle);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       Powyższe  funkcje  stdio  są  przystosowane  do pracy wielowątkowej.  Uzyskuje się to poprzez przypisanie
       każdemu z obiektów FILE licznika blokad oraz (dla  niezerowej  wartości  licznika)  wątku  będącego  jego
       właścicielem.   Przy  każdym wywołaniu funkcji bibliotecznej funkcje te czekają aż obiekt FILE nie będzie
       już blokowany przez inny wątek, a następnie go blokują, wykonują  żądane  operacje  we/wy  i  odblokowują
       obiekt ponownie.

       (Uwaga:  blokowanie  to  nie ma nic wspólnego z blokowaniem plików za pomocą funkcji w rodzaju flock(2) i
       lockf(3).)

       Wszystko to dzieje się w sposób niewidoczny dla  programisty  C,  jednak  mogą  pojawić  się  dwa  powody
       wymagające  bardziej szczegółowej kontroli.  Z jednej strony, szereg operacji we/wy wykonywanych w jednym
       wątku może stanowić całość, która nie może zostać przerwana przez operację we/wy innego wątku. Z  drugiej
       strony,  może  istnieć  potrzeba  uniknięcia narzutu wywołanego przez pojedyncze blokady w celu uzyskania
       większej wydajności.

       W takich sytuacjach wątek może jawnie zablokować obiekt FILE, wykonać szereg operacji we/wy i  odblokować
       go.  Uniemożliwia  to  innym wątkom przeszkadzanie w międzyczasie. Jeśli powodem założenia blokady ma być
       osiągnięcie większej wydajności, wykonuje się operacje we/wy  za  pomocą  nieblokujących  wersji  funkcji
       stdio: getc_unlocked() i putc_unlocked() zamiast getc() i putc().

       Funkcja  flockfile()  czeka  aż  *filehandle  nie  będzie zablokowany przez inny wątek, a następnie czyni
       bieżący wątek właścicielem *filehandle i zwiększa o jeden licznik blokad.

       Funkcja funlockfile() zminiejsza licznik blokad o jeden.

       Funkcja ftrylockfile() jest nieblokującą wersją flockfile().  Nie  robi  ona  nic  gdy  inny  wątek  jest
       właścicielem *filehandle, a w przeciwnym przypadku przejmuje własność i zwiększa o jeden licznik blokad.

WARTOŚĆ ZWRACANA

       Funkcja  ftrylockfile() zwraca zero w przypadku sukcesu (blokada została założona), a wartość niezerową w
       razie niepowodzenia.

BŁĘDY

       Brak.

DOSTĘPNOŚĆ

       Funkcje te są dostępne, gdy zdefiniowane jest _POSIX_THREAD_SAFE_FUNCTIONS.   Znajdują  się  one  w  libc
       począwszy od libc 5.1.1 oraz w glibc począwszy od glibc 2.0.

ZGODNE Z

       POSIX.1

ZOBACZ TAKŻE

       unlocked_stdio(3)

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne.
       W razie zauważenia różnic między powyższym opisem a rzeczywistym  zachowaniem  opisywanego  programu  lub
       funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 3 flockfile

       Prosimy   o   pomoc   w   aktualizacji   stron   man  -  więcej  informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.

                                                   2001-10-18                                        LOCKFILE(3)