summaryrefslogtreecommitdiffstats
path: root/man/de/dpkg-query.pod
blob: bb368fd6d1c630910fc45cddfde15744d5655bce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 BEZEICHNUNG

dpkg-query - ein Werkzeug zur Abfrage der Dpkg-Datenbank

=head1 ÜBERSICHT

B<dpkg-query> [I<Option> …] I<Befehl>

=head1 BESCHREIBUNG

B<dpkg-query> ist ein Werkzeug, um Informationen über Pakete zu zeigen, die in der B<dpkg>-Datenbank aufgeführt sind.

=head1 BEFEHLE

=over 

=item B<-l>, B<--list> [I<Paketname-Muster> …]

Listet alle bekannten Pakete auf, deren Namen auf ein oder mehrere bestimmte Muster passen, unabhängig ihres Status. Dazu gehören alle echten und virtuellen Pakete, die in irgendeinem Abhängigkeitsbeziehungsfeld (wie B<Breaks>, B<Enhances> usw.) referenziert sind. Falls kein I<Paketname-Muster> angegeben ist, werden alle Pakete in I<%ADMINDIR%/status> aufgelistet. Dabei werden alle Pakete ausgeschlossen, die als „nicht-installiert“ markiert sind (d.h. früher endgültig entfernt wurden). Normale Shell-Platzhalter sind im I<Paketname-Muster> erlaubt. Beachten Sie, dass Sie wahrscheinlich I<Paketname-Muster> 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:

=over 

 dpkg-query -l 'libc6*'

=back

Die ersten drei Spalten der Ausgabe zeigen die gewünschte Aktion, den Paketstatus und Fehler, in dieser Reihenfolge.

Gewünschte Aktion:

=over 

=item u= unbekannt

=item i = Installieren

=item h = halten

=item r = entfernen

=item p = endgültig löschen

=back

Paketstatus:

=over 

=item n = nicht-installiert

=item c = Config-Dateien

=item H = halb-installiert

=item U = entpackt

=item F = halb-konfiguriert

=item W = Trigger-erwartend

=item t = Trigger-anhängig

=item i = installiert

=back

Fehler-Schalter:

=over 

=item E<lt>leerE<gt> = (kein)

=item R = Neuinstallation notwendig

=back

Ein Großbuchstabe als Status oder Fehler zeigt an, dass das Paket wahrscheinlich schwere Fehler verursachen wird. Bitte lesen Sie L<dpkg(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 B<-W> (B<--show>) und B<--showformat>, um das Ausgabeformat zu konfigurieren.

=item B<-W>, B<--show> [I<Paketname-Muster> …]

Wie die Option B<--list> wird dies alle Pakete auflisten, die auf das angegebene Muster passen. Allerdings kann die Ausgabe mit der Option B<--showformat> angepasst werden.

Das Vorgabeausgabeformat führt zu einer Zeile pro passendem Paket. Jede Zeile besteht aus dem Paketnamen und seiner installierten Version, getrennt durch einen Tabulator. Der Paketname wird durch den Architekturnamen qualifiziert, wenn das Feld B<Multi-Arch> mit dem Wert B<same> oder einer fremden Architektur, was eine Architektur ist, die weder die native noch B<all> ist, belegt ist.

=item B<-s>, B<--status> [I<Paketname> …]

Meldet den Zustand der angegebenen Pakete. Dies zeigt nur den Eintrag in der Datenbank der Zustände der installierten Pakete. Falls kein I<Paketname> festgelegt ist, werden alle Paketeinträge in der Statusdatenbank angezeigt (seit Dpkg 1.19.1). Wenn mehrere I<Paketname>-Einträge aufgeführt sind, werden die angeforderten Statuseinträge durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist.

=item B<-L>, B<--listfiles> I<Paketname> …

Führt Dateien auf, die durch I<Paketname> installiert wurden. Wenn mehrere I<Paketname>n aufgeführt sind, werden die angeforderten Dateilisten durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist.

Jede Dateiumleitung wird auf seiner eigenen Zeile nach der umgeleiteten Datei ausgegeben, wobei eine der folgenden lokalisierten Zeichenketten vorangestellt wird:

Z<>
  lokal umgeleitet zu: I<umgeleitet-zu>
  Paket leitet andere um zu: I<umgeleitet-zu>
  umgeleitet durch I<Paket> zu: I<umgeleitet-zu>

B<Tipp>: Wenn Maschinen die Ausgabe auswerten, ist es üblich, die Locale auf B<C.UTF-8> zu setzen, um reproduzierbare Ausgaben zu erhalten. Auf einigen Systemen könnte es auch notwendig sein, die Umgebungsvariable B<LANGUAGE> geeignet anzupassen, falls sie bereits gesetzt ist (siehe L<locale(7)>).

Dieser Befehl wird weder die zusätzlichen Dateien, die durch Betreuer-Skripte angelegt wurden, noch Alternativen aufführen.

=item B<--control-list> I<Paketname>

Führt Steuerdateien auf, die auf Ihrem System von I<Paketname> installiert wurden (seit Dpkg 1.16.5). Diese können als Eingabeargumente für B<--control-show> verwandt werden.

=item B<--control-show> I<Paketname> I<Steuerdatei>

Gibt die I<Steuerdatei>, die auf Ihrem System von I<Paketname> installiert wurde, auf der Standardausgabe aus (seit Dpkg 1.16.5).

=item B<-c>, B<--control-path> I<Paketname> [I<Steuerdatei>]

Listet die Pfade für Steuerdateien auf, die von I<Paketname> auf Ihrem System installiert wurden (seit Dpkg 1.15.4). Falls I<Steuerdatei> angegeben wurde, wird nur der Pfad für diese Steuerdatei aufgelistet, falls sie existiert.

B<Warnung>: Dieser Befehl ist veraltet, da er direkten Zugriff auf die interne Dpkg-Datenbank gibt. Bitte wechseln Sie stattdessen zu B<--control-list> und B<--control-show> für alle Fälle, in denen diese Befehle die gleichen Ergebnisse liefern. Solange es noch mindestens einen Fall gibt, in dem dieser Befehl benötigt wird (d.h. wenn ein beschädigendes Postrm-Betreuerskript entfernt werden muss), und solange es keine gute Lösung dafür gibt, wird dieser Befehl nicht entfernt.

=item B<-S>, B<--search> I<Dateiname-Suchmuster> …

Sucht nach Paketen, denen Dateien, die auf die bestimmten Muster passen, gehören. Die normalen Platzhalter („wildcards“) der Shell können in diesem Muster verwandt werden, wobei der Stern (B<*>) und das Fragezeichen (B<?>) auf einen Schrägstrich passen und der Rückwärtsschrägstrich (B<\>) als Maskierzeichen verwandt wird.

Falls das erste Zeichen im I<Dateiname-Suchmuster> keines aus ‚B<*[?/>’ ist, dann wird es als Teilzeichenkette-Vergleich betrachtet und implizit durch ‚B<*>’ eingeschlossen (wie in B<*>I<Dateiname-Suchmuster>B<*>). Falls die nachfolgende Zeichenkette etwas aus ‚B<*[?\>’ enthält, dann wird dies wie ein Glob-Muster behandelt, andernfalls werden alle abschließenden ‚B</>’ oder ‚B</.>’ entfernt und ein „literal path lookup“ durchgeführt.

Dieser Befehl wird weder die zusätzlichen Dateien, die durch Betreuer-Skripte angelegt wurden, noch Alternativen aufführen.

Das Ausgabeformat besteht aus einer Zeile pro passendem Muster, mit einer Liste von Paketen, die den Pfadnamen besitzen, getrennt durch Kommata (U+002C „B<,>“) und einem Leerzeichen (U+0020 „B< >“), gefolgt von einem Doppelpunkt (U+003A „B<:>“) und einem Leerzeichen, gefolgt durch den Pfadnamen. Wie in:

  Paketename1, Paketename2: Pfadname1
  Paketename3: Pfadname2

Dateiumleitungen werden mit den folgenden lokalisierten Zeichenketten ausgegeben:

Z<>
  Umleitung durch I<Paketname> von: I<umgeleitet-von>
  Umleitung durch I<Paketname> zu: I<umgeleitet-zu>

oder für lokale Umleitungen:

Z<>
  lokale Umleitung von: I<umgeleitet-von>
  lokale Umleitung zu: I<umgeleitet-zu>

B<Tipp>: Wenn Maschinen die Ausgabe auswerten, ist es üblich, die Locale auf B<C.UTF-8> zu setzen, um reproduzierbare Ausgaben zu erhalten.

=item B<-p>, B<--print-avail> [I<Paketname> …]

Zeigt Details über Pakete an, wie diese in I<%ADMINDIR%/available> vorliegen. Falls kein I<Paketname> festgelegt ist, werden alle in der Datenbank I<available> verfügbaren Paketeinträge angezeigt (seit Dpkg 1.19.1). Wenn mehrere I<Paketname>n aufgeführt sind, werden die angeforderten I<available>-Einträge durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist.

Benutzer APT-basierter Oberflächen sollten B<apt show> I<Paketname> verwenden, da die Datei I<available> nur bei der Benutzung von B<dselect> aktuell bleibt.

=item B<-?>, B<--help>

Zeigt einen Hinweis zum Aufruf und beendet das Programm.

=item B<--version>

Gibt die Version aus und beendet das Programm.

=back

=head1 OPTIONEN

=over 

=item B<--admindir=>I<Verz>

Ändert den Ablageort der B<dpkg>-Datenbank. Der Standardort ist I<%ADMINDIR%>.

=item B<--root=>I<Verzeichnis>

Setzt das Wurzelverzeichnis auf I<Verzeichnis>, wodurch das Administrationsverzeichnis auf „I<Verzeichnis>%ADMINDIR%“ gesetzt wird (seit Dpkg 1.21.0).

=item B<--load-avail>

Lädt auch die „available“-Datei, wenn die Befehle B<--show> und B<--list> verwandt werden, die jetzt standardmäßig nur die Statusdatei laden (seit Dpkg 1.16.2).

=item B<--no-pager>

Deaktiviert die Verwendung jeglichen Pagers bei der Anzeige von Informationen (seit Dpkg 1.19.2).

=item B<-f>, B<--showformat=>I<Format>

Diese Option wird dazu verwendet, das Format der Ausgabe anzugeben, das B<--show> verwenden wird (kurze Option seit Dpkg 1.13.1). Das Format ist eine Zeichenkette, die für jedes aufgeführte Paket ausgegeben wird.

In der Formatzeichenkette leitet „B<\>“ Maskiersequenzen ein:

=over 

=item B<\n> Zeilenumbruch

=item B<\r> Wagenrücklauf

=item B<\t> Tabulator

=back

„B<\>“ vor einem anderen Zeichen unterdrückt jede spezielle Bedeutung des folgenden Zeichens. Dies ist für „B<\>“ und „B<$>“ nützlich.

Paketinformationen können einbezogen werden, indem Variablenreferenzen auf Paketfelder eingefügt werden. Hierbei wird folgende Syntax verwendet: „B<${>I<Feld>[B<;>I<Breite>]B<}>“. Felder werden rechtsbündig ausgegeben, falls die Breite nicht negativ ist und somit linksbündige Ausgabe erfolgt. Die folgenden I<Feld>er 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):

=over 

=item B<Architecture>

=item B<Bugs>

=item B<Conffiles> (intern)

=item B<Config-Version> (intern)

=item B<Conflicts>

=item B<Breaks>

=item B<Depends>

=item B<Description>

=item B<Enhances>

=item B<Protected>

=item B<Essential>

=item B<Filename> (intern, Oberflächen-bezogen)

=item B<Homepage>

=item B<Installed-Size>

=item B<MD5sum> (intern, Oberflächen-bezogen)

=item B<MSDOS-Filename> (inter, Oberflächen-bezogen)

=item B<Maintainer>

=item B<Origin>

=item B<Package>

=item B<Pre-Depends>

=item B<Priority>

=item B<Provides>

=item B<Recommends>

=item B<Replaces>

=item B<Revision> (veraltet)

=item B<Section>

=item B<Size> (intern, Oberflächen-bezogen)

=item B<Source>

=item B<Status> (intern)

=item B<Suggests>

=item B<Tag> (normalerweise nicht im .deb, sondern in Depot-Packages-Dateien)

=item B<Triggers-Awaited> (intern)

=item B<Triggers-Pending> (intern)

=item B<Version>

=back

Die folgenden Felder sind virtuell, sie werden von B<dpkg-query> aus Werten aus anderen Feldern erstellt (beachten Sie, dass diese keine gültigen Namen für Felder in Steuerdateien benutzen):

=over 

=item B<binary:Package>

Es enthält den Binärpaketnamen mit einer möglichen Architekturspezifikation wie „libc6:amd64“ (seit Dpkg 1.16.2). Eine Architekturspezifikation dient dazu, einen eindeutigen Paketnamen zu erzeugen, für Pakete mit einem Feld B<Multi-Arch> mit dem Wert B<same> oder mit einer fremden Architektur, die eine Architektur ist, die weder nativ noch B<all> ist.

=item B<binary:Synopsis>

Es enthält die Kurzbeschreibung des Pakets (seit Dpkg 1.19.1).

=item B<binary:Summary>

Dies ist ein Alias für B<binary:Synopsis> (seit Dpkg 1.16.2).

=item B<db:Status-Abbrev>

Es enthält den abgekürzten Paketstatus (als drei Zeichen) wie „ii “ oder „iHR“ (seit Dpkg 1.16.2). Lesen Sie die Beschreibung von B<--list> für weitere Details.

=item B<db:Status-Want>

Es enthält den gewünschten Status des Pakets, Teil des Statusfeldes (seit Dpkg 1.17.11).

=item B<db:Status-Status>

Es enthält das Paketstatuswort, Teil des Statusfeldes (seit Dpkg 1.17.11).

=item B<db:Status-Eflag>

Es enthält den Paketstatusfehlerschalter, Teil des Statusfeldes (seit Dpkg 1.17.11).

=item B<db-fsys:Files>

Es enthält die Liste der Paketdateisystemeinträge, getrennt durch Zeilenumbrüche (seit Dpkg 1.19.3).

=item B<db-fsys:Last-Modified>

Es enthält den Zeitstempel in Sekunden des letzten Zeitpunkts, zu dem der Paketdateisystemeintrag geändert wurde (seit Dpkg 1.19.3).

=item B<source:Package>

Es enthält den Quellpaketnamen für dieses Binärpaket (seit Dpkg 1.16.2).

=item B<source:Version>

Es enthält die Quellpaketversion für dieses Binärpaket (seit Dpkg 1.16.2).

=item B<source:Upstream-Version>

Es enthält die Quellpaketversion der Originalautoren für dieses Binärpaket (seit Dpkg 1.18.16).

=back

Die Standard-Formatzeichenkette ist „B<${binary:Package}\t${Version}\n>“. 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 B<dpkg>-Betreuers und die installierte Version zu erhalten, könnten Sie Folgendes ausführen:

=over 

 dpkg-query -f='${binary:Package} ${Version}\t${Maintainer}\n' \
  -W dpkg

=back

=back

=head1 RÜCKGABEWERT

=over 

=item B<0>

Die angeforderte Abfrage wurde erfolgreich ausgeführt.

=item B<1>

Die angeforderte Abfrage schlug entweder ganz oder teilweise fehl, da keine Datei oder kein Paket gefunden wurde (außer für B<--control-path>, B<--control-list> und B<--control-show>, bei denen solche Fehler fatal sind).

=item B<2>

Fataler oder nicht behebbarer Fehler aufgrund eines ungültigen Befehlszeilenaufrufs oder Interaktionen mit dem System, wie Zugriffe auf die Datenbank, Speicherzuweisungen usw.

=back

=head1 UMGEBUNG

=head2 Externe Umgebung

=over 

=item B<SHELL>

Setzt das auszuführende Programm, wenn ein Befehl über eine Shell ausgeführt wird (seit Dpkg 1.19.2).

=item B<PAGER>

=item B<DPKG_PAGER>

Setzt den zu verwendenden Pager-Befehl (seit Dpkg 1.19.1), der mit „B<$SHELL -c>“ ausgeführt wird. Falls B<SHELL> nicht gesetzt ist, wird stattdessen „B<%DPKG_DEFAULT_SHELL%>“ verwandt. B<DPKG_PAGER> setzt die Umgebungsvariable B<PAGER> außer Kraft (seit Dpkg 1.19.2).

=item B<DPKG_ROOT>

Falls gesetzt und die Option B<--root> nicht angegeben wurde, wird dies als Dateisystemwurzelverzeichnis verwandt (seit Dpkg 1.21.0).

=item B<DPKG_ADMINDIR>

Falls gesetzt und die Option B<--admindir> nicht verwandt wurde, wird dies als Datenverzeichnis von B<dpkg> verwandt.

=item B<DPKG_DEBUG>

Setzt die Fehlersuchmaske (seit Dpkg 1.21.10) aus einem oktalen Wert. Die derzeit akzeptierten Schalter werden in der Option B<dpkg --debug> beschrieben, aber nicht alle dieser Schalter könnten Auswirkungen auf dieses Programm haben.

=item B<DPKG_COLORS>

Setzt den Farbmodus (seit Dpkg 1.18.5). Die derzeit unterstützten Werte sind: B<auto> (Vorgabe), B<always> und B<never>.

=back

=head2 Interne Umgebung

=over 

=item B<LESS>

Von B<dpkg-query> auf „B<-FRSXMQ>“ definiert, falls es nicht bereits gesetzt ist oder wenn ein Pager gestartet wird (seit Dpkg 1.19.2). Um das Vorgabeverhalten zu verändern, kann diese Variable auf einen anderen Wert einschließlich der leeren Zeichenkette voreingestellt werden oder die Variablen B<PAGER> oder B<DPKG_PAGER> können gesetzt werden, um bestimmte Optionen mit „B<-+>“ zu deaktivieren, beispielsweise B<DPKG_PAGER="less -+F">.

=back

=head1 SICHERHEIT

Abfrageaktionen sollten niemals Root benötigen und die Übertragung ihrer Ausführung auf nichtprivilegierte Benutzer mittels eines Werde-Root-Befehls kann Sicherheitsauswirkungen haben (wie eine Privilegieneskalation), beispielsweise wenn ein Seitenanzeigeprogramm von einem Werkzeug automatisch aufgerufen wird.

=head1 SIEHE AUCH

L<dpkg(1)>.


=head1 ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2023 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.