NAZWA

       flock - założenie lub zdjęcie doradczej blokady na otwartym pliku.

SKŁADNIA

       #include <sys/file.h>

       int flock(int fd, int operation);

OPIS

       Zakłada  lub  zdejmuje  doradczą blokadę na otwartym pliku, określonym przez fd.  Parametr
       operation jest jednym z poniższych:

           LOCK_SH  Założenie blokady współdzielonej. Więcej niż jeden proces może ją  utrzymywać
                    na danym pliku w danej chwili.

           LOCK_EX  Założenie  blokady  wyłącznej. Tylko jeden proces może ją utrzymywać na danym
                    pliku w danej chwili.

           LOCK_UN  Usunięcie istniejącej blokady, założonej przez bieżący proces.

       Wywołanie flock()  może się zblokować, gdy inny proces utrzymuje blokadę niezgodnego typu.
       Aby  uzyskać  wywołanie  nieblokujące,  należy  dodać  LOCK_NB  (za pomocą bitowego OR) do
       dowolnej z powyższych wartości parametru operation.

       Pojedynczy plik nie może mieć jednocześnie założonej blokady współdzielonej i wyłącznej.

       Blokady utworzone za pomocą flock()  są skojarzone z plikiem lub - dokładniej - z wpisem w
       tablicy  otwartych  plików.   Oznacza  to,  że  powielone deskryptory plików (utworzone na
       przykład za pomocą fork(2) lub dup(2))  odnoszą się do tej samej blokady i ta blokada może
       być  zmieniana  lub  zwalniana  za pomocą dowolnego ze wspomnianych deskryptorów. Ponadto,
       blokada zostaje zwolniona albo w wyniku jawnego wykonania operacji LOCK_UN na  dowolnym  z
       tych powielonych deskryptorów, albo po zamknięciu wszystkich tych deskryptorów.

       Jeśli  proces  używa  open(2) (lub podobnego) do pozyskania więcej niż jednego deskryptora
       dla samego pliku, to flock() potraktuje  te  deskryptory  niezależnie.  Jakakolwiek  próba
       zablokowania  pliku  używającego  jednego  z  tych  deskryptorów  może być odrzucona przez
       blokadę założoną na innym z tych deskryptorów przez proces wywołujący.

       Proces może trzymać tylko jeden typ blokady (współdzieloną lub wyłączną) na  danym  pliku.
       Kolejne  wywołania   flock()  na  już zablokowanym pliku skonwertują istniejącą blokadę na
       inny typ.

       Blokady utworzone przez flock() są zachowywane przez wywołania execve(2).

       Blokada współdzielona lub wyłączna może zostać założona  na  pliku  niezależnie  od  trybu
       otwarcia tego pliku.

WARTOŚĆ ZWRACANA

       On  success, zero is returned.  On error, -1 is returned, and errno is set to indicate the
       error.

BŁĘDY

       EBADF  fd nie jest deskryptorem otwartego pliku.

       EINTR  Wywołanie zostało przerwane podczas  oczekiwania  na  założenie  blokady  w  wyniku
              doręczenia i przechwycenia sygnału przez procedurę jego obsługi; patrz signal(7).

       EINVAL operation jest niepoprawne.

       ENOLCK Zabrakło pamięci dla jądra na przydzielenie rekordów dla blokad.

       EWOULDBLOCK
              Plik jest zablokowany, a był ustawiony znacznik LOCK_NB.

ZGODNE Z

       4.4BSD  (funkcja  flock()  pojawiła  się  pierwotnie  w  4.2BSD).  Pewna  wersja  flock(),
       prawdopodobnie zaimplementowana na podstawie fcntl(2), pojawia się w  większości  systemów
       UNIX.

UWAGI

       Począwszy  od jądra 2.0, flock() jest zaimplementowane jako samodzielna funkcja systemowa,
       a nie jako emulacja w bibliotece GNU C za pomocą wywołania  fcntl(2).  Daje  to  prawdziwą
       semantykę  BSD:  nie  ma interakcji pomiędzy blokadami różnych typów, tworzonymi za pomocą
       flock() oraz tworzonymi za pomocą fcntl(2),  ponadto  flock()  nie  wykrywa  zakleszczenia
       blokad.  (Należy  jednak  zauważyć, że na niektórych systemach, takich jak nowoczesne BSD,
       blokady flock() i fcntl(2) wchodzą z sobą w interakcje).

       flock() tworzy jedynie blokady doradcze; proces mający odpowiednie uprawnienia  do  pliku,
       może  swobodnie zignorować fakt użycia flock() i wykonywać operacje wejścia/wyjścia na tym
       pliku.

       Blokady flock() i fcntl(2) różną się  semantycznie,  jeśli  chodzi  o  procesy  potomne  i
       dup(2).  W systemach implementujących flock() za pomocą fcntl(2), semantyka flock() będzie
       inna niż ta opisana w tym podręczniku.

       Nie jest gwarantowane, że konwersja blokady (z dzielonej na wyłączną lub na odwrót) będzie
       atomowa: istniejąca blokada może być najpierw usunięta, a następnie może być założona nowa
       blokada. Pomiędzy tymi dwoma krokami blokadę może uzyskać inny proces oczekujący  na  nią,
       co  spowoduje,  że konwersja blokady albo będzie oczekiwała, albo się nie powiedzie, jeśli
       podano LOCK_NB. (Jest to oryginalne zachowanie z BSD, występujące również w  wielu  innych
       implementacjach).

   NFS details
       In  Linux  kernels up to 2.6.11, flock()  does not lock files over NFS (i.e., the scope of
       locks was limited to the local system).   Instead,  one  could  use  fcntl(2)   byte-range
       locking,  which  does  work  over  NFS, given a sufficiently recent version of Linux and a
       server which supports locking.

       Since Linux 2.6.12, NFS clients support flock()   locks  by  emulating  them  as  fcntl(2)
       byte-range  locks  on  the  entire  file.  This means that fcntl(2)  and flock()  locks do
       interact with one another over NFS.  It also means that in order  to  place  an  exclusive
       lock, the file must be opened for writing.

       Since  Linux  2.6.37,  the kernel supports a compatibility mode that allows flock()  locks
       (and also fcntl(2)  byte region locks) to be treated as local; see the discussion  of  the
       local_lock option in nfs(5).

   CIFS details
       In  Linux  kernels up to 5.4, flock()  is not propagated over SMB.  A file with such locks
       will not appear locked for remote clients.

       Since Linux 5.5, flock()  locks are emulated with SMB byte-range locks on the entire file.
       Similarly  to NFS, this means that fcntl(2)  and flock()  locks interact with one another.
       Another important side-effect is that the locks are not advisory  anymore:  any  IO  on  a
       locked  file will always fail with EACCES when done from a separate file descriptor.  This
       difference originates from the design  of  locks  in  the  SMB  protocol,  which  provides
       mandatory locking semantics.

       Remote  and  mandatory  locking  semantics  may  vary with SMB protocol, mount options and
       server type.  See mount.cifs(8)  for additional information.

ZOBACZ TAKŻE

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

       Documentation/filesystems/locks.txt     w     kodzie     źródłowym      jądra      Linuksa
       (Documentation/locks.txt w przypadku starszych jąder)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  5.13  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów oraz  najnowszą  wersję  oryginału  można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony  podręcznika  są:  Przemek  Borys
       <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Robert  Luberda
       <robert@debian.org>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją. Bliższe informacje o warunkach licencji
       można   uzyskać   zapoznając   się   z   GNU   General   Public   License   w   wersji   3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   lub   nowszej.   Nie  przyjmuje  się  ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej
       ⟨manpages-pl-list@lists.sourceforge.net⟩.