NUME¶

flock - aplică sau elimină o blocare consultativă pe un fișier deschis

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <sys/file.h>

int flock(int fd, int op);

DESCRIERE¶

Aplică sau elimină o blocare consultativă pe fișierul deschis specificat de fd. Argumentul op este unul dintre următoarele:

Un apel la flock() se poate bloca dacă un alt proces deține o blocare incompatibilă. Pentru a face o cerere neblocantă, includeți LOCK_NB (printr-un SAU logic) cu oricare dintre operațiile de mai sus.

Un singur fișier nu poate avea simultan blocaje partajate și exclusive.

Blocajele create de flock() sunt asociate cu o descriere de fișier deschis (a se vedea open(2)). Aceasta înseamnă că descriptorii de fișier duplicați (creați, de exemplu, prin fork(2) sau dup(2)) se referă la același blocaj, iar acest blocaj poate fi modificat sau eliberat utilizând oricare dintre acești descriptori de fișier. În plus, blocajul este eliberat fie printr-o operație explicită LOCK_UN asupra oricăruia dintre acești descriptori de fișier duplicat, fie atunci când toți acești descriptori de fișier au fost închiși.

Dacă un proces utilizează open(2) (sau similar) pentru a obține mai mult de un descriptor de fișier pentru același fișier, acești descriptori de fișier sunt tratați independent de flock(). O încercare de blocare a fișierului folosind unul dintre acești descriptori de fișier poate fi refuzată de o blocare pe care procesul apelant a plasat-o deja printr-un alt descriptor de fișier.

Un proces poate deține un singur tip de blocare (partajată sau exclusivă) pe un fișier. Apelurile ulterioare flock() pe un fișier deja blocat vor converti un blocaj existent în noul mod de blocare.

Blocajele create de flock() sunt păstrate în timpul unui execve(2).

O blocare partajată sau exclusivă poate fi plasată pe un fișier indiferent de modul în care a fost deschis fișierul.

VALOAREA RETURNATö

În caz de succes, se returnează zero. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE¶

EBADF

fd nu este un descriptor de fișier deschis.

EINTR

Î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 signal(7).

EINVAL

op nu este valid.

ENOLCK

Nucleul a rămas fără memorie pentru alocarea înregistrărilor de blocare.

EWOULDBLOCK

Fișierul este blocat și fanionul LOCK_NB a fost selectat.

VERSIUNI¶

Începând cu Linux 2.0, flock() este implementat ca un apel de sistem de sine stătător în loc să fie emulat în biblioteca GNU C ca un apel către fcntl(2). Cu această implementare, nu există nicio interacțiune între tipurile de blocare plasate de flock() și fcntl(2), iar flock() nu detectează blocajul. Rețineți, totuși, că pe unele sisteme, cum ar fi BSD-urile moderne, blocajele flock() și fcntl(2) interacționează între ele.

STANDARDE¶

BSD.

ISTORIC¶

4.4BSD (apelul flock() a apărut pentru prima dată în 4.2BSD). O versiune a flock(), eventual implementată în termeni de fcntl(2), apare pe majoritatea sistemelor UNIX.

NOTE¶

flock() plasează numai blocaje consultative; având în vedere permisiunile adecvate asupra unui fișier, un proces este liber să ignore utilizarea flock() și să efectueze I/O asupra fișierului.

Blocajele flock() și fcntl(2) au semantici diferite cu privire la procesele bifurcate și dup(2). Pe sistemele care implementează flock() folosind fcntl(2), semantica lui flock() va fi diferită de cea descrisă în această pagină de manual.

Conversia unui blocaj (partajat în exclusiv sau viceversa) nu este garantată ca fiind atomică: blocajul existent este mai întâi eliminat, iar apoi se stabilește un nou blocaj. Între acești doi pași, o cerere de blocare în așteptare din partea unui alt proces poate fi acordată, rezultatul fiind fie blocarea conversiei, fie eșecul acesteia dacă a fost specificat LOCK_NB; (acesta este comportamentul BSD original și apare în multe alte implementări.)

CONSULTAȚI ȘI¶

flock(1), close(2), dup(2), execve(2), fcntl(2), fork(2), open(2), lockf(3), lslocks(8)

Documentation/filesystems/locks.txt în arborele sursă al nucleului Linux (Documentation/locks.txt în nucleele mai vechi)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.