FLOCK(1)                      Comenzi utilizator                      FLOCK(1)

NUME
       flock - gestioneaza blocarile din scripturi shell

REZUMAT
       flock [op<?>iuni] fi<?>ier|director comanda [argumente]

       flock [op<?>iuni] fi<?>ier|director -c comanda

       flock [op<?>iuni] numar

DESCRIERE
       Aceasta utilitate gestioneaza blocarile flock(2) din cadrul
       scripturilor de tip shell sau din linia de comanda.

       Prima <?>i a doua dintre formele de mai sus invaluie blocarea in jurul
       executarii unei comenzi, intr-un mod similar cu su(1) sau newgrp(1).
       Acestea blocheaza un fi<?>ier sau un director specificat, care este
       creat (presupunand permisiunile corespunzatoare) daca nu exista deja.
       In mod implicit, in cazul in care blocarea nu poate fi ob<?>inuta
       imediat, flock a<?>teapta pana cand blocarea este disponibila.

       Cea de-a treia forma utilizeaza un fi<?>ier deschis prin descriptorul
       de fi<?>ier numar. A se vedea exemplele de mai jos pentru a afla cum
       poate fi utilizat.

OP<?>IUNI
       -c, --command comanda
           Paseaza o singura comanda, fara argumente, catre shell cu -c.

       -E, --conflict-exit-code numar
           Starea de ie<?>ire utilizata atunci cand se utilizeaza op<?>iunea
           -n <?>i exista o blocare conflictuala sau cand se utilizeaza
           op<?>iunea -w <?>i se depa<?>e<?>te timpul de a<?>teptare. Valoarea
           implicita este 1. numarul trebuie sa fie cuprins intre 0 <?>i 255.

       -F, --no-fork
           Nu creeaza o bifurca<?>ie inainte de a executa comanda. Dupa
           execu<?>ie, procesul flock este inlocuit de comanda, care continua
           sa de<?>ina blocarea. Aceasta op<?>iune este incompatibila cu
           op<?>iunea --close, deoarece altfel nu ar mai ramane nimic care sa
           pastreze blocajul.

       -e, -x, --exclusive
           Ob<?>ine o blocare exclusiva, denumita uneori blocare la scriere.
           Aceasta este op<?>iunea implicita.

       -n, --nb, --nonblock
           E<?>ueaza in loc sa a<?>tepte, daca nu se poate ob<?>ine imediat
           blocarea. A se vedea op<?>iunea -E pentru starea de ie<?>ire
           utilizata.

       -o, --close
           Inchide descriptorul de fi<?>ier in care este de<?>inut blocajul
           inainte de a executa comanda. Acest lucru este util in cazul in
           care comanda genereaza un proces-copil care nu ar trebui sa
           de<?>ina blocarea.

       -s, --shared
           Ob<?>ine o blocare partajata, denumita uneori blocare la citire.

       -u, --unlock
           Inlatura o blocare. De obicei, acest lucru nu este necesar,
           deoarece o blocare este eliminata automat atunci cand fi<?>ierul
           este inchis. Cu toate acestea, poate fi necesara in cazuri
           speciale, de exemplu, daca grupul de comenzi inchis a bifurcat un
           proces in fundal care nu ar trebui sa de<?>ina blocarea.

       -w, --wait, --timeout secunde
           E<?>ueaza daca blocarea nu poate fi ob<?>inuta in secunde. Sunt
           permise valorile frac<?>ionare zecimale. A se vedea op<?>iunea -E
           pentru starea de ie<?>ire utilizata. Numarul zero de secunde este
           interpretat ca fiind --nonblock.

       --fcntl
           In loc de flock(2), aplica o blocare a descrierii fi<?>ierului
           deschis fcntl(2) (adica, utilizand comenzile F_OFD_SETLK
           (neblocare) sau F_OFD_SETLKW (blocare)). Aceste blocaje sunt
           independente de cele aplicate prin flock(2), dar, spre deosebire de
           blocajele tradi<?>ionale POSIX fcntl() (F_SETLK, F_SETLKW), au o
           semantica care corespunde celei a flock(2).

       Aceasta este disponibila numai pe versiunile de nucleu >= 3.15.

       --verbose
           Raporteaza cat timp a durat ob<?>inerea blocarii sau de ce nu a
           putut fi ob<?>inuta.

       -h, --help
           Afi<?>eaza acest mesaj de ajutor <?>i iese.

       -V, --version
           Afi<?>eaza versiunea <?>i iese.

STARE DE IE<?>IRE
       Comanda utilizeaza valorile de stare de ie<?>ire <sysexits.h> pentru
       orice lucru, cu excep<?>ia cazului in care se utilizeaza oricare dintre
       op<?>iunile -n sau -w, care raporteaza un e<?>ec de achizi<?>ionare a
       blocarii cu o stare de ie<?>ire data de op<?>iunea -E sau 1 in mod
       implicit. Starea de ie<?>ire data de -E trebuie sa fie cuprinsa intre 0
       <?>i 255.

       Atunci cand se utilizeaza varianta comanda <?>i se executa
       comanda-copil, atunci starea de ie<?>ire este cea a comenzii-copil.

NOTE
       flock nu detecteaza blocajul blocarii (deadlock). A se vedea flock(2)
       pentru detalii.

       Unele sisteme de fi<?>iere (de exemplu, NFS <?>i CIFS) au o
       implementare limitata a flock(2) <?>i este posibil ca <<flock>> sa
       e<?>ueze intotdeauna. Pentru detalii, consulta<?>i flock(2), nfs(5)
       <?>i mount.cifs(8). In func<?>ie de op<?>iunile de montare, <<flock>>
       poate e<?>ua intotdeauna acolo.

EXEMPLE
       Re<?>ine<?>i ca ,,shell> " din exemple este un prompt de linie de
       comanda.

       shell1> flock /tmp -c cat; shell2> flock -w .007 /tmp -c echo;
       /bin/echo $?
           Stabile<?>te o blocare exclusiva a directorului /tmp <?>i a doua
           comanda va e<?>ua.

       shell1> flock -s /tmp -c cat; shell2> flock -s -w .007 /tmp -c echo;
       /bin/echo $?
           Stabile<?>te blocarea partajata la directorul /tmp <?>i a doua
           comanda nu va e<?>ua. Observa<?>i ca incercarea de a ob<?>ine o
           blocare exclusiva cu a doua comanda ar e<?>ua.

       shell> flock -x fi<?>ier-blocare-locala echo 'a b c'
           Preia blocarea exclusiva ,,fi<?>ier-blocare-locala" inainte de a
           rula echo cu ,,a b c".

       (; flock -n 9 || exit 1; # ... comenzi executate sub blocare ...; )
       9>/var/lock/fi<?>ierul-meu-de-blocare
           Formatul este convenabil in cadrul scripturilor shell. Modul
           utilizat pentru a deschide fi<?>ierul nu conteaza pentru flock;
           utilizarea > sau >> permite crearea fi<?>ierului de blocare daca
           acesta nu exista deja, insa este necesara permisiunea de scriere.
           Utilizarea < presupune ca fi<?>ierul sa existe deja, dar este
           necesara doar permisiunea de citire.

       [ "${FLOCKER}" != "$0" ] && exec env FLOCKER="$0" flock -en "$0" "$0"
       "$@" || :
           Acesta este un cod auxiliar util pentru scripturile shell.
           Pune<?>i-l in partea de sus a scriptului shell pe care dori<?>i sa
           il bloca<?>i <?>i se va bloca automat la prima execu<?>ie. Daca
           variabila de mediu $FLOCKER nu este definita la scriptul de shell
           care este rulat, atunci executa flock <?>i ob<?>ine o blocare
           exclusiva fara blocare (folosind scriptul insu<?>i ca fi<?>ier de
           blocare) inainte de a se reexecuta cu argumentele corecte. De
           asemenea, stabile<?>te variabila de mediu FLOCKER la valoarea
           corecta, astfel incat sa nu se mai execute din nou.

       shell> exec 4<>/var/lock/fi<?>ierul-meu-de-blocare; shell> flock -n 4
           Aceasta forma este convenabila pentru a bloca un fi<?>ier fara a
           genera un subproces. Shell-ul deschide fi<?>ierul de blocare pentru
           citire <?>i scriere ca descriptor de fi<?>ier 4, apoi se utilizeaza
           flock pentru a bloca descriptorul.

AUTORI
       H. Peter Anvin <hpa@zytor.com>

DREPTURI DE AUTOR
       Drepturi de autor (C) 2003-2006 H. Peter Anvin. Acesta este un software
       liber; consulta<?>i sursa pentru condi<?>iile de copiere. Nu exista
       nicio garan<?>ie; nici macar pentru COMERCIALIZARE sau ADECVARE LA UN
       SCOP PARTICULAR.

CONSULTA<?>I <?>I
       flock(2), fcntl(2)

RAPORTAREA ERORILOR
       Pentru rapoarte de eroare, folosi<?>i sistemul de urmarire al erorilor
       <https://github.com/util-linux/util-linux/issues>.

DISPONIBILITATE
       Comanda flock face parte din pachetul util-linux care poate fi
       descarcat de la Linux Kernel Archive
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                   2025-03-29                          FLOCK(1)