blob: 8ab6d5b8ddf89ef6f43e19588e861fe8dcf6f885 [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-query 1 2011\-08\-14 Debian\-Projekt dpkg\-Programmsammlung
.SH NAME
dpkg\-query \- ein Werkzeug, um die dpkg\-Datenbank abzufragen
.
.SH ÜBERSICHT
\fBdpkg\-query\fP [\fIOption\fP...] \fIBefehl\fP
.
.SH BESCHREIBUNG
\fBdpkg\-query\fP ist ein Werkzeug, um Informationen über Pakete zu zeigen, die
in der \fBdpkg\fP\-Datenbank aufgeführt sind.
.
.SH BEFEHLE
.TP
\fB\-l\fP, \fB\-\-list\fP [\fIPaketname\-Muster\fP ...]
Liste Pakete auf, deren Namen auf ein bestimmtes Muster passt. Falls kein
\fIPaketname\-Muster\fP angegeben ist, liste alle Pakete in
\fI/var/lib/dpkg/status\fP auf. Dabei werden alle Pakete ausgeschlossen, die
als »nicht\-installiert markiert sind (d.h. früher endgültig entfernt
wurden). Beachten Sie, dass Sie wahrscheinlich \fIPaketname\-Muster\fP durch
Anführungszeichen schützen müssen, um die Shell an der Dateinamen\-Expansion
zu hindern. Folgender Befehl listet beispielsweise alle Paketnamen, die mit
»libc6« beginnen, auf:
.nf
\fBdpkg\-query \-l \(aqlibc6*\(aq\fP
.fi
Die ersten drei Spalten der Ausgabe zeigen die gewünschte Aktion, den
Paketstatus und Fehler, in dieser Reihenfolge.
Gewünschte Aktion:
.nf
u = Unbekannt
i = Installieren
h = Halten
r = Entfernen
p = Vollständig Löschen
.fi
Paketstatus:
.nf
n = Nicht installiert
c = Config\-Datei
H = Halb installiert
U = Entpackt
F = Fehlgeschl. Konfiguration
W = Trigger erWartet
t = Trigger anhängig
i = Installiert
.fi
Fehler\-Schalter:
.nf
<leer> = (kein)
R = Neuinstallation notwendig
.fi
Ein Großbuchstabe als Status oder Fehler zeigt an, dass das Paket
wahrscheinlich schwere Fehler verursachen wird. Bitte lesen Sie \fBdpkg\fP(1)
über die oben genannten Zustände und Schalter.
Das Ausgabeformat dieser Option kann nicht konfiguriert werden, variiert
aber automatisch mit der Terminalbreite. Die Ausgabe ist für menschliche
Leser gedacht und nicht leicht maschinenlesbar. Lesen Sie über die Optionen
\fB\-W\fP (\fB\-\-show\fP) und \fB\-\-showformat\fP, um das Ausgabeformat zu
konfigurieren.
.TP
\fB\-W\fP, \fB\-\-show\fP [\fIPaketname\-Muster\fP ...]
Genau wie die \fB\-\-list\fP\-Option wird dies alle Pakete, die auf das angegebene
Muster passen, aufführen. Allerdings kann die Ausgabe mit der
\fB\-\-showformat\fP\-Option angepasst werden. Im Standardausgabeformat wird eine
Zeile pro passendem Paket ausgegeben, wobei in jeder Zeile Name und
installierte Version des Pakets getrennt durch einen Tabulator enthalten
sind.
.TP
\fB\-s\fP, \fB\-\-status\fP \fIPaketname\fP ...
Berichte Zustand des angegebenen Paketes. Dies zeigt nur den Eintrag in der
Datenbank der Zustände der installierten Pakete. Wenn mehrere \fIPaketname\fP
aufgeführt sind, werden die angeforderten Statuseinträge durch Leerzeilen
getrennt.
.TP
\fB\-L\fP, \fB\-\-listfiles\fP \fIPaketname\fP ...
Aufführen von Dateien, die durch \fIPaketname\fP installiert wurden. Wenn
mehrere \fIPaketname\fP aufgeführt sind, werden die angeforderten Dateilisten
durch Leerzeilen getrennt. Beachten Sie aber, dass Dateien, die durch
Paket\-spezifische Installationsskripte angelegt wurden, nicht aufgeführt
werden.
.TP
\fB\-c\fP, \fB\-\-control\-path\fP \fIPaketname\fP [\fISteuerdatei\fP]
Listet die Pfade für Steuerdateien auf, die von \fIPaketname\fP auf Ihrem
System installiert wurden. Falls \fISteuerdatei\fP angegeben wurde, liste nur
den Pfad für diese Steuerdatei auf, falls sie existiert. \fBWarnung:\fP: Dieser
Befehl ist halb\-öffentlich, er sollte nur als letzter Rettungsanker verwandt
werden, falls keine weitere Schnittstelle verfügbar ist. Er könnte später
veraltet werden, falls bessere Schnittstellen oder die aktuellen,
Architektur\-bedingten Defizite gelöst wurden.
.TP
\fB\-S\fP, \fB\-\-search\fP \fIDateiname\-Suchmuster\fP ...
Suche nach Paketen, denen Paketen, die auf ein bestimmtes Muster passen,
gehören. Die normalen Jokerzeichen wildcards«) der Shell können in diesem
Muster verwandt werden. Dieser Befehl wird weder die zusätzlichen Dateien,
die durch Betreuer\-Skripte angelegt wurden, noch Alternativen aufführen.
.TP
\fB\-p\fP, \fB\-\-print\-avail\fP \fIPaketname\fP
Zeige Details über \fIPaketname\fP an, wie diese in \fI/var/lib/dpkg/available\fP
vorliegen. Wenn mehrere \fIPaketname\fP aufgeführt sind, werden die
angeforderten \fIavailable\fP\-Einträge durch Leerzeilen getrennt.
Benutzer APT\-basierter Oberflächen sollten \fBapt\-cache show\fP \fIPaketname\fP
verwenden, da die Datei \fIavailable\fP nur bei der Benutzung von \fBdselect\fP
aktuell bleibt.
.TP
\fB\-h\fP, \fB\-\-help\fP
Zeige den Bedienungshinweis und beende.
.TP
\fB\-\-version\fP
Gebe die Version aus und beende sich.
.
.SH OPTIONEN
.TP
\fB\-\-admindir=\fP\fIVerz\fP
Ändert den Ablageort der \fBdpkg\fP\-Datenbank. Der Standardort ist
\fI/var/lib/dpkg\fP.
.TP
\fB\-f\fP, \fB\-\-showformat=\fP\fIFormat\fP
Diese Option wird dazu verwendet, das Format der Ausgabe anzugeben, das
\fB\-\-show\fP verwenden wird. Das Format ist eine Zeichenkette, die für jedes
aufgeführte Paket ausgegeben wird.
In der Formatzeichenkette leitet \(lq\fB\e\fP\(rq Escape\-Sequenzen ein:
.nf
\fB\en\fP Zeilenumbruch
\fB\er\fP Wagenrücklauf
\fB\et\fP Tabulator
.fi
\(lq\fB\e\fP\(rq vor einem anderen Zeichen unterdrückt jede spezielle Bedeutung
des folgenden Zeichens. Dies ist für \(lq\fB\e\fP\(rq und \(lq\fB$\fP\(rq
nützlich.
Paketinformationen können einbezogen werden, indem Variablenreferenzen auf
Paketfelder eingefügt werden. Hierbei wird folgende Syntax verwendet:
\(lq\fB${\fP\fIFeld\fP[\fB;\fP\fIBreite\fP]\fB}\fP\(rq. Felder werden rechtsbündig
ausgegeben, falls die Breite nicht negativ ist und somit linksbündige
Ausgabe erfolgt. Die folgenden \fIFeld\fPer werden verstanden, sind aber nicht
notwendigerweise in der Status\-Datei verfügbar (nur interne Felder oder
Felder, die im Binärpaket abgespeichert sind, landen dort):
.nf
\fBArchitecture\fP
\fBBugs\fP
\fBConffiles\fP (intern)
\fBConfig\-Version\fP (intern)
\fBConflicts\fP
\fBBreaks\fP
\fBDepends\fP
\fBDescription\fP
\fBEnhances\fP
\fBEssential\fP
\fBFilename\fP (intern, Oberflächen\-bezogen)
\fBHomepage\fP
\fBInstalled\-Size\fP
\fBMD5sum\fP (intern, Oberflächen\-bezogen)
\fBMSDOS\-Filename\fP (intern, Oberflächen\-bezogen)
\fBMaintainer\fP
\fBOrigin\fP
\fBPackage\fP
\fBPre\-Depends\fP
\fBPriority\fP
\fBProvides\fP
\fBRecommends\fP
\fBReplaces\fP
\fBRevision\fP (veraltet)
\fBSection\fP
\fBSize\fP (intern, Oberflächen\-bezogen)
\fBSource\fP
\fBStatus\fP (intern)
\fBSuggests\fP
\fBTag\fP (normalerweise nicht in dem .deb sondern in den Packages\-Dateien des Depots
\fBTriggers\-Awaited\fP (intern)
\fBTriggers\-Pending\fP (intern)
\fBVersion\fP
.fi
Die Standard\-Formatzeichenkette ist
\(lq\fB${Package}\et${Version}\en\fP\(rq. Tatsächlich können auch alle anderen
Felder, die in der Statusdatei gefunden werden können
(d.h. benutzerdefinierte Felder), abgefragt werden. Sie werden so
dargestellt, wie sie gefunden werden, es erfolgt keine Umwandlung oder
Fehlerüberprüfung. Um den Namen des Dpkg\-Betreuers und die installierte
Version zu erhalten, könnten Sie folgendes ausführen:
.nf
\fBdpkg\-query \-W \-f=\(aq${Package} ${Version}\et${Maintainer}\en\(aq dpkg\fP
.fi
.
.SH RÜCKGABEWERT
.TP
\fB0\fP
Die angeforderte Abfrage wurde erfolgreich ausgeführt.
.TP
\fB1\fP
Beim Lesen der Kommandozeile oder beim Ausführen der Abfrage traten Probleme
auf. Dazu gehören auch keine Datei oder Paket gefunden (außer für
\-\-control\-path).
.
.SH UMGEBUNG
.TP
\fBDPKG_ADMINDIR\fP
Falls gesetzt und die Option \fB\-\-admindir\fP nicht verwandt wurde, wird dies
als Datenverzeichnis von Dpkg verwandt.
.TP
\fBCOLUMNS\fP
Diese Einstellung beeinflusst die Ausgabe der \fB\-\-list\fP\-Option durch
Verändern der Breite ihrer Ausgabe.
.
.SH AUTOR
Copyright \(co 2001 Wichert Akkerman
.sp
Dies ist Freie Software; lesen Sie die GNU General Public License Version 2
oder neuer für die Kopierbedingungen. Es gibt KEINE Haftung.
.
.SH ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2011 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.
.SH "SIEHE AUCH"
\fBdpkg\fP(1).