.\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH DEBDIFF 1 Debian\-Hilfswerkzeuge DEBIAN .SH BESCHREIBUNG debdiff \- vergleicht Dateilisten in zwei Debian\-Paketen .SH ÜBERSICHT \fBdebdiff\fP [\fIOptionen\fP] .br \fBdebdiff\fP [\fIOptionen\fP] … \fIdeb1 deb2\fP .br \fBdebdiff\fP [\fIOptionen\fP] … \fIÄnderungen1 Änderungen2\fP .br \fBdebdiff\fP [\fIOptionen\fP] … \fB\-\-from \fP\fIdeb1a deb1b … \fP\fB\-\-to \fP\fIdeb2a deb2b …\fP .br \fBdebdiff\fP [\fIOptionen\fP] … \fIdsc1 dsc2\fP .SH BESCHREIBUNG \fBdebdiff\fP nimmt die Namen zweier Debian\-Pakete (\fI.deb\fPs oder \fI.udeb\fPs) auf der Befehlszeile entgegen und vergleicht ihren Inhalt (dabei werden nur die Dateien im Hauptpaket berücksichtigt, nicht die Betreuerskripte). Es zeigt, welche Dateien eingeführt und welche zwischen den beiden Dateien entfernt wurden. Es ist daher nützlich, um Dateien ausfindig zu machen, die möglicherweise versehentlich zwischen zwei Revisionen des Pakets verloren gingen. Es prüft außerdem die Dateibesitzer und Zugriffsrechte und vergleicht die Steuerdateien der beiden Pakete mittels des Programms \fBwdiff\fP. .PP Falls kein Argument angegeben wurde, versucht \fBdebdiff\fP den Inhalt des aktuellen Quellverzeichnisses mit der letzten Version des Pakets zu vergleichen. .PP \fBdebdiff\fP kann außerdem Änderungen zwischen Gruppen von \fI.deb\fP\-Dateien auf zwei Arten handhaben. Die erste ist, zwei \fI.changes\fP\-Dateien anzugeben. In diesem Fall werden die in der \fI.changes\fP\-Datei aufgeführten Dateien verglichen, indem der Inhalt aller aufgelisteten \fI.deb\fP\-Dateien zusammengenommenen wird. (Es wird davon ausgegangen, dass die \&\fI.deb\fP\-Dateien im gleichen Verzeichnis liegen wie die \fI.changes\fP\-Datei.) Die zweite Art ist, die \fI.deb\fP\-Dateien von Interesse durch die Syntax \fB\-\-from\fP … \fB\-\-to\fP verwenden, aufzulisten. Diese beiden helfen, falls ein Paket in mehrere kleinere Pakete zerteilt wurde und sichergestellt werden soll, dass zwischenzeitlich nichts verloren ging. .PP \fBdebdiff\fP untersucht die \fBdevscripts\fP\-Konfigurationsdateien wie nachfolgend beschrieben. Befehlszeilenoptionen setzten jedoch die Konfigurationsdateieinstellungen außer Kraft. .PP Falls \fBdebdiff\fP zwei Quellpakete (\fI.dsc\fP\-Dateien) übergeben wurden, wird es den Inhalt der Quellpakete vergleichen. Falls sich die Quellpakete nur in der Debian\-Revisionsnummer unterscheiden (sprich, die \&\fI.orig.tar.gz\fP\-Dateien sind in beiden \fI.dsc\fP\-Dateien gleich), dann wird \fBinterdiff\fP(1) benutzt, um die beiden Patch\-Dateien zu vergleichen, falls das Programm auf dem System verfügbar ist. Andernfalls wird ein \fBdiff\fP zwischen beiden Quellverzeichnisbäumen durchgeführt. .SH OPTIONEN .TP \fB\-\-dirs\fP, \fB\-d\fP Im Standardbetriebsmodus werden Verzeichnisnamen, die in der Dateiliste auftauchen, ignoriert, sie werden aber, wenn diese Option angegeben wurde, berücksichtigt. .TP \fB\-\-nodirs\fP ignoriert Verzeichnisnamen, die in der Dateiliste erscheinen. Dies ist die Vorgabe und kann benutzt werden, um die Einstellungen der Konfigurationsdatei außer Kraft zu setzen. .TP \fB\-\-move\fP\fI VON BIS\fP,\fB \-m\fP\fI VON BIS\fP Manchmal kommt es vor, dass unterschiedliche Dateien oder Verzeichnisse zwischen Revisionen hin\- und hergeschoben werden. Dies kann mithilfe dieser Option gehandhabt werden. Es gibt zwei Argumente, das erste gibt den Speicherort des Verzeichnisses oder der Datei im ersten Paket an und das Zweite den im Zweiten. Alle Dateien in der ersten Auflistung, deren Namen mit dem ersten Argument beginnen, werden beim Vergleich der Dateilisten so angesehen, als ob dieses durch das zweite Argument ersetzt worden wäre. Jede beliebige Anzahl von \fB\-\-move\fP\-Argumenten kann angegeben werden; sie werden in der Reihenfolge verarbeitet, in der sie erscheinen. .TP \fB\-\-move\-regex\fP\fI VON BIS\fP Dies ist identisch mit \fB\-\-move\fP, außer dass \fIVON\fP als ein regulärer Ausdruck angesehen wird und der \fBperl\fP\-Ersetzungsbefehl \fIs/^VON/BIS/\fP auf die Dateien angewandt wird. Insbesondere kann BIS Gebrauch von Rückverweisen wie $1 machen. .TP \fB\-\-nocontrol\fP \fBdebdiff\fP wird normalerweise die jeweiligen Steuerdateien der Pakete mittels \fBwdiff\fP(1) vergleichen. Diese Option unterdrückt diesen Teil der Verarbeitung. .TP \fB\-\-control\fP vergleicht die jeweiligen Steuerdateien. Dies ist die Vorgabe und es kann verwendet werden, um eine Einstellung der Konfigurationsdatei außer Kraft zu setzen. .TP \fB\-\-controlfiles\fP\fI DATEI\fP[\fB,\fP\fIDATEI\fP …] gibt an, welche Steuerdateien verglichen werden sollen; standardmäßig ist dies nur \fIcontrol\fP, könnte aber auch \fIpostinst\fP, \fIconfig\fP und so weiter umfassen. Dateien werden nur verglichen, falls sie in beiden verglichenen \&\fI.debs\fP enthalten sind. Der Spezialwert \fIALL\fP vergleicht alle Steuerdateien, die es in beiden Paketen gibt, außer Md5sums. Diese Option kann benutzt werden, um eine Konfigurationsdateieinstellung außer Kraft zu setzen. .TP \fB\-\-wdiff\-source\-control\fP vergleicht Steuerdateien, wenn Quellpakete verarbeitet werden, mittels \fBwdiff\fP. Entspricht der Option \fB\-\-control\fP für Binärpakete. .TP \fB\-\-no\-wdiff\-source\-control\fP vergleicht keine Steuerdateien in Quellpaketen mittels \fBwdfiff\fP. Dies ist die Vorgabe. .TP \fB\-\-wp\fP, \fB\-\-wl\fP, \fB\-\-wt\fP übergibt eine \fB\-p\fP\-, \fB\-l\fP\- beziehungsweise \fB\-t\fP\-Option an \fBwdiff\fP. (Dies liefert die ganze \fBwdiff\fP\-Ausgabe statt nur den Zeilen mit irgendwelchen Änderungen). .TP \fB\-\-show\-moved\fP Falls mehrere \fI.deb\fP\-Dateien auf der Befehlszeile angegeben wurden, entweder mittels \fI.changes\fP\-Dateien oder der \fB\-\-from\fP\-/\fB\-\-to\fP\-Syntax, wird diese Option außerdem (falls vorhanden) Dateien anzeigen, die zwischen Paketen verschoben wurden. (Die Paketnamen werden einfach aus den Namen der \&\fI.deb\fP\-Dateien bestimmt.) .TP \fB\-\-noshow\-moved\fP das Standardverhalten; kann benutzt werden, um Konfigurationsdateieinstellungen außer Kraft zu setzen. .TP \fB\-\-renamed\fP\fI VON BIS\fP Falls \fB\-\-show\-moved\fP verwendet wird und ein Paket in dem Prozess umbenannt wurde, weist dieser Befehl \fBdebdiff\fP an, das Paket in der ersten, \fIVON\fP genannten Liste, so zu betrachten, als ob es \fIBIS\fP genannt würde. Es ist erlaubt, diese Option mehrfach zu benutzen. .TP \fB\-\-exclude\fP\fI MUSTER\fP schließt Dateien aus, auf die \fIMUSTER\fP passt. Es ist erlaubt, diese Option mehrfach zu benutzen. .TP \fB\-\-diffstat\fP beinhaltet das Ergebnis von \fBdiffstat\fP vor dem erzeugten Diff .TP \fB\-\-no\-diffstat\fP das Standardverhalten; kann benutzt werden, um Konfigurationsdateieinstellungen außer Kraft zu setzen. .TP \fB\-\-auto\-ver\-sort\fP Wenn Quellpakete verglichen werden, soll dies in der Reihenfolge ihrer Versionen getan werden. .TP \fB\-\-no\-auto\-ver\-sort\fP vergleicht zwei Quellpakete in der Reihenfolge, in der sie auf der Befehlszeile übergeben wurden, sogar, wenn dies bedeutet, dass ein Paket mit einer höheren Versionsnummer mit einem mit einer niedrigeren Version verglichen wird. Dies ist das Standardverhalten. .TP \fB\-\-unpack\-tarballs\fP Wenn Quellpakete verglichen werden, werden außerdem Tarballs entpackt, die auf der obersten Stufe des Quellverzeichnisbaums liegen, um ihren Inhalt zusammen mit den anderen Dateien zu vergleichen. Dies ist das Standardverhalten. .TP \fB\-\-no\-unpack\-tarballs\fP entpackt keine Tarballs innerhalb von Quellpaketen. .TP \fB\-\-no\-conf\fP, \fB\-\-noconf\fP keine Konfigurationsdateien lesen, Dies kann nur als erste auf der Befehlszeile angegebene Option benutzt werden. .TP \fB\-\-help\fP, \fB\-h\fP zeigt eine Zusammenfassung der Optionen. .TP \fB\-\-version\fP, \fB\-v\fP zeigt die Version und Copyright\-Informationen. .TP \fB\-\-quiet\fP, \fB\-q\fP ist still, wenn keine Unterschiede gefunden wurden. .TP \fB\-\-ignore\-space\fP, \fB\-w\fP ignoriert Leerräume in Diffs. .SH KONFIGURATIONSVARIABLEN Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fP und \fI~/.devscripts\fP werden durch eine Shell eingelesen, um Konfigurationsvariablen zu setzen. Befehlszeilenoptionen können benutzt werden, um Konfigurationsdateieinstellungen außer Kraft zu setzen. Einstellungen aus Umgebungsvariablen werden zu diesem Zweck ignoriert. Die derzeit bekannten Variablen sind: .TP \fBDEBDIFF_DIRS\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-dirs\fP benutzt würde. .TP \fBDEBDIFF_CONTROL\fP Falls dies auf \fIno\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-nocontrol\fP benutzt würde. Die Vorgabe ist \fIyes\fP. .TP \fBDEBDIFF_CONTROLFILES\fP welche Steuerdateien zu vergleichen sind, entspricht der Befehlszeilenoption \fB\-\-controlfiles\fP. Die Vorgabe ist \fIcontrol\fP. .TP \fBDEBDIFF_SHOW_MOVED\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-show\-moved\fP benutzt würde. .TP \fBDEBDIFF_WDIFF_OPT\fP Dieses Option wird an \fBwdiff\fP übergeben; sie sollte entweder \fB\-p\fP, \fB\-l\fP oder \fB\-t\fP sein. .TP \fBDEBDIFF_SHOW_DIFFSTAT\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-diffstat\fP benutzt würde. .TP \fBDEBDIFF_WDIFF_SOURCE_CONTROL\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-wdiff\-source\-control\fP benutzt würde. .TP \fBDEBDIFF_AUTO_VER_SORT\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-auto\-ver\-sort\fP benutzt würde. .TP \fBDEBDIFF_UNPACK_TARBALLS\fP Falls dies auf \fIyes\fP gesetzt ist, ist es so, als ob der Befehlszeilenparameter \fB\-\-no\-unpack\-tarballs\fP benutzt würde. .SH RÜCKGABEWERTE Normalerweise wird der Rückgabewert 0 sein, wenn keine Unterschiede gemeldet werden und 1, falls doch. Falls es irgendeinen schwerwiegenden Fehler gibt, wird der Rückgabewert 255 sein. .SH "SIEHE AUCH" \fBdiffstat\fP(1), \fBdpkg\-deb\fP(1), \fBinterdiff\fP(1), \fBwdiff\fP(1) und \fBdevscripts.conf\fP(5) .SH AUTOR \fBdebdiff\fP wurde ursprünglich als ein Shell\-Skript von Yann Dirson verfasst und neu in Perl mit viel mehr Funktionalitäten durch Julian Gilbey geschrieben. Die Software kann frei unter den Bestimmungen und Bedingungen der GNU General Public License, Version 2 weitergegeben werden.