'\" t
.\"     Title: lslocks
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "LSLOCKS" "8" "2026-09-02" "util\-linux 2.42.3" "Administracja systemem"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
lslocks \- wypisuje lokalne blokady systemowe
.SH "SKŁADNIA"
.sp
\fBlslocks\fP [opcje]
.SH "OPIS"
.sp
\fBlslocks\fP wypisuje informacje o wszystkich obecnie utrzymywanych blokadach plików w systemie Linux.
.SH "OPCJE"
.sp
\fB\-b\fP, \fB\-\-bytes\fP
.RS 4
Wypisuje rozmiar w bajtach, zamiast w postaci czytelnej dla człowieka.
.sp
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, .\|.\|..
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
Wypisuje kolumny, które można podać razem z opcją \fB\-\-output\fP. Można stosować w połączeniu z \fB\-\-json\fP lub \fB\-\-raw\fP, aby uzyskać wynik w formacie czytelnym maszynowo.
.RE
.sp
\fB\-i\fP, \fB\-\-noinaccessible\fP
.RS 4
Ignoruje blokady plików niedostępnych dla bieżącego użytkownika.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Używa formatu wyjściowego JSON.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Nie wypisuje nagłówka.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlista\fP
.RS 4
Określa wypisywane kolumny. Ich listę można poznać podając opcję \fB\-\-help\fP.
.sp
Domyślną listę kolumn można rozszerzyć, podając \fIlistę\fP w formacie \fI+lista\fP (np. \fBlslocks \-o +BLOCKER\fP).
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Wypisuje wszystkie dostępne kolumny.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIpid\fP
.RS 4
Wypisuje tylko blokady utrzymywane przez proces o identyfikatorze \fIpid\fP.
.RE
.sp
\-Q*, \fB\-\-filter\fP \fIwyrażenie\fP
.RS 4
Wypisuje tylko blokady spełniające warunki określone w wyrażeniu.
.sp
Funkcja ta jest EKSPERYMENTALNA. Zob. też \fBscols\-filter\fP(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:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lslocks \-\-filter \*(AqTYPE != "POSIX" and MODE == "READ" and PATH =~ ".*\(rs.qcow2"\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
Używa surowego formatu wyjściowego.
.RE
.sp
\fB\-u\fP, \fB\-\-notruncate\fP
.RS 4
Nie przycina tekstu w kolumnach.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "ŚRODOWISKO"
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
włącza wyjście debugowania libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
używa widocznych znaków wypełnienia.
.RE
.SH "WYJŚCIE"
.sp
COMMAND
.RS 4
Nazwa polecenia procesu utrzymującego blokadę.
.RE
.sp
PID
.RS 4
Identyfikator procesu.
.RE
.sp
TYPE
.RS 4
Typ blokady; może być to: LEASE (blokada utworzona przez \fBfcntl\fP(2)), FLOCK (utworzona przez \fBflock\fP(2)), POSIX (utworzona przez \fBfcntl\fP(2) i \fBlockf\fP(3)) lub OFDLCK (utworzona przez \fBfcntl\fP(2)).
.RE
.sp
SIZE
.RS 4
Rozmiar zablokowanego pliku.
.RE
.sp
INODE
.RS 4
Numer i\-węzła.
.RE
.sp
MAJ:MIN
.RS 4
Główny:poboczny numer urządzenia.
.RE
.sp
MODE
.RS 4
Uprawnienia dostępu blokady (odczyt, zapis). Jeśli proces jest zablokowany i czeka na blokadę, to po trybie jest doklejona "*" (gwiazdka).
.RE
.sp
M
.RS 4
Wskazuje czy blokada jest obowiązująca (przymusowa): 0 oznacza nie (blokada jest tylko doradcza), 1 oznacza tak (zob. \fBfcntl\fP(2)).
.RE
.sp
START
.RS 4
Względne przesunięcie bajtowe blokady.
.RE
.sp
END
.RS 4
Przesunięcie końca blokady.
.RE
.sp
PATH
.RS 4
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 \fB\-\-notruncate\fP pokaże pełną ścieżkę.
.RE
.sp
BLOCKER
.RS 4
PID procesu blokującego.
.RE
.sp
HOLDERS
.RS 4
Utrzymujący blokadę. Formatem utrzymującego jest: \fIPID\fP,\fICOMMAND\fP,\fIFD\fP. Jeśli blokada jest blokadą opisu otwartego pliku (ODF), może wystąpić kilku utrzymujących. Zob. UWAGI poniżej.
.RE
.SH "ŚRODOWISKO"
.sp
LSLOCKS_COLUMNS=
.RS 4
Określa rozdzieloną przecinkiem listę kolumn wyjściowych do wypisania. Można stosować wszystkie kolumny podane opcją \fB\-\-list\-columns\fP.
.RE
.SH "UWAGI"
.sp
Polecenie \fBlslocks\fP służy zastąpieniu polecenia \fBlslk\fP(8), pierwotnie napisanego przez \c
.MTO "abe\(atpurdue.edu" "Victora A. Abella" ","
które nie jest utrzymywane od 2001 r.
.sp
"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ą \fBfork\fP(2) i/lub \fBcmsg\fP(3), wiele procesów może dzielić opis otwartego pliku. Zatem nie da się wskazać jednego procesu utrzymującego dzierżawę (lub blokady). \fBlslocks\fP pokazuje jeden z procesów utrzymujących w kolumnach COMMAND i PID.
.sp
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.
.sp
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.
.SH "AUTORZY"
.sp
.MTO "dave\(atgnu.org" "Davidlohr Bueso" " "
.MTO "cgoesc2\(atwgu.edu" "Christian Goeschel Ndjomouo" ""
.SH "ZOBACZ TAKŻE"
.sp
\fBflock\fP(1), \fBfcntl\fP(2), \fBlockf\fP(3), \fBscols\-filter\fP(5)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBlslocks\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."