LSLOCKS(8)                  Administracja systemem                  LSLOCKS(8)

NAZWA
       lslocks - wypisuje lokalne blokady systemowe

SKLADNIA
       lslocks [opcje]

OPIS
       lslocks wypisuje informacje o wszystkich obecnie utrzymywanych
       blokadach plikow w systemie Linux.

OPCJE
       -b, --bytes
           Wypisuje rozmiar w bajtach, zamiast w postaci czytelnej dla
           czlowieka.

           Domyslnie, jednostki sa pokazywane w jednostkach bedacych
           wielokrotnosciami 1024 bajtow. Formalne skroty tych jednostek (KiB,
           MiB, GiB, ...) sa nastepnie skracane do pierwszej litery: K, M, G,
           ....

       -H, --list-columns
           Wypisuje kolumny, ktore mozna podac razem z opcja --output. Mozna
           stosowac w polaczeniu z --json lub --raw, aby uzyskac wynik w
           formacie czytelnym maszynowo.

       -i, --noinaccessible
           Ignoruje blokady plikow niedostepnych dla biezacego uzytkownika.

       -J, --json
           Uzywa formatu wyjsciowego JSON.

       -n, --noheadings
           Nie wypisuje naglowka.

       -o, --output lista
           Okresla wypisywane kolumny. Ich liste mozna poznac podajac opcje
           --help.

           Domyslna liste kolumn mozna rozszerzyc, podajac liste w formacie
           +lista (np. lslocks -o +BLOCKER).

       --output-all
           Wypisuje wszystkie dostepne kolumny.

       -p, --pid pid
           Wypisuje tylko blokady utrzymywane przez proces o identyfikatorze
           pid.

       -Q*, --filter wyrazenie
           Wypisuje tylko blokady spelniajace warunki okreslone w wyrazeniu.

           Funkcja ta jest EKSPERYMENTALNA. Zob. tez scols-filter(5). Oto
           przyklad uwzgledniajacy blokady typu POSIX, ale wypisujacy
           wszystkie blokady w trybie do odczytu (READ), na plikach o
           rozszerzeniu _.qcow2:

              lslocks --filter 'TYPE != "POSIX" and MODE == "READ" and PATH =~ ".*\.qcow2"'

       -r, --raw
           Uzywa surowego formatu wyjsciowego.

       -u, --notruncate
           Nie przycina tekstu w kolumnach.

       -h, --help
           Wyswietla ten tekst i wychodzi.

       -V, --version
           Wyswietla wersje i wychodzi.

SRODOWISKO
       LIBSMARTCOLS_DEBUG=all
           wlacza wyjscie debugowania libsmartcols.

       LIBSMARTCOLS_DEBUG_PADDING=on
           uzywa widocznych znakow wypelnienia.

WYJSCIE
       COMMAND
           Nazwa polecenia procesu utrzymujacego blokade.

       PID
           Identyfikator procesu.

       TYPE
           Typ blokady; moze byc to: LEASE (blokada utworzona przez fcntl(2)),
           FLOCK (utworzona przez flock(2)), POSIX (utworzona przez fcntl(2) i
           lockf(3)) lub OFDLCK (utworzona przez fcntl(2)).

       SIZE
           Rozmiar zablokowanego pliku.

       INODE
           Numer i-wezla.

       MAJ:MIN
           Glowny:poboczny numer urzadzenia.

       MODE
           Uprawnienia dostepu blokady (odczyt, zapis). Jesli proces jest
           zablokowany i czeka na blokade, to po trybie jest doklejona "*"
           (gwiazdka).

       M
           Wskazuje czy blokada jest obowiazujaca (przymusowa): 0 oznacza nie
           (blokada jest tylko doradcza), 1 oznacza tak (zob. fcntl(2)).

       START
           Wzgledne przesuniecie bajtowe blokady.

       END
           Przesuniecie konca blokady.

       PATH
           Pelna sciezka blokady. Jesli nie zostanie odnaleziona lub gdy brak
           uprawnien do odczytu sciezki, umieszczony bedzie punkt montowania
           urzadzenia z dopisanymi "...". Sciezka moze zostac przycieta; opcja
           --notruncate pokaze pelna sciezke.

       BLOCKER
           PID procesu blokujacego.

       HOLDERS
           Utrzymujacy blokade. Formatem utrzymujacego jest: PID,COMMAND,FD.
           Jesli blokada jest blokada opisu otwartego pliku (ODF), moze
           wystapic kilku utrzymujacych. Zob. UWAGI ponizej.

SRODOWISKO
       LSLOCKS_COLUMNS=
           Okresla rozdzielona przecinkiem liste kolumn wyjsciowych do
           wypisania. Mozna stosowac wszystkie kolumny podane opcja
           --list-columns.

UWAGI
       Polecenie lslocks sluzy zastapieniu polecenia lslk(8), pierwotnie
       napisanego przez Victora A. Abella <abe@purdue.edu>, ktore nie jest
       utrzymywane od 2001 r.

       "Proces utrzymujacy blokade" w przypadku dzierzaw, blokad FLOCK oraz
       blokad opisu otwartego pliku (ODF) jest nieprawidlowym pojeciem. Sa one
       zwiazane z opisem otwartego pliku, na ktorych sa uzyskiwane. Z pomoca
       fork(2) i/lub cmsg(3), wiele procesow moze dzielic opis otwartego
       pliku. Zatem nie da sie wskazac jednego procesu utrzymujacego dzierzawe
       (lub blokady). lslocks pokazuje jeden z procesow utrzymujacych w
       kolumnach COMMAND i PID.

       Domyslne wyjscie programu moze sie zmienic. Jesli to mozliwe, nalezy
       zatem unikac uzywania domyslnego wyjscia w swoich skryptach.

       W przypadku blokad opisu otwartego pliku (OFD), kolumna PID moze
       pokazywac -1. Takich wierszy nie da sie wybrac za pomoca filtra,
       poniewaz jego aktualny silnik nie obsluguje liczb ujemnych.

AUTORZY
       Davidlohr Bueso <dave@gnu.org> Christian Goeschel Ndjomouo
       <cgoesc2@wgu.edu>

ZOBACZ TAKZE
       flock(1), fcntl(2), lockf(3), scols-filter(5)

ZGLASZANIE BLEDOW
       Problemy nalezy zglaszac w systemie sledzenia bledow
       <https://github.com/util-linux/util-linux/issues>.

DOSTEPNOSC
       Polecenie lslocks jest czescia pakietu util-linux, ktory mozna pobrac
       ze strony Archiwum jadra Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.42.3                 2026-09-02                        LSLOCKS(8)