blob: 7864e6efc996a1daaa3091e27bb7b4eb94c97105 [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-deb 1 2011\-08\-14 Debian\-Projekt dpkg\-Programmsammlung
.SH NAME
dpkg\-deb \- Debian\-Paketarchiv (.deb) Manipulationswerkzeug
.
.SH ÜBERSICHT
\fBdpkg\-deb\fP [\fIOption\fP...] \fIBefehl\fP
.
.SH BESCHREIBUNG
\fBdpkg\-deb\fP packt und entpackt Debian\-Archive und stellt Informationen über
sie breit.
.PP
Verwenden Sie \fBdpkg\fP, um Pakete auf Ihrem System hinzuzufügen oder zu
entfernen
.PP
Sie können \fBdpkg\-deb\fP durch Aufruf von \fBdpkg\fP mit beliebigen Optionen, die
Sie an \fBdpkg\-deb\fP übergeben wollen, aufrufen. \fBdpkg\fP erkennt, dass Sie
\fBdpkg\-deb\fP wollten und wird es für Sie ausführen.
.
.SH BEFEHLE
.TP
\fB\-b\fP, \fB\-\-build\fP \fIVerzeichnis\fP [\fIArchiv\fP|\fIVerzeichnis\fP]
Legt ein Debian\-Archiv aus dem Dateisystembaum, der in \fIVerzeichnis\fP
gespeichert ist, an. \fIVerzeichnis\fP muss ein \fBDEBIAN\fP\-Unterverzeichnis
aufweisen, das die Dateien mit Steuerinformation wie die control\-Datei
selbst enthält. Dieses Verzeichnis wird \fInicht\fP in dem Dateisystemarchiv
des Binärpakets auftauchen, sondern die Dateien selbst werden in den
Steuer\-Informationsbereich des Binärpakets gepackt.
Falls Sie nicht \fB\-\-nocheck\fP angeben, wird \fBdpkg\-deb\fP \fBDEBIAN/control\fP
lesen und es parsen. Es prüft sie auf Syntax\-Fehler und andere Probleme und
zeigt den Namen des zu bauenden Binärpakets an. \fBdpkg\-deb\fP wird auch die
Rechte der Betreuer\-Skripte und anderer Dateien im
\fBDEBIAN\fP\-Steuer\-Informationsverzeichnis prüfen.
Falls kein \fIArchiv\fP angegeben ist, wird \fBdpkg\-deb\fP das Paket in die Datei
\fIVerzeichnis\fP\fB.deb\fP schreiben.
Falls das anzulegende Archiv bereits existiert, wird es überschrieben.
Falls das zweite Argument ein Verzeichnis ist, wird \fBdpkg\-deb\fP in die Datei
\fIPaket\fP\fB_\fP\fIVersion\fP\fB_\fP\fIarch\fP\fB.deb\fP oder \fIPaket\fP\fB_\fP\fIVersion\fP\fB.deb\fP,
falls kein \fBArchitecture\fP\-Feld in der Paket\-Steuerdatei vorhanden ist,
schreiben. Wenn ein Zielverzeichnis statt einer Datei angegeben ist, darf
die Option \fB\-\-nocheck\fP nicht verwendet werden (da \fBdpkg\-deb\fP die
Paketsteuerdatei lesen und parsen muss, um den zu verwendenden Dateinamen zu
bestimmen).
.TP
\fB\-I\fP, \fB\-\-info\fP \fIArchiv\fP [\fISteuer\-Dateiname\fP ...]
Stellt Informationen über ein Binärpaketarchiv bereit.
Falls keine \fISteuer\-Dateiname\fPn angegeben sind, wird es eine
Zusammenfassung des Inhalts des Pakets sowie dessen Steuerdatei ausgeben.
Falls \fISteuer\-Dateiname\fPn angegeben sind, wird \fBdpkg\-deb\fP diese in der
angegebenen Reihenfolge ausgeben; falls einige der Komponenten nicht
vorhanden sind, wird es eine Fehlernachricht nach Stderr über jede ausgeben
und sich mit dem Status 2 beenden.
.TP
\fB\-W\fP, \fB\-\-show\fP \fIArchiv\fP
Stellt Informationen über Binärpaketarchive im Format dar, das mit dem
Argument \fB\-\-showformat\fP angegeben wurde. Das Standardformat zeigt den
Paketnamen und die Paketversion in einer Zeile, getrennt durch einen
Tabulator.
.TP
\fB\-f\fP, \fB\-\-field\fP \fIArchiv\fP [\fISteuer\-Feldname\fP ...]
Extrahiert die Informationen der control\-Datei aus einem Binärpaketarchiv.
Falls keine \fBSteuerdatei\-Feld\fPer angegeben sind, gibt es die gesamte
control\-Datei aus.
Falls welche angegeben sind, gibt \fBdpkg\-deb\fP ihren Inhalt in der
Reihenfolge aus, in der sie in der control\-Datei angegeben sind. Falls mehr
als ein \fBSteuerdatei\-Feld\fP angegeben ist, stellt \fBdpkg\-deb\fP jedem Inhalt
seinen Feldnamen (und einen Doppelpunkt mit Leerzeichen) voran.
Falls angeforderte Felder nicht gefunden werden wird kein Fehler gemeldet.
.TP
\fB\-c\fP, \fB\-\-contents\fP \fIArchiv\fP
Listet den Inhalt des Dateisystem\-Archivanteils des Paketarchivs auf. Die
Ausgabe erfolgt derzeit in dem Format, das von \fBtar\fP in der ausführlichen
Auflistung erstellt wird.
.TP
\fB\-x\fP, \fB\-\-extract\fP \fIArchiv\-Verzeichnis\fP
Extrahiert den Dateisystembaum aus einem Paketarchiv in das angegebene
Verzeichnis.
Beachten Sie, dass das Extrahieren eines Pakets in das Wurzelverzeichnis
\fInicht\fP zu einer korrekten Installation führt! Verwenden Sie \fBdpkg\fP zur
Paketinstallation.
\fIVerzeichnis\fP (aber nicht die übergeordneten) wird falls notwendig
angelegt. Seine Rechte werden angepasst, um mit dem Inhalt des Pakets
übereinzustimmen.
.TP
\fB\-X\fP, \fB\-\-vextract\fP \fIArchiv\-Verzeichnis\fP
Ist wie \fB\-\-extract\fP (\fB\-x\fP) mit \fB\-\-verbose\fP (\fB\-v\fP), das beim Arbeiten
eine Liste von extrahierten Dateien ausgibt.
.TP
\fB\-R\fP, \fB\-\-raw\-extract\fP \fIArchiv\-Verzeichnis\fP
Extrahiert den Dateisystembaum aus einem Paketarchiv in ein angegebenes
Verzeichnis und die Steuerinformationensdateien in das
DEBIAN\-Unterverzeichnis des angegebenen Verzeichnisses.
Das Zielverzeichnis (aber nicht übergeordnete) wird, falls notwendig,
angelegt.
.TP
\fB\-\-fsys\-tarfile\fP \fIArchiv\fP
Extrahiert die Dateisystembaum\-Daten aus einem Binärpaket und schickt sie
zur Standardausgabe im \fBtar\fP\-Format. Dies kann zusammen mit \fBtar\fP(1)
verwendet werden, um eine bestimmte Datei aus einem Paketarchiv zu
extrahieren. Das Eingabearchiv wird immer sequenziell verarbeitet.
.TP
\fB\-e\fP, \fB\-\-control\fP \fIArchiv\fP [\fIVerzeichnis\fP]
Extrahiert die Steuer\-Informationsdateien aus einem Paketarchiv in das
angegebene Verzeichnis.
Falls kein Verzeichnis angegeben ist, wird das Unterverzeichnis \fBDEBIAN\fP im
aktuellen Verzeichnis verwendet.
Das Zielverzeichnis (aber nicht übergeordnete) wird, falls notwendig,
angelegt.
.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\-\-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.
Die Zeichenkette darf jedes Statusfeld in der Form »${\fIFeldname\fP
referenzieren, eine Liste der möglichen Felder kann leicht mittels \fB\-I\fP für
das gleiche Paket ermittelt werden. Eine komplette Erläuterung der
Formatieroptionen (darunter die Escape\-Sequenzen und Feld\-Tabulatoren) kann
in der Erklärung der Option \fB\-\-showformat\fP von \fBdpkg\-query\fP(1) gefunden
werden.
Die Voreinstellung für dieses Feld ist "${Package}\et${Version}\en".
.TP
\fB\-z\fP\fIKomprimierstufe\fP
Gibt die Komprimierstufe an, die im Komprimier\-Backendprogramm beim Bau
eines Pakets verwendet werden soll. Standardmäßig ist dies 9 für Gzip und
Bzip2, 6 für Xz und Lzma.
.TP
\fB\-Z\fP\fIKomprimierart\fP
Gibt die Art der Komprimierung beim Bau eines Pakets an. Erlaubte Werte sind
\fIgzip\fP, \fIxz\fP, \fIbzip2\fP, \fIlzma\fP und \fInone\fP (voreingestellt ist \fIgzip\fP).
.TP
\fB\-\-new\fP
Stellt sicher, dass \fBdpkg\-deb\fP ein Archiv im »neuen« Format baut. Dies ist
die Voreinstellung.
.TP
\fB\-\-old\fP
Zwingt \fBdpkg\-deb\fP dazu, ein Archiv im »alten« Format zu bauen. Dieses 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.
.TP
\fB\-\-nocheck\fP
Unterdrückt die normalen Überprüfungen von \fBdpkg\-deb \-\-build\fP über die
vorgeschlagenen Inhalte eines Archivs. Damit können Sie jedes Archiv bauen,
das Sie möchten, egal wie defekt es ist.
.TP
\fB\-v\fP, \fB\-\-verbose\fP
Aktiviert ausführliche Ausgabe. Dies betrifft derzeit nur \fB\-\-extract\fP,
wodurch dieses sich wie \fB\-\-vextract\fP verhält.
.TP
\fB\-D\fP, \fB\-\-debug\fP
Aktiviert Fehlersuch\-Ausgaben debugging«). Dies ist nicht sehr
interessant.
.
.SH UMGEBUNG
.TP
\fBTMPDIR\fP
Falls gesetzt wird \fBdpkg\-deb\fP es als das Verzeichnis verwenden, in dem
temporäre Dateien und Verzeichnisse erstellt werden.
.
.SH FEHLER
\fBdpkg\-deb \-I\fP \fIPaket1\fP\fB.deb\fP \fIPaket2\fP\fB.deb\fP macht das Falsche.
\&\fB.deb\fP\-Dateien werden nicht authentifiziert; in der Tat gibt es noch nicht
mal eine klare Prüfsumme. (Abstraktere Werkzeuge wie APT unterstützten die
Authentifizierung von \fB.deb\fP\-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.)
Versuchen Sie nicht, nur mit \fBdpkg\-deb\fP Software zu installieren! Sie
müssen \fBdpkg\fP 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.
.
.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"
\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdselect\fP(1).
.
.SH AUTOR
Copyright \(co 1995\-1996 Ian Jackson
.sp
Dies ist Freie Software; lesen Sie die GNU General Public License Version 2
oder neuer für die Kopierbedingungen. Es gibt KEINE Haftung.