'\" t
.\"     Title: lsfd
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-02-04
.\"    Manual: Dienstprogramme für Benutzer
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "LSFD" "1" "2024-02-04" "util\-linux 2.39.3" "Dienstprogramme für Benutzer"
.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"
lsfd \- Dateideskriptoren auflisten
.SH "ÜBERSICHT"
.sp
\fBlsfd\fP [Option]
.SH "BESCHREIBUNG"
.sp
\fBlsfd\fP ist als ein moderner Ersatz für \fBlsof\fP(8) auf Linux\-Systemen gedacht.
Im Gegensatz zu \fBlsof\fP ist \fBlsfd\fP auf den Linux\-Kernel spezialisiert; es unterstützt Linux\-spezifische Funktionen wie Namensräume mit einfacherem Code. \fBlsfd\fP ist kein direkter Ersatz für \fBlsof\fP, da die Befehlszeilenschnittstellen und Ausgabeformate unterschiedlich sind.
.sp
Die Standardausgabe kann sich ändern. Daher sollten Sie vermeiden, die Standardausgabe in Ihren Skripten zu verwenden, wo immer es möglich ist. Definieren Sie in Umgebungen, wo eine stabile Ausgabe erforderlich ist, stets die erwarteten Spalten, indem Sie die Option \fB\-\-output\fP \fISpaltenliste\fP angeben.
.sp
\fBlsfd\fP verwendet Libsmartcols für die Formatierung und Filterung der Ausgabe. Siehe die Beschreibung der Option \fB\-\-output\fP für die Anpassung des Ausgabeformats und die Option \fB\-\-filter\fP für die Filterung. Mit \fBlsfd \-\-help\fP erhalten Sie eine Liste aller verfügbaren Spalten.
.SH "OPTIONEN"
.sp
\fB\-l\fP, \fB\-\-threads\fP
.RS 4
listet auf Thread\-Ebene auf.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
verwendet das JSON\-Ausgabeformat.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
gibt keine Überschriften aus.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIListe\fP
.RS 4
gibt an, welche Spalten ausgegeben werden sollen. Im Abschnitt \fBAUSGABESPALTEN\fP sehen Sie eine Liste aller verfügbaren Spalten.
.sp
Die voreingestellte Liste der Spalten kann erweitert werden, indem Sie die \fIListe\fP im Format +\fIListe\fP angeben (beispielsweise \fBlsfd \-o +DELETED\fP).
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
verwendet das Rohformat für die Ausgabe.
.RE
.sp
\fB\-\-notruncate\fP
.RS 4
kürzt den Text in Spalten nicht.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIPIDs\fP
.RS 4
sammelt Informationen nur zu den angegebenen Prozessen. \fIPIDs\fP ist eine Liste von Prozesskennungen, wobei die Einträge durch Kommata oder Leerraum getrennt sein können. Sie können diese Option mit \fBpidof\fP(1) verwenden. Siehe \fBFILTERBEISPIELE\fP.
.sp
Sowohl die Option \fB\-Q\fP mit einem Ausdruck, der die Prozesskennung (PID) enthält, z.B. \-Q (PID == 1), als auch die Option \fB\-p\fP, z.B. \-p 1, können das Gleiche ausgeben, aber die Option \fB\-p\fP ist effizienter, da sie in einem viel früheren Stadium der Verarbeitung als die Option \fB\-Q\fP agiert.
.RE
.sp
\fB\-i\fP[4|6], \fB\-\-inet\fP[=4|=6]
.RS 4
listet nur IPv4\-Sockets und/oder IPv6\-Sockets auf.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIAusdruck\fP
.RS 4
gibt nur die Dateien aus, welche die im \fIFilterausdruck\fP angegebenen Bedingungen erfüllen. Siehe auch \fBFILTERBEISPIELE\fP.
.RE
.sp
\fB\-C\fP, \fB\-\-counter\fP \fIBezeichnung\fP:\fIFilterausdruck\fP
.RS 4
gibt einen benutzerdefinierten Zähler zur Verwendung in der Ausgabe mit \fB\-\-summary\fP an. \fBlsfd\fP erstellt einen Zähler mit der angegebenen \fIBezeichnung\fP. Während des Sammelns der Informationen zählt \fBlsfd\fP die Dateien, die die Bedingungen des \fIFilterausdrucks\fP erfüllen und speichert die ermittelte Anzahl im Zähler mit der angegebenen \fIBezeichnung\fP. \fBlsfd\fP wendet die mit den \fB\-\-filter\fP\-Optionen angegebenen Filter vor dem Zählen an; Dateien, die von den Filtern ausgeschlossen werden, werden nicht gezählt.
.sp
Weitere Informationen zu \fIFilterausdrücken\fP finden Sie im Abschnitt \fBFILTERAUSDRUCK\fP. Die \fIBezeichnung\fP sollte weder \fI{\fP noch \fI:\fP enthalten. Indem Sie diese Option mehrfach angeben, können Sie mehrere Zähler definieren.
.sp
Siehe auch \fBZÄHLERBEISPIELE\fP.
.RE
.sp
\fB\-\-summary\fP[=\fIwann\fP]
.RS 4
steuert die Ausgabe der Zeilen der Zusammenfassung. Das optionale Argument \fIwann\fP kann \fBonly\fP, \fBappend\fP oder \fBnever\fP sein. Wenn das Argument \fIwann\fP weggelassen wird, wird die Vorgabe \fBonly\fP verwendet.
.sp
Die Zusammenfassung meldet Zähler. Ein Zähler besteht aus einer Bezeichnung und einem ganzzahligen Wert. Mit der Option \fB\-\-counter\fP können Sie einen Zähler definieren. Falls Sie keinen Zähler definieren, verwendet \fBlsfd\fP zur Erstellung der Zusammenfassung voreingestellte Zähler (Standardzähler).
.sp
ACHTUNG: Die gemeinsame Verwendung von \fB\-\-summary\fP und \fB\-\-json\fP könnte die Ausgabe unbrauchbar machen. Zulässig ist nur die Kombination von \fB\-\-summary\fP=\fBonly\fP und \fB\-\-json\fP.
.RE
.sp
\fB\-\-debug\-filter\fP
.RS 4
gibt die internen Datenstrukturen für den Filter aus und beendet das Programm. Dies ist nur für \fBlsfd\fP\-Entwickler nützlich.
.RE
.sp
\fB\-\-dump\-counters\fP
.RS 4
zeigt die in der Ausgabe mit \fB\-\-summary\fP verwendete Definition der Zähler an.
.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 "AUSGABESPALTEN"
.sp
Jede Spalte hat einen Typ. Die Typen werden in < und > eingefasst.
.sp
ACHTUNG: Die Namen und Typen der Spalten sind noch nicht stabil. Sie könnten in zukünftigen Veröffentlichungen geändert werden.
.sp
AINODECLASS <\f(CRZeichenkette\fP>
.RS 4
Klasse des anonymen Inodes.
.RE
.sp
ASSOC <\f(CRZeichenkette\fP>
.RS 4
Assoziation zwischen Datei und Prozess.
.RE
.sp
BLKDRV <\f(CRZeichenkette\fP>
.RS 4
Aus \fI/proc/devices\fP ermittelter Treibername des blockorientierten Geräts.
.RE
.sp
CHRDRV <\f(CRZeichenkette\fP>
.RS 4
Aus \fI/proc/devices\fP ermittelter Treibername des zeichenorientierten Geräts.
.RE
.sp
COMMAND <\f(CRZeichenkette\fP>
.RS 4
Befehlsname des Prozesses, welcher die Datei geöffnet hat.
.RE
.sp
DELETED <\f(CRboolesch\fP>
.RS 4
Erreichbarkeit aus dem Dateisystem.
.RE
.sp
DEV <\f(CRZeichenkette\fP>
.RS 4
Kennung des Geräts, welches die Datei enthält.
.RE
.sp
DEVTYPE <\f(CRZeichenkette\fP>
.RS 4
Gerätetyp (\fIblk\fP, \fIchar\fP oder \fInodev\fP).
.RE
.sp
ENDPOINT <\f(CRZeichenkette\fP>
.RS 4
IPC\-Endpunktinformation, wie aus dem Dateideskriptor ermittelt. Das format der spalte ergibt sich aus dem mit dem Dateideskriptor verbundenen Objekt:
.sp
FIFO\-Typ
.RS 4
\fIPID\fP,\fIBEFEHL\fP,\fIZUORDNUNG\fP[\-r][\-w]
.sp
Die letzten Zeichen ([\-r][\-w]) repräsentieren den Lese\- und/oder Schreibmodus des Endpunkts
.RE
.sp
\fBlsfd\fP sammelt Endpunkte innerhalb der Prozesse, die \fBlsfd\fP einliest; \fBlsfd\fP kann einige Endpunkte verfehlen, wenn Sie die Prozesse mit der Option \fB\-p\fP eingrenzen.
.RE
.sp
FD <\f(CRZahl\fP>
.RS 4
Dateideskriptor für die Datei.
.RE
.sp
FLAGS <\f(CRZeichenkette\fP>
.RS 4
Beim Öffnen der Datei angegebene Schalter.
.RE
.sp
FUID <\f(CRZahl\fP>
.RS 4
Benutzerkennung des Dateieigentümers.
.RE
.sp
INET.LADDR <\f(CRZeichenkette\fP>
.RS 4
Lokale IP\-Adresse.
.RE
.sp
INET.RADDR <\f(CRZeichenkette\fP>
.RS 4
IP\-Adresse der Gegenstelle.
.RE
.sp
INET6.LADDR <\f(CRZeichenkette\fP>
.RS 4
Lokale IPv6\-Adresse.
.RE
.sp
INET6.RADDR <\f(CRZeichenkette\fP>
.RS 4
IPv6\-Adresse der Gegenstelle.
.RE
.sp
INODE <\f(CRZahl\fP>
.RS 4
Inode\-Nummer.
.RE
.sp
KNAME <\f(CRZeichenkette\fP>
.RS 4
Roher Dateiname, ermittelt aus \f(CR/proc/\fP\fIPID\fP\f(CR/fd/\fP\fIDateideskriptor\fP oder \f(CR/proc/\fP\fIPID\fP\f(CR/map_files/\fP\fIRegion\fP.
.RE
.sp
KTHREAD <\f(CRboolesch\fP>
.RS 4
Gibt an, ob der Prozess ein Kernel\-Thread ist oder nicht.
.RE
.sp
MAJ:MIN <\f(CRZeichenkette\fP>
.RS 4
Gerätekennung für Spezialgeräte oder Kennung des Geräts, welches die Datei enthält.
.RE
.sp
MAPLEN <\f(CRZahl\fP>
.RS 4
Länge des Datei\-Mappings (in Speicherseiten).
.RE
.sp
MISCDEV <\f(CRZeichenkette\fP>
.RS 4
Diverses, aus \fI/proc/misc\fP ermitteltes zeichenorientiertes Gerät.
.RE
.sp
MNTID <\f(CRZahl\fP>
.RS 4
Einhängekennung.
.RE
.sp
MODE <\f(CRZeichenkette\fP>
.RS 4
Zugriffsmodus (rwx).
.RE
.sp
NAME <\f(CRZeichenkette\fP>
.RS 4
Verarbeitete Version von KNAME (meist mit KNAME identisch).
.sp
Einige Dateien haben spezielle Formate und Informationsquellen:
.sp
NETLINK
.RS 4
protocol=\fINETLINK.PROTOKOLL\fP[ lport=\fINETLINK.LPORT\fP[ group=\fINETLINK.GRUPPEN\fP]]
.RE
.sp
PACKET
.RS 4
type=\fISOCKETTYP\fP[ protocol=\fIPAKETPROTOKOLL\fP][ iface=\fIPAKETSCHNITTSTELLE\fP]
.RE
.sp
pidfd
.RS 4
pid=\fIZIEL\-PID\fP comm=\fIZIEL\-BEFEHL\fP nspid=\fIZIEL\-NAMENSRAUM\-PIDs\fP
.sp
\fBlsfd\fP bezieht \fITARGET\-PID\fP und \fITARGET\-NSPIDS\fP aus \f(CR/proc/\fP\fIPID\fP\f(CR/fdinfo/\fP\fIdd\fP.
.RE
.sp
PING
.RS 4
state=\fISOCKETSTATUS\fP[ id=\fIPING.ID\fP][ laddr=\fIINET.ADDRESSE.LOKAL\fP [ raddr=\fIINET.ADDRESSE.FERN\fP]]
.RE
.sp
PINGv6
.RS 4
state=\fISOCKETSTATUS\fP[ id=\fIPING.ID\fP][ laddr=\fIINET6.ADDRESSE.LOKAL\fP [ raddr=\fIINET6.ADDRESSE.FERN\fP]]
.RE
.sp
RAW
.RS 4
state=\fISOCK.STATE\fP[ protocol=\fIRAW.PROTOCOL\fP [ laddr=\fIINET.LADDR\fP [ raddr=\fIINET.RADDR\fP]]]
.RE
.sp
RAWv6
.RS 4
state=\fISOCK.STATE\fP[ protocol=\fIRAW.PROTOCOL\fP [ laddr=\fIINET6.LADDR\fP [ raddr=\fIINET6.RADDR\fP]]]
.RE
.sp
TCP, TCPv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fITCP.LADDR\fP [ raddr=\fITCP.RADDR\fP]]
.RE
.sp
UDP, UDPv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fIUDP.LADDR\fP [ raddr=\fIUDP.RADDR\fP]]
.sp
\fBlsfd\fP blendet \f(CRraddr=\fP aus, falls \fIUDP.FERNE\-ADRESSE\fP \f(CR0.0.0.0\fP und \fIUDP.FERNER\-PORT\fP 0 ist.
.RE
.sp
UDP\-LITE, UDPLITEv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fIUDPLITE.LADDR\fP [ raddr=\fIUDPLITE.RADDR\fP]]
.RE
.sp
UNIX\-STREAM
.RS 4
state=\fISOCKET.STATUS\fP[ path=\fIUNIX.PFAD\fP]
.RE
.sp
UNIX
.RS 4
state=\fISOCKET.STATUS\fP[ path=\fIUNIX.PFAD\fP] type=\fISOCKET.TYP\fP
.RE
.RE
.sp
NETLINK.GROUPS <\f(CRZahl\fP>
.RS 4
Netlink\-Multicast\-Gruppen.
.RE
.sp
NETLINK.LPORT <\f(CRZahl\fP>
.RS 4
Lokale Netlink\-Port\-ID.
.RE
.sp
NETLINK.PROTOCOL <\f(CRZeichenkette\fP>
.RS 4
Netlink\-Protokoll.
.RE
.sp
NLINK <\f(CRZahl\fP>
.RS 4
Anzahl der Links.
.RE
.sp
NS.NAME <\f(CRZeichenkette\fP>
.RS 4
Name (\fINS.TYPE\fP:[\fIINODE\fP]) of the namespace specified with the file.
.RE
.sp
NS.TYPE <\f(CRZeichenkette\fP>
.RS 4
Typ des mit der Datei angegebenen Namensraums. Der Typ ist »mnt«, »cgroup«, »uts«, »ipc«, »user«, »pid«, »net«, »time« oder »unknown«.
.RE
.sp
OWNER <\f(CRZeichenkette\fP>
.RS 4
Eigentümer der Datei.
.RE
.sp
PACKET.IFACE <\f(CRZeichenkette\fP>
.RS 4
Der mit dem Paket\-Socket verbundene Schnittstellenname.
.RE
.sp
PACKET.PROTOCOL <\f(CRZeichenkette\fP>
.RS 4
Dem Paket\-Socket zugehöriges L3\-Protokoll.
.RE
.sp
PARTITION <\f(CRZeichenkette\fP>
.RS 4
Aus \fI/proc/partition\fP ermittelter Gerätename des blockorientierten Geräts.
.RE
.sp
PID <\f(CRZahl\fP>
.RS 4
PID des Prozesses, der die Datei geöffnet hat.
.RE
.sp
PIDFD.COMM <\f(CRZeichenkette\fP>
.RS 4
Befehl des Prozesses, auf den der PID\-Dateideskriptor verweist.
.RE
.sp
PIDFD.NSPID <\f(CRZeichenkette\fP>
.RS 4
Value of NSpid field in \f(CR/proc/\fP\fIpid\fP\f(CR/fdinfo/\fP\fIfd\fP of the pidfd.
.sp
Zitat aus kernel/fork.c des Linux\-Quellbaums:
.RS 3
.ll -.6i
.sp
If pid namespaces are supported then this function will also print the pid of a given pidfd refers to for all descendant pid namespaces starting from the current pid namespace of the instance, i.e. the Pid field and the first entry in the NSpid field will be identical.
.sp
Note that this differs from the Pid and NSpid fields in /proc/<pid>/status where Pid and NSpid are always shown relative to the pid namespace of the procfs instance.
.br
.RE
.ll
.RE
.sp
PIDFD.PID <\f(CRZahl\fP>
.RS 4
PID des Prozesses, auf den der PID\-Dateideskriptor verweist.
.RE
.sp
PING.ID <`Zahl`>
.RS 4
ICMP echo request id used on the PING socket.
.RE
.sp
POS <\f(CRZahl\fP>
.RS 4
Dateiposition.
.RE
.sp
RAW.PROTOCOL <\f(CRZahl\fP>
.RS 4
Protokollnummer des Roh\-Sockets.
.RE
.sp
RDEV <\f(CRZeichenkette\fP>
.RS 4
Gerätekennung (falls es sich um eine Spezialdatei handelt).
.RE
.sp
SIZE <\f(CRZahl\fP>
.RS 4
Dateigröße.
.RE
.sp
SOCK.LISTENING <\f(CRboolesch\fP>
.RS 4
Listening socket.
.RE
.sp
SOCK.NETS <\f(CRZahl\fP>
.RS 4
Inode identifying network namespace where the socket belongs to.
.RE
.sp
SOCK.PROTONAME <\f(CRZeichenkette\fP>
.RS 4
Protokollname.
.RE
.sp
SOCK.STATE <\f(CRZeichenkette\fP>
.RS 4
Status des Sockets.
.RE
.sp
SOCK.TYPE <\f(CRZeichenkette\fP>
.RS 4
Typ des Sockets. Hier bedeutet der Typ der zweite Parameter des Socket\-Systemaufrufs:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
stream
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
dgram
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
raw
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
rdm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
seqpacket
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
dccp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
packet
.RE
.RE
.sp
SOURCE <\f(CRZeichenkette\fP>
.RS 4
Dateisystem, Partition oder das Gerät, welches die Datei enthält.
.RE
.sp
STTYPE <\f(CRZeichenkette\fP>
.RS 4
Rohe Dateitypen, wie von \fBstat\fP(2) zurückgegeben: BLK, CHR, DIR, FIFO, LINK, REG, SOCK oder UNKN.
.RE
.sp
TCP.LADDR <\f(CRZeichenkette\fP>
.RS 4
Local L3 (INET.LADDR or INET6.LADDR) address and local TCP port.
.RE
.sp
TCP.LPORT <\f(CRGanzzahl\fP>
.RS 4
Lokaler TCP\-Port.
.RE
.sp
TCP.RADDR <\f(CRZeichenkette\fP>
.RS 4
Remote L3 (INET.RADDR or INET6.RADDR) address and remote TCP port.
.RE
.sp
TCP.RPORT <\f(CRGanzzahl\fP>
.RS 4
Ferner TCP\-Port.
.RE
.sp
TID <\f(CRZahl\fP>
.RS 4
Threadkennung des Prozesses, welcher die Datei geöffnet hat.
.RE
.sp
TYPE <\f(CRZeichenkette\fP>
.RS 4
Cooked version of STTYPE. It is same as STTYPE with exceptions. For SOCK, print the value for SOCK.PROTONAME. For UNKN, print the value for AINODECLASS if SOURCE is anon_inodefs.
.RE
.sp
UDP.LADDR <\f(CRZeichenkette\fP>
.RS 4
Lokale IP\-Adresse und lokaler UDP\-Port.
.RE
.sp
UDP.LPORT <\f(CRGanzzahl\fP>
.RS 4
Lokaler UDP\-Port.
.RE
.sp
UDP.RADDR <\f(CRZeichenkette\fP>
.RS 4
IP\-Adresse und UDP\-Port der Gegenstelle.
.RE
.sp
UDP.RPORT <\f(CRGanzzahl\fP>
.RS 4
Ferner UDP\-Port.
.RE
.sp
UDPLITE.LADDR <\f(CRZeichenkette\fP>
.RS 4
Lokale IP\-Adresse und lokaler UDPLite\-Port.
.RE
.sp
UDPLITE.LPORT <\f(CRGanzzahl\fP>
.RS 4
Lokaler UDP\-Port.
.RE
.sp
UDPLITE.RADDR <\f(CRZeichenkette\fP>
.RS 4
IP\-Adresse und UDPLite\-Port der Gegenstelle.
.RE
.sp
UDPLITE.RPORT <\f(CRGanzzahl\fP>
.RS 4
Ferner UDP\-Port.
.RE
.sp
UID <\f(CRZahl\fP>
.RS 4
Benutzerkennung.
.RE
.sp
UNIX.PATH <\f(CRZeichenkette\fP>
.RS 4
Dateisystem\-Pfadname des UNIX\-Domain\-Sockets.
.RE
.sp
USER <\f(CRZeichenkette\fP>
.RS 4
Benutzer des Prozesses.
.RE
.SH "FILTERAUSDRUCK"
.sp
\fBlsfd\fP wertet den mit der Option \fB\-\-filter\fP übergebenen Filterausdruck jedes Mal aus, bevor eine Dateizeile ausgegeben wird. \fBlsfd\fP gibt die Zeile nur  aus, wenn das Ergebnis der Auswertung \fIwahr\fP ist.
.sp
Ein Ausdruck besteht aus Spaltennamen, wörtlich zu verarbeitenden Zeichen(folgen) und Operatoren wie: »DELETED«, »(PID == 1)«, »(NAME == "/etc/passwd")«, »(PID == 1) && DELETED«. \f(CRDELETED\fP, \f(CRPID\fP und \f(CRNAME\fP sind in diesem Beispiel Spaltennamen. »1« und »/etc/passwd« sind wortwörtlich zu verarbeitende Zeichen(folgen); »==« und »&&« sind Operatoren.
.sp
Vor der Auswertung ersetzt \fBlsfd\fP Spaltennamen in dem angegebenen Ausdruck durch die tatsächlichen Spaltenwerte in der Zeile. Es gibt drei verschiedene Datentypen: \fIboolesch\fP, \fIZeichenkette\fP und \fIZahl\fP (bzw. \fIAnzahl\fP oder \fINummer\fP). Für Spalten mit \fIbooleschen\fP Werten kann der Wert für sich allein stehen. Für \fIZeichenketten\fP\- und \fIZahl\fP\-Werte muss der Wert ein Operand eines Operators sein, beispielsweise »(PID == 1)«. Siehe \fBAUSGABESPALTEN\fP zu den Spaltentypen.
.sp
Eine wortwörtlich zu verarbeitende Zeichenfolge stellt einen Wert unmittelbar dar. Siehe BOOLLIT, STRLIT und NUMLIT. Verschiedene Datentypen haben eine verschiedene Syntax für diese Zeichenfolgen.
.sp
Ein Operator agiert mit einem oder zwei Operand(en). Ein Operator erwartet bestimmte Datentypen von seinen Operanden. Die Übergabe eines unerwarteten Datentyps an einen Operator verursacht einen Syntaxfehler.
.sp
Die Operatoren \fIand\fP, \fIor\fP, \fIeq\fP, \fIne\fP, \fIle\fP, \fIlt\fP, \fIge\fP, \fIgt\fP, \fI=~\fP, \fI!~\fP akzeptieren zwei Operanden. Alphabetisch benannte Operatoren haben an die Programmiersprache C angelehnte Aliase: \fI&&\fP, \fI||\fP, \fI==\fP, \fI!=\fP, \fI<\fP, \fI\(lA\fP, \fI>=\fP und \fI>\fP.
.sp
\fI!\fP ist der einzige Operator, der nur einen Operanden akzeptiert.
.sp
\fIeq\fP, \fIne\fP und deren Aliase erwarten Operanden des gleichen Datentyps. Die Übergabe dieser Operatoren liefert einen \fIbooleschen\fP Wert zurück.
.sp
\fIand\fP, \fIor\fP, \fInot\fP und deren Aliase erwarten Operanden \fIbooleschen\fP Datentyps. Die Übergabe dieser Operatoren liefert einen \fIbooleschen\fP Wert zurück.
.sp
\fIlt\fP, \fIle\fP, \fIgt\fP, \fIge\fP und deren Aliase erwarten Operanden des Datentyps \fIZahl\fP. Die Übergabe dieser Operatoren liefert einen \fIbooleschen\fP Wert zurück.
.sp
\fI=~\fP dient der Trefferfindung für reguläre Ausdrücke. Falls eine Zeichenkette auf der rechten Seite einem regulären Ausdruck an der linken Seite entspricht, ist das Ergebnis \fIwahr\fP. Der Operand auf der rechten Seite muss eine wortwörtliche Zeichenkette sein. Siehe STRLIT zur Syntax.
.sp
\fI!~\fP ist eine Abkürzung von »not (ZEICHENKETTE =~ MUSTER)«; sie kehrt das Ergebnis von \fI=~\fP um.
.SS "Einschränkungen"
.sp
Die aktuelle Implementierung definiert keine Rangfolge unter den Operatoren. Mit \fI(\fP und \fI)\fP können Sie die Unterausdrücke explizit gruppieren, falls Ihr Ausdruck mehr als zwei Operatoren enthält.
.sp
Für Werte des Datentyps \fIZahl\fP unterstützt die Filter\-Engine nur Null oder nicht\-negative Ganzzahlen.
.SS "Semi\-formelle Syntax"
.sp
EXPR
.RS 4
BOOLEXP
.RE
.sp
BOOLEXP0
.RS 4
COLUMN <\f(CRboolesch\fP> | BOOLLIT | \fI(\fP BOOLEXP \fI)\fP
.RE
.sp
BOOLEXP
.RS 4
BOOLEXP0 | BOOLOP1 | BOOLOP2 | BOOLOP2BL | BOOLOP2CMP | BOOLOP2REG
.RE
.sp
COLUMN
.RS 4
[_A\-Za\-z][\-_:A\-Za\-z0\-9]*
.RE
.sp
BOOLOP1
.RS 4
\fI!\fP BOOLEXP0 | \fInot\fP BOOLEXP0
.RE
.sp
STREXP
.RS 4
COLUMN <\f(CRZeichenkette\fP> | STRLIT
.RE
.sp
NUMEXP
.RS 4
COLUMN <\f(CRZahl\fP> | NUMLIT
.RE
.sp
BOOLLIT
.RS 4
\fItrue\fP | \fIfalse\fP
.RE
.sp
CHARS
.RS 4
( [^\(rs] | \fI\(rs\(rs\fP | \fI\(rs\*(Aq\fP | \fI\(rs"\fP )*
.RE
.sp
STRLIT
.RS 4
\fI\*(Aq\fP CHARS \fI\*(Aq\fP | \fI"\fP CHARS \fI"\fP
.RE
.sp
NUMLIT
.RS 4
[1\-9][0\-9]* | \fI0\fP
.RE
.sp
BOOLOP2
.RS 4
STREXP OP2 STREXP | NUMEXP OP2 NUMEXP | BOOLEXP0 OP2 BOOLEXP0
.RE
.sp
OP2
.RS 4
\fI==\fP | \fIeq\fP | \fI!=\fP | \fIne\fP
.RE
.sp
BOOLOP2BL
.RS 4
BOOLEXP0 OP2BL BOOLEXP0
.RE
.sp
OP2BL
.RS 4
\fI&&\fP | \fIand\fP | \fI||\fP | \fIor\fP
.RE
.sp
BOOLOP2CMP
.RS 4
NUMEXP OP2CMP NUMEXP
.RE
.sp
OP2CMP
.RS 4
\fI<\fP | \fIlt\fP | \fI<=\fP | \fIle\fP | \fI>\fP | \fIgt\fP | \fI>=\fP | \fIge\fP
.RE
.sp
BOOLOP2REG
.RS 4
STREXP OP2REG STRLIT
.RE
.sp
OP2REG
.RS 4
\fI=~\fP | \fI!~\fP
.RE
.SH "FILTERBEISPIELE"
.sp
\fBlsfd\fP verfügt über einige Filteroptionen. In den meisten Fällen genügt es,
die Option \fB\-Q\fP (oder \fB\-\-filter\fP) zu kennen. In Kombination mit der Option
\fB\-o\fP (oder \fB\-\-output\fP) können Sie die Ausgabe nach Ihren Wünschen anpassen.
.sp
Die mit den mit den Prozesskennungen (PIDs) 1 und 2 assoziierten Dateien auflisten:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) oder (PID == 2)\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche auf alternative Weise:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) || (PID == 2)\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche auf effizientere Weise:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid 1,2
.fam
.fi
.if n .RE
.sp
Kommata statt Leerzeichen verwenden:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid \*(Aq1 2\*(Aq
.fam
.fi
.if n .RE
.sp
\fBpidof\fP(1) für eine Auflistung der Dateien verwenden, die mit »firefox« assoziiert sind:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid "$(pidof firefox)"
.fam
.fi
.if n .RE
.sp
Den ersten Dateideskriptor auflisten, der vom Prozess mit der Prozesskennung (PID) 1 geöffnet wurde:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) and (FD == 1)\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche auf alternative Weise:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) && (FD == 1)\*(Aq
.fam
.fi
.if n .RE
.sp
Alle laufenden ausführbaren Dateien auflisten:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqASSOC == "exe"\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche auf alternative Weise:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqASSOC eq "exe"\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche, aber nur Dateinamen ausgeben:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-o NAME \-Q \*(AqASSOC eq "exe"\*(Aq | sort \-u
.fam
.fi
.if n .RE
.sp
Gelöschte Dateien auflisten, die Prozessen zugeordnet sind:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqDELETED\*(Aq
.fam
.fi
.if n .RE
.sp
Nicht\-reguläre Dateien auflisten:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqTYPE != "REG"\*(Aq
.fam
.fi
.if n .RE
.sp
Blockorientierte Geräte auflisten:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqDEVTYPE == "blk"\*(Aq
.fam
.fi
.if n .RE
.sp
Das Gleiche, aber mit der Spalte TYP:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqTYPE == "BLK"\*(Aq
.fam
.fi
.if n .RE
.sp
Dateien auflisten, in deren Namen das Verzeichnis »dconf« enthalten ist:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqNAME =~ ".\(rs*/dconf/.*"\*(Aq
.fam
.fi
.if n .RE
.sp
In einer virtuellen QEMU\-Maschine geöffnete Dateien auflisten:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(COMMAND =~ ".\(rs*qemu.*") and (FD >= 0)\*(Aq
.fam
.fi
.if n .RE
.sp
Dateien ausblenden, die mit Kernel\-Threads assoziiert sind:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq!KTHREAD\*(Aq
.fam
.fi
.if n .RE
.SH "ZÄHLERBEISPIELE"
.sp
Die Anzahl der Netlink\-Socket\-Deskriptoren und Unix\-Socket\-Deskriptoren ausgeben:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-summary=only \(rs
        \-C \*(Aqnetlink sockets\*(Aq:\*(Aq(NAME =~ "NETLINK:.*")\*(Aq \(rs
        \-C \*(Aqunix sockets\*(Aq:\*(Aq(NAME =~ "UNIX:.*")\*(Aq
VALUE COUNTER
   57 netlink sockets
 1552 unix sockets
.fam
.fi
.if n .RE
.sp
Das Gleiche, aber im JSON\-Format ausgeben:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-summary=only \-\-json \(rs
        \-C \*(Aqnetlink sockets\*(Aq:\*(Aq(NAME =~ "NETLINK:.*")\*(Aq \(rs
        \-C \*(Aqunix sockets\*(Aq:\*(Aq(NAME =~ "UNIX:.*")\*(Aq
{
   "lsfd\-summary": [
      {
         "value": 15,
         "counter": "netlink sockets"
      },{
         "value": 798,
         "counter": "unix sockets"
      }
   ]
}
.fam
.fi
.if n .RE
.SH "GESCHICHTE"
.sp
Der Befehl \fBlsfd\fP ist Teil des Pakets util\-linux seit Version 2.38.
.SH "AUTOREN"
.sp
.MTO "yamato\(atredhat.com" "Masatake YAMATO" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "SIEHE AUCH"
.sp
\fBlsof\fP(8)
\fBpidof\fP(1)
\fBproc\fP(5)
\fBsocket\fP(2)
\fBstat\fP(2)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBlsfd\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.