.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1997 Nicolás Lichtmaier .\" Created Thu Aug 7 00:44:00 ART 1997 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Added section stuff, aeb, 2002-04-22. .\" Corrected include file, drepper, 2003-06-15. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lockf 3 "2 mai 2024" "Pagini de manual de Linux 6.8" .SH NUME lockf \- aplică, testează sau elimină o blocare POSIX pe un fișier deschis .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBint lockf(int \fP\fIfd\fP\fB, int \fP\fIop\fP\fB, off_t \fP\fIlen\fP\fB);\fP .fi .P .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .P \fBlockf\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIERE Aplică, testează sau elimină un blocaj POSIX pe o secțiune a unui fișier deschis. Fișierul este specificat prin \fIfd\fP, un descriptor de fișier deschis pentru scriere, acțiunea prin \fIop\fP, iar secțiunea este formată din pozițiile de octeți \fIpos\fP..\fIpos\fP+\fIlen\fP\-1 dacă \fIlen\fP este pozitiv și \fIpos\fP\-\fIlen\fP. \fIpos\fP\-1 dacă \fIlen\fP este negativ, unde \fIpos\fP este poziția curentă a fișierului, iar dacă \fIlen\fP este zero, secțiunea se extinde de la poziția curentă a fișierului până la infinit, cuprinzând pozițiile prezente și viitoare de sfârșit de fișier. În toate cazurile, secțiunea se poate extinde dincolo de sfârșitul curent al fișierului. .P În Linux, \fBlockf\fP() este doar o interfață peste blocarea \fBfcntl\fP(2). Multe alte sisteme implementează \fBlockf\fP() în acest mod, dar rețineți că POSIX.1 lasă nespecificată relația dintre blocările \fBlockf\fP() și \fBfcntl\fP(2). O aplicație portabilă ar trebui probabil să evite amestecarea apelurilor la aceste interfețe. .P Operațiile valide sunt prezentate mai jos: .TP \fBF_LOCK\fP Stabilește o blocare exclusivă pe secțiunea specificată a fișierului. Dacă această secțiune (sau o parte a acesteia) este deja blocată, apelul se blochează până la eliberarea blocării anterioare. În cazul în care această secțiune se suprapune peste o secțiune blocată anterior, ambele sunt fuzionate. Blocajele de fișier sunt eliberate imediat ce procesul care deține blocajele închide un descriptor de fișier pentru acest fișier. Un proces copil nu moștenește aceste blocaje. .TP \fBF_TLOCK\fP Același lucru ca \fBF_LOCK\fP, dar apelul nu se blochează niciodată și returnează o eroare dacă fișierul este deja blocat. .TP \fBF_ULOCK\fP Deblochează secțiunea indicată din fișier. Acest lucru poate face ca o secțiune blocată să fie împărțită în două secțiuni blocate. .TP \fBF_TEST\fP Testează blocarea: returnează 0 dacă secțiunea specificată este deblocată sau blocată de acest proces; returnează \-1, stabilește \fIerrno\fP la \fBEAGAIN\fP (\fBEACCES\fP pe alte sisteme), dacă un alt proces deține o blocare. .SH "VALOAREA RETURNATĂ" În caz de succes, se returnează zero. În caz de eroare, se returnează \-1, iar \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEACCES\fP sau \fBEAGAIN\fP Fișierul este blocat și a fost specificat \fBF_TLOCK\fP sau \fBF_TEST\fP, sau operația este interzisă deoarece fișierul a fost plasat în memorie de un alt proces. .TP \fBEBADF\fP \fIfd\fP nu este un descriptor de fișier deschis; sau \fIop\fP este \fBF_LOCK\fP sau \fBF_TLOCK\fP și \fIfd\fP nu este un descriptor de fișier inscriptibil. .TP \fBEDEADLK\fP \fIop\fP (operația) a fost \fBF_LOCK\fP și această operație de blocare ar fi provocat un blocaj. .TP \fBEINTR\fP În timp ce aștepta să obțină un blocaj, apelul a fost întrerupt de livrarea unui semnal capturat de un gestionar; a se vedea \fBsignal\fP(7). .TP \fBEINVAL\fP A fost specificată o operație nevalidă în \fIop\fP. .TP \fBENOLCK\fP Prea multe blocări de segment deschise, tabelul de blocare este plin. .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBlockf\fP() T} Siguranța firelor MT\-Safe .TE .SH STANDARDE POSIX.1\-2008. .SH ISTORIC POSIX.1\-2001, SVr4. .SH "CONSULTAȚI ȘI" \fBfcntl\fP(2), \fBflock\fP(2) .P \fIlocks.txt\fP și \fImandatory\-locking.txt\fP în directorul sursă al nucleului Linux \fIDocumentation/filesystems\fP (pe nucleele mai vechi, aceste fișiere se află direct sub directorul \fIDocumentation\fP, iar \fImandatory\-locking.txt\fP se numește \fImandatory.txt\fP). .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .