'\" t
.\"     Title: lslocks
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: System-Administration
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "LSLOCKS" "8" "2026-09-02" "util\-linux 2.42.3" "System\-Administration"
.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 "BEZEICHNUNG"
lslocks \- lokale Systemsperren auflisten
.SH "ÜBERSICHT"
.sp
\fBlslocks\fP [Optionen]
.SH "BESCHREIBUNG"
.sp
\fBlslocks\fP zeigt Informationen zu allen aktuell gültigen Dateisperren auf einem Linux\-System an.
.SH "OPTIONEN"
.sp
\fB\-b\fP, \fB\-\-bytes\fP
.RS 4
gibt die Größe in Byte anstelle eines menschenlesbaren Formats aus.
.sp
Standardmäßig werden Größen in Einheiten angezeigt, die Potenzen von 1024 Bytes sind. Die formalen Abkürzungen für diese Einheiten (KiB, MiB, GiB usw.) werden weiter auf den Anfangsbuchstaben verkürzt: K, M, G usw.
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
listet die Spalten auf,die mit der Option \fB\-\-output\fP angegeben werden können. Wenn Sie dies zusammen mit \fB\-\-json\fP oder \fB\-\-raw\fP verwenden, wird die Liste in einem maschinenlesbaren Format angezeigt.
.RE
.sp
\fB\-i\fP, \fB\-\-noinaccessible\fP
.RS 4
Sperrdateien ignorieren, auf die der aktuelle Benutzer nicht zugreifen kann.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
verwendet das JSON\-Ausgabeformat.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
unterdrückt die Ausgabe einer Kopfzeile.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIListe\fP
.RS 4
gibt die anzuzeigenden Spalten an. Mit \fB\-\-help\fP erhalten Sie eine Liste aller unterstützten Spalten.
.sp
Die voreingestellte Liste der Spalten kann erweitert werden, indem Sie die \fIListe\fP im Format \fI+Liste\fP angeben (beispielsweise \fBlslocks \-o +BLOCKER\fP).
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
gibt alle verfügbaren Spalten aus.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIPID\fP
.RS 4
zeigt nur die Sperren an, die vom Prozess mit dieser \fIProzesskennung\fP eingerichtet wurden.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIAusdruck\fP
.RS 4
gibt nur die Sperren an, die den durch den \fIAusdruck\fP angegebenen Bedingungen entsprechen.
.sp
Dieses Funktionsmerkmal ist EXPERIMENTELL. Siehe auch \fBscols\-filter\fP(5). Wenn Sie zum Beispiel POSIX\-Sperren ausschließen, aber alle Sperren im Lesemodus für Dateien mit der Erweiterung \fI.qcow2\fP ausgeben wollen:
.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
verwendet das Rohformat für die Ausgabe.
.RE
.sp
\fB\-u\fP, \fB\-\-notruncate\fP
.RS 4
kürzt den Text in Spalten nicht.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
zeigt einen Hilfetext an und beendet das Programm.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
zeigt Versionsinformationen an und beendet das Programm.
.RE
.SH "UMGEBUNGSVARIABLEN"
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
aktiviert die Debug\-Ausgabe für libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
verwendet sichtbare Auffüllzeichen.
.RE
.SH "AUSGABE"
.sp
BEFEHL
.RS 4
Befehlsname des Prozesses, welcher die Sperre eingerichtet hat
.RE
.sp
PID
.RS 4
Die Prozess\-ID des Prozesses.
.RE
.sp
TYP
.RS 4
Typ der Sperre; kann LEASE sein (erzeugt mit \fBfcntl\fP(2)), FLOCK (erzeugt mit \fBflock\fP(2)), POSIX (erzeugt mit \fBfcntl\fP(2) und \fBlockf\fP(3)) oder OFDLCK (erzeugt mit \fBfcntl\fP(2)).
.RE
.sp
GRÖSSE
.RS 4
Größe der gesperrten Datei
.RE
.sp
INODE
.RS 4
Inode\-Nummer.
.RE
.sp
MAJ:MIN
.RS 4
Die MAJOR:MINOR\-Gerätenummer.
.RE
.sp
MODUS
.RS 4
Zugriffsrechte der Sperre (Schreiben, Lesen). Falls der Prozess blockiert ist und auf die Sperre wartet, dann wird dem Modus ein Asterisk (*) angehängt.
.RE
.sp
M
.RS 4
gibt an, ob die Sperre obligatorisch ist; 0 bedeutet nein (Sperre ist nur empfohlen), 1 bedeutet ja (siehe \fBfcntl\fP(2)).
.RE
.sp
START
.RS 4
relativer Byte\-Versatz der Sperre
.RE
.sp
END
.RS 4
End\-Versatz der Sperre
.RE
.sp
PATH
.RS 4
Vollständiger Pfad der Sperre. Wenn keiner gefunden wird oder die Zugriffsrechte zum Lesen des Pfades fehlen, wird der Einhängepunkt des Gerätes angezeigt und ".\|.\|." an den Pfad angehängt. Der Pfad kann gekürzt sein; verwenden Sie \fB\-\-notruncate\fP, um den vollständigen Pfad ausgeben zu lassen.
.RE
.sp
BLOCKER
.RS 4
PID des Prozesses, welcher die Sperre blockiert
.RE
.sp
HOLDERS
.RS 4
Der oder die Halter der Sperre. Das Format des Halters ist \fIPID\fP,\fIBEFEHL\fP,\fIDATEIDESKRIPTOR\fP. Falls eine Sperre an Dateideskriptoren orientierte Sperre ist, kann sie mehr als einen Halter haben. Siehe ANMERKUNGEN weiter unten.
.RE
.SH "UMGEBUNGSVARIABLEN"
.sp
LSLOCKS_COLUMNS=
.RS 4
gibt eine durch Kommas getrennte Liste der auszugebenden Spalten an. Alle durch \fB\-\-list\-columns\fP aufgeführten Spalten können verwendet werden.
.RE
.SH "ANMERKUNGEN"
.sp
Der Befehl \fBlslocks\fP soll den Befehl \fBlslk\fP(8) ersetzen, der ursprünglich von \c
.MTO "abe\(atpurdue.edu" "Victor A. Abell" ""
entwickelt und seit 2001 nicht mehr betreut wurde.
.sp
Die Angabe »Der Prozess, der die Sperre hält« für Leases, FLOCK\-Sperren und OFD\-Sperren ist ein Scheinkonzept. Sie sind mit der offenen Dateibeschreibung verknüpft, auf der sie erworben wurden. Mit \fBfork\fP(2) und/oder \fBcmsg\fP(3) können mehrere Prozesse eine offene Dateibeschreibung gemeinsam nutzen. Daher ist der Inhaberprozess eines Leases (oder einer Sperre) nicht eindeutig bestimmt. \fBlslocks\fP zeigt den Inhaberprozess in den Spalten BEFEHL und PID an.
.sp
Die standardmäßige Ausgabe kann sich ändern. Daher sollten Sie vermeiden, standardmäßige Ausgaben in Ihren Skripten zu verwenden, wo immer es möglich ist.
.sp
Bei OFD\-Sperren kann in der PID\-Spalte der Wert \-1 angezeigt werden. Solche Zeilen können vom Filter nicht ausgewählt werden, da die aktuelle Filter\-Engine keine negativen Zahlen unterstützt.
.SH "AUTOREN"
.sp
.MTO "dave\(atgnu.org" "Davidlohr Bueso" " "
.MTO "cgoesc2\(atwgu.edu" "Christian Goeschel Ndjomouo" ""
.SH "SIEHE AUCH"
.sp
\fBflock\fP(1), \fBfcntl\fP(2), \fBlockf\fP(3), \fBscols\-filter\fP(5)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das \c
.URL "https://github.com/util\-linux/util\-linux/issues" "Fehlererfassungssystem" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBlslocks\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.