Manpages

BEZEICHNUNG

dpkg-deb - Manipulationswerkzeug für Debian-Paketarchive (.deb)

ÜBERSICHT

dpkg-deb [Option …] Befehl

BESCHREIBUNG

dpkg-deb packt und entpackt Debian-Archive und stellt Informationen über sie bereit.

Verwenden Sie dpkg, um Pakete auf Ihrem System hinzuzufügen oder zu entfernen.

Sie können dpkg-deb durch Aufruf von dpkg mit beliebigen Optionen, die Sie an dpkg-deb übergeben wollen, aufrufen. dpkg erkennt, dass Sie dpkg-deb wollten und wird es für Sie ausführen.

Bei den meisten Befehlen, die ein Archiv als Eingabeargument erwarten, kann der Archivname von der Standardeingabe gelesen werden, wenn er als einzelnes Minuszeichen („-“) angegeben ist. Falls dies nicht unterstützt wird, ist dies in der jeweiligen Beschreibung des Befehls dokumentiert.

BEFEHLE

-b, --build Programmverzeichnis [Archiv|Verzeichnis]

Legt ein Debian-Archiv aus dem Dateisystembaum, der in Programmverzeichnis gespeichert ist, an. Programmverzeichnis muss ein DEBIAN-Unterverzeichnis aufweisen, das die Dateien mit Steuerinformation wie die control-Datei selbst enthält. Dieses Verzeichnis wird nicht in dem Dateisystemarchiv des Binärpakets auftauchen, sondern die Dateien selbst werden in den Steuer-Informationsbereich des Binärpakets gepackt.

Falls Sie nicht --nocheck angeben, wird dpkg-deb DEBIAN/control lesen und es auswerten. Es prüft die Datei auf Syntax-Fehler und andere Probleme und zeigt den Namen des zu bauenden Binärpakets an. dpkg-deb wird auch die Rechte der Betreuer-Skripte und anderer Dateien im DEBIAN-Steuer-Informationsverzeichnis prüfen.

Falls kein Archiv angegeben ist, wird dpkg-deb das Paket in die Datei Programmverzeichnis.deb schreiben.

Falls das anzulegende Archiv bereits existiert, wird es überschrieben.

Falls das zweite Argument ein Verzeichnis ist, wird dpkg-deb in die Datei Verzeichnis/Paket_Version_Arch.deb. schreiben. Wenn ein Zielverzeichnis statt einer Datei angegeben ist, darf die Option --nocheck nicht verwendet werden (da dpkg-deb die Paketsteuerdatei lesen und auswerten muss, um den zu verwendenden Dateinamen zu bestimmen).

-I, --info Archiv [Steuer-Dateiname …]

Stellt Informationen über ein Binärpaketarchiv bereit.

Falls keine Steuer-Dateinamen angegeben sind, wird es eine Zusammenfassung des Inhalts des Pakets sowie dessen control-Datei ausgeben.

Falls Steuer-Dateinamen angegeben sind, wird dpkg-deb diese in der angegebenen Reihenfolge ausgeben; falls einige der Komponenten nicht vorhanden sind, wird es eine Fehlermeldung nach Stderr über jede ausgeben und sich mit dem Status 2 beenden.

-W, --show Archiv

Stellt Informationen über Binärpaketarchive im Format dar, das mit dem Argument --showformat angegeben wurde. Das Standardformat zeigt den Paketnamen und die Paketversion in einer Zeile, getrennt durch einen Tabulator.

-f, --field Archiv [Steuer-Feldname …]

Entpackt die Informationen der control-Datei aus einem Binärpaketarchiv.

Falls keine Steuer-Feldnamen angegeben sind, gibt es die gesamte control-Datei aus.

Falls welche angegeben sind, gibt dpkg-deb ihren Inhalt in der Reihenfolge aus, in der sie in der control-Datei angegeben sind. Falls mehr als ein Steuer-Feldname angegeben ist, stellt dpkg-deb jedem Inhalt seinen Feldnamen (und einen Doppelpunkt mit Leerzeichen) voran.

Falls angeforderte Felder nicht gefunden werden, wird kein Fehler gemeldet.

-c, --contents Archiv

Listet den Inhalt des Dateisystem-Archivanteils des Paketarchivs auf. Die Ausgabe erfolgt derzeit in dem Format, das von tar in der ausführlichen Auflistung erstellt wird.

-x, --extract Archiv Verzeichnis

Entpackt den Dateisystembaum aus einem Paketarchiv in das angegebene Verzeichnis.

Beachten Sie, dass das Entpacken eines Pakets in das Wurzelverzeichnis nicht zu einer korrekten Installation führt! Verwenden Sie dpkg zur Paketinstallation.

Verzeichnis (aber nicht die übergeordneten) wird, falls notwendig, angelegt. Seine Rechte werden angepasst, um mit dem Inhalt des Pakets übereinzustimmen.

-X, --vextract Archiv Verzeichnis

Ist wie --extract (-x) mit --verbose (-v), das beim Arbeiten eine Liste von entpackten Dateien ausgibt.

-R, --raw-extract Archiv Verzeichnis

Entpackt den Dateisystembaum aus einem Paketarchiv in ein angegebenes Verzeichnis und die Steuerinformationsdateien in das DEBIAN-Unterverzeichnis des angegebenen Verzeichnisses (seit Dpkg 1.16.1).

Das Zielverzeichnis (aber nicht übergeordnete) wird, falls notwendig, angelegt.

Das Eingebearchiv wird (derzeit) nicht sequenziell verarbeitet, daher wird das Einlesen von der Standardeingabe („-“) nicht unterstützt.

--ctrl-tarfile Archiv

Entnimmt die Steuerdaten aus einem Binärpaket und schickt sie zur Standardausgabe im tar-Format (seit Dpkg 1.17.14. Dies kann zusammen mit tar(1) verwendet werden, um eine bestimmte control-Datei aus einem Paketarchiv zu extrahieren. Das Eingabearchiv wird immer sequenziell verarbeitet.

--fsys-tarfile Archiv

Entnimmt die Dateisystembaumdaten aus einem Binärpaket und schickt sie zur Standardausgabe im tar-Format. Dies kann zusammen mit tar(1) verwendet werden, um eine bestimmte Datei aus einem Paketarchiv zu extrahieren. Das Eingabearchiv wird immer sequenziell verarbeitet.

-e, --control Archiv [Verzeichnis]

Entpackt die Steuer-Informationsdateien aus einem Paketarchiv in das angegebene Verzeichnis.

Falls kein Verzeichnis angegeben ist, wird das Unterverzeichnis DEBIAN im aktuellen Verzeichnis verwendet.

Das Zielverzeichnis (aber nicht übergeordnete) wird, falls notwendig, angelegt.

-?, --help

Zeigt einen Hinweis zum Aufruf und beendet das Programm.

--version

Gibt die Version aus und beendet das Programm.

OPTIONEN

--showformat=Format

Diese Option wird dazu verwendet, das Format der Ausgabe anzugeben, das --show verwenden wird. Das Format ist eine Zeichenkette, die für jedes aufgeführte Paket ausgegeben wird.

Die Zeichenkette darf jedes Statusfeld in der Form „${Feldname}“ referenzieren, eine Liste der möglichen Felder kann leicht mittels -I für das gleiche Paket ermittelt werden. Eine komplette Erläuterung der Formatieroptionen (darunter die Maskiersequenzen und Feld-Tabulatoren) kann in der Erklärung der Option --showformat von dpkg-query(1) gefunden werden.

Die Voreinstellung für dieses Feld ist „${Package}\t${Version}\n“.

-z, --compression-level=compress-level

Specify which compression level to use on the compressor backend, when building a package (default is 9 for gzip, 6 for xz, 3 for zstd; long option since dpkg 1.22.9). The accepted values are compressor specific. For gzip, from 0-9 with 0 being mapped to compressor none. For xz from 0-9. For zstd from 0-22, with levels from 20 to 22 enabling its ultra mode. Before dpkg 1.16.2 level 0 was equivalent to compressor none for all compressors.

-S, --compression-strategy=compress-strategy

Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2, long option since dpkg 1.22.9). Allowed values are none (since dpkg 1.16.4), filtered, huffman, rle and fixed for gzip (since dpkg 1.17.0) and extreme for xz.

-Z, --compression=compress-type

Specify which compression type to use when building a package (long option since dpkg 1.22.9). Allowed values are gzip, xz (since dpkg 1.15.6), zstd (since dpkg 1.21.18) and none (default is xz).

--[no-]uniform-compression

Gibt an, dass die gleichen Komprimierungsparameter für alle Archivteile (d.h. control.tar und data.tar; seit Dpkg 1.17.6) verwandt werden sollen. Andernfalls wird nur der Teil data.tar diese Parameter verwenden. Die einzigen unterstützten Kompressionstypen, die übergreifend benutzt werden dürfen, sind none, gzip, xz und zstd. Die Option --no-uniform-compression deaktiviert die übergreifende Komprimierung (seit Dpkg 1.19.0). Übergreifende Komprimierung ist die Vorgabe (seit Dpkg 1.19.0).

--threads-max=Threads

Setzt die maximale Anzahl an Threads, die für Komprimierer erlaubt sind, die multi-threaded Aktionen erlauben (seit Dpkg 1.21.9).

--root-owner-group

Setzt für jeden Eintrag in den Dateisystembaumdaten den Eigentümer und die Gruppe auf Kennung 0 (seit Dpkg 1.19.0).

Hinweis: Diese Option kann für rootloses Bauen (siehe rootless-builds.txt) nützlich sein, sollte aber nicht verwandt werden, wenn Einträge eine von root verschiedenen Eigentümer oder Gruppe haben. Die Unterstützung hierfür wird später in der Form eines Meta-Manifests hinzugefügt.

--deb-format=Format

Setzt das beim Bau verwandte Archivformat (seit Dpkg 1.17.0). Erlaubte Werte sind 2.0 für das neue Format und 0.939000 für das alte Format (Vorgabe ist 2.0).

Das alte Format wird nicht so leicht von nicht-Debian-Werkzeugen eingelesen und ist jetzt veraltet; der einzige Zweck ist zum Bau von Paketen, die von Dpkg-Versionen kleiner 0.93.76 (September 1995) eingelesen werden sollen. Diese Dpkg-Version wurde nur als i386 a.out-Programm veröffentlicht.

--nocheck

Unterdrückt die normalen Überprüfungen von dpkg-deb --build über die vorgeschlagenen Inhalte eines Archivs. Damit können Sie jedes Archiv bauen, das Sie möchten, egal wie defekt es ist.

-v, --verbose

Aktiviert ausführliche Ausgabe (seit Dpkg 1.16.1). Dies betrifft derzeit nur --extract, wodurch dieses sich wie --vextract verhält.

-D, --debug

Aktiviert Fehlersuchausgaben („debugging“). Dies ist nicht sehr interessant.

RÜCKGABEWERT

UMGEBUNG

DPKG_DEB_THREADS_MAX

Setzt die maximale Anzahl an Threads, die für Komprimierer erlaubt sind, die multi-threaded Aktionen erlauben (seit Dpkg 1.21.9).

Die Option --threads-max erlaubt das Hinwegsetzen über diesen Wert.

DPKG_DEB_COMPRESSOR_TYPE

Setzt den zu verwendenden Komprimiertyp (seit Dpkg 1.21.10).

Die Option -Z erlaubt das Hinwegsetzen über diesen Wert.

DPKG_DEB_COMPRESSOR_LEVEL

Setzt die zu verwendende Komprimierstufe (seit Dpkg 1.21.10).

Die Option -z erlaubt das Hinwegsetzen über diesen Wert.

DPKG_COLORS

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

DPKG_NLS

Falls dies gesetzt ist, wird es zur Entscheidung, ob Native Language Support, auch als Unterstützung für Internationalisierung (oder i18n) bekannt, aktiviert wird (seit Dpkg 1.22.7). Die akzeptierten Werte sind: 0 und 1 (Vorgabe).

TMPDIR

Falls gesetzt, wird dpkg-deb es als das Verzeichnis verwenden, in dem temporäre Dateien und Verzeichnisse erstellt werden.

SOURCE_DATE_EPOCH

Falls gesetzt, wird es als Zeitstempel (als Sekunden seit der Epoche) in dem ar(5)-Container von deb(5) und zum Festlegen der Mtime in den Dateieinträgen von tar(5) verwandt.

Seit Dpkg 1.18.8.

BEMERKUNGEN

Versuchen Sie nicht, nur mit dpkg-deb Software zu installieren! Sie müssen dpkg selber verwenden, um sicherzustellen, dass alle Dateien an den richtigen Ort platziert werden, die Paketskripte ausgeführt werden und sein Status und Inhalt aufgezeichnet wird.

SICHERHEIT

Untersuchen nicht vertrauenswürdiger Paketarchive oder ihr Entpacken in ein Arbeitsverzeichnis sollte als Sicherheitsgrenze betrachtet werden und jede Verletzung dieser Grenze, die aus diesen Aktionen resultiert, sollte als Sicherheitsverwundbarkeit betrachtet werden. Allerdings sollte der Umgang mit nicht vertrauenswürdigen Paketarchiven nicht leichtherzig erfolgen, da die Oberfläche alle unterstützten Komprimierungsbibliotheken umfasst, zusätzliche zu den Archivformaten und Steuerdateien selbst. Es wird nachdrücklich davon abgeraten, diese Aktionen auf nicht vertrauenswürdigen Daten als Root durchzuführen.

Das Bauen von Paketarchiven sollte nur mit vertrauenswürdigen Daten erfolgen.

FEHLER

dpkg-deb -I Paket1.deb Paket2.deb macht das Falsche.

.deb-Dateien werden nicht authentifiziert; in der Tat gibt es noch nicht mal eine klare Prüfsumme. (Abstraktere Werkzeuge wie APT unterstützen die Authentifizierung von .deb-Paketen, die von einem vorgegebenen Depot geholt wurden und die meisten Pakete stellen heutzutage eine md5sum-Steuerdatei bereit, die mittels debian/rules erstellt wurde. Allerdings wird dies von den Werkzeugen auf niedrigerer Ebene nicht direkt unterstützt.)

SIEHE AUCH

/usr/share/doc/dpkg/spec/rootless-builds.txt, deb(5), deb-control(5), dpkg(1), dselect(1).

ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2024 von Helge Kreutzmann <debian [AT] helgefjell.de>, 2007 von Florian Rehnisch <eixman [AT] gmx.de> und 2008 von Sven Joachim <svenjoac [AT] 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.