.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (C) 2001 Andries Brouwer . .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH flockfile 3 "5 lutego 2023 r." "Linux man\-pages 6.03" .SH NAZWA flockfile, ftrylockfile, funlockfile \- blokuje strumień FILE dla stdio .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP .PP \fBvoid flockfile(FILE *\fP\fIfilehandle\fP\fB);\fP \fBint ftrylockfile(FILE *\fP\fIfilehandle\fP\fB);\fP \fBvoid funlockfile(FILE *\fP\fIfilehandle\fP\fB);\fP .fi .PP .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP Wszystkie funkcje powyżej: .nf /* Od glibc 2.24: */ _POSIX_C_SOURCE >= 199309L || /* glibc <= 2.23: */ _POSIX_C_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH OPIS Powyższe funkcje stdio są przystosowane do pracy wielowątkowej. Uzyskuje się to przez przypisanie każdemu z obiektów \fIFILE\fP licznika blokad oraz (jeśli wartość licznika jest niezerowa) wątku będącego jego właścicielem. Przy każdym wywołaniu funkcji bibliotecznej funkcje te czekają, aż obiekt \fIFILE\fP nie będzie już blokowany przez inny wątek, a następnie go blokują, wykonują żądane operacje wejścia/wyjścia i odblokowują obiekt ponownie. .PP (Uwaga: blokowanie to nie ma nic wspólnego z blokowaniem plików za pomocą funkcji w rodzaju \fBflock\fP(2) i \fBlockf\fP(3)). .PP 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 wejścia/wyjścia wykonywanych w jednym wątku może stanowić całość, która nie może zostać przerwana przez operację wejścia/wyjścia innego wątku. Z drugiej zaś strony może istnieć potrzeba uniknięcia narzutu wywołanego przez pojedyncze blokady w celu uzyskania większej wydajności. .PP W takich sytuacjach wątek może jawnie zablokować obiekt \fIFILE\fP, wykonać szereg operacji wejścia/wyjścia 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 wejścia/wyjścia za pomocą nieblokujących wersji funkcji stdio: \fBgetc_unlocked\fP(3) oraz \fBputc_unlocked\fP(3) zamiast \fBgetc\fP(3) i \fBputc\fP(3). .PP Funkcja \fBflockfile\fP() czeka aż \fI*filehandle\fP nie będzie zablokowany przez inny wątek, a następnie czyni bieżący wątek właścicielem \fI*filehandle\fP i zwiększa o jeden licznik blokad. .PP Funkcja \fBfunlockfile\fP() zmniejsza licznik blokad o jeden. .PP Funkcja \fBftrylockfile\fP() jest nieblokującą wersją \fBflockfile\fP(). Nie robi nic, gdy inny wątek jest właścicielem \fI*filehandle\fP, a w przeciwnym przypadku przejmuje własność i zwiększa licznik blokad o jeden. .SH "WARTOŚĆ ZWRACANA" Funkcja \fBftrylockfile\fP() zwraca zero w przypadku sukcesu (blokada została założona), a wartość niezerową w razie niepowodzenia. .SH BŁĘDY Brak. .SH ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .ad l .nh .TS allbox; lbx lb lb l l l. Interfejs Atrybut Wartość T{ \fBflockfile\fP(), \fBftrylockfile\fP(), \fBfunlockfile\fP() T} Bezpieczeństwo wątkowe MT\-bezpieczne .TE .hy .ad .sp 1 .SH STANDARDY POSIX.1\-2001, POSIX.1\-2008. .PP Funkcje te są dostępne, gdy zdefiniowane jest \fB_POSIX_THREAD_SAFE_FUNCTIONS\fP. .SH "ZOBACZ TAKŻE" \fBunlocked_stdio\fP(3) .PP .SH TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Andrzej Krzysztofowicz i Robert Luberda . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .