LSLOCKS(8) Administracja systemem LSLOCKS(8)

lslocks - wypisuje lokalne blokady systemowe

lslocks [opcje]

lslocks wypisuje informacje o wszystkich obecnie utrzymywanych blokadach plików w systemie Linux.

-b, --bytes

Wypisuje rozmiar w bajtach, zamiast w postaci czytelnej dla człowieka.

Domyślnie, jednostki są pokazywane w jednostkach będących wielokrotnościami 1024 bajtów. Formalne skróty tych jednostek (KiB, MiB, GiB, ...) są następnie skracane do pierwszej litery: K, M, G, ....

-H, --list-columns

Wypisuje kolumny, które można podać razem z opcją --output. Można stosować w połączeniu z --json lub --raw, aby uzyskać wynik w formacie czytelnym maszynowo.

-i, --noinaccessible

Ignoruje blokady plików niedostępnych dla bieżącego użytkownika.

-J, --json

Używa formatu wyjściowego JSON.

-n, --noheadings

Nie wypisuje nagłówka.

-o, --output lista

Określa wypisywane kolumny. Ich listę można poznać podając opcję --help.

Domyślną listę kolumn można rozszerzyć, podając listę w formacie +lista (np. lslocks -o +BLOCKER).

--output-all

Wypisuje wszystkie dostępne kolumny.

-p, --pid pid

Wypisuje tylko blokady utrzymywane przez proces o identyfikatorze pid.

-Q*, --filter wyrażenie

Wypisuje tylko blokady spełniające warunki określone w wyrażeniu.

Funkcja ta jest EKSPERYMENTALNA. Zob. też scols-filter(5). Oto przykład uwzględniający blokady typu POSIX, ale wypisujący wszystkie blokady w trybie do odczytu (READ), na plikach o rozszerzeniu _.qcow2:

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

-r, --raw

Używa surowego formatu wyjściowego.

-u, --notruncate

Nie przycina tekstu w kolumnach.

-h, --help

Wyświetla ten tekst i wychodzi.

-V, --version

Wyświetla wersję i wychodzi.

ŚRODOWISKO

LIBSMARTCOLS_DEBUG=all

włącza wyjście debugowania libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on

używa widocznych znaków wypełnienia.

COMMAND

Nazwa polecenia procesu utrzymującego blokadę.

PID

Identyfikator procesu.

TYPE

Typ blokady; może być 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-węzła.

MAJ:MIN

Główny:poboczny numer urządzenia.

MODE

Uprawnienia dostępu blokady (odczyt, zapis). Jeśli proces jest zablokowany i czeka na blokadę, to po trybie jest doklejona "*" (gwiazdka).

M

Wskazuje czy blokada jest obowiązująca (przymusowa): 0 oznacza nie (blokada jest tylko doradcza), 1 oznacza tak (zob. fcntl(2)).

START

Względne przesunięcie bajtowe blokady.

END

Przesunięcie końca blokady.

PATH

Pełna ścieżka blokady. Jeśli nie zostanie odnaleziona lub gdy brak uprawnień do odczytu ścieżki, umieszczony będzie punkt montowania urządzenia z dopisanymi "...". Ścieżka może zostać przycięta; opcja --notruncate pokaże pełną ścieżkę.

BLOCKER

PID procesu blokującego.

HOLDERS

Utrzymujący blokadę. Formatem utrzymującego jest: PID,COMMAND,FD. Jeśli blokada jest blokadą opisu otwartego pliku (ODF), może wystąpić kilku utrzymujących. Zob. UWAGI poniżej.

ŚRODOWISKO

LSLOCKS_COLUMNS=

Określa rozdzieloną przecinkiem listę kolumn wyjściowych do wypisania. Można stosować wszystkie kolumny podane opcją --list-columns.

Polecenie lslocks służy zastąpieniu polecenia lslk(8), pierwotnie napisanego przez Victora A. Abella <abe@purdue.edu>, które nie jest utrzymywane od 2001 r.

"Proces utrzymujący blokadę" w przypadku dzierżaw, blokad FLOCK oraz blokad opisu otwartego pliku (ODF) jest nieprawidłowym pojęciem. Są one związane z opisem otwartego pliku, na których są uzyskiwane. Z pomocą fork(2) i/lub cmsg(3), wiele procesów może dzielić opis otwartego pliku. Zatem nie da się wskazać jednego procesu utrzymującego dzierżawę (lub blokady). lslocks pokazuje jeden z procesów utrzymujących w kolumnach COMMAND i PID.

Domyślne wyjście programu może się zmienić. Jeśli to możliwe, należy zatem unikać używania domyślnego wyjścia w swoich skryptach.

W przypadku blokad opisu otwartego pliku (OFD), kolumna PID może pokazywać -1. Takich wierszy nie da się wybrać za pomocą filtra, ponieważ jego aktualny silnik nie obsługuje liczb ujemnych.

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

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

Problemy należy zgłaszać w systemie śledzenia błędów https://github.com/util-linux/util-linux/issues.

Polecenie lslocks jest częścią pakietu util-linux, który można pobrać ze strony Archiwum jądra Linux https://www.kernel.org/pub/linux/utils/util-linux/.

2026-09-02 util-linux 2.42.3