BEZEICHNUNG¶

origtargz - ruft den Original-Tarball eines Debian-Pakets aus verschiedenen Quellen ab und entpackt ihn.

ÜBERSICHT¶

origtargz [OPTIONEN] [--unpack[=no| once|yes]]

origtargz --help

BESCHREIBUNG¶

origtargz lädt den Original-Tarball eines Debian-Pakets herunter und entpackt ihn optional in das aktuelle Verzeichnis. Die Versionsnummer, die benutzt werden soll, wird von debian/changelog bestimmt. origtargz wird hauptsächlich beim Auschecken von reinen Debian-Verzeichnissen benutzt. Es sollte von der obersten Verzeichnisebene eines entpackten Debian-Quellpakets aufgerufen werden. Es werden verschiedene Speicherorte zum Herunterladen ausprobiert:

•

Zuerst wird nach einer existierenden Datei gesucht.

•

Es werden mit --path angegebene Verzeichnisse durchsucht.

•

pristine-tar wird probiert.

•

Wenn apt-cache showsrc eine passende Version meldet, wird apt-get source probiert.

•

Am Ende wird --download-current-version versucht.

Wenn origtargz den Original-Tarball entpacken soll, wird es alle Dateien und Verzeichnisse außer dem Debian-Verzeichnis und den VCS-Depotverzeichnissen aus dem aktuellen Verzeichnis entfernen. Einige Dateien außerhalb von debian/, die oft im VCS gespeichert werden, auch für Depots aus reinen Debian-Verzeichnissen, werden ebenso aufbewahrt ( .bzr-builddeb, .gitignore, .hgignore). Beachten Sie, dass dadurch alle nicht übergebenen Änderungen für das benutzte Patch-System (z.B. Quellformat »3.0 (quilt)«) verworfen werden. Wenn kein Patch-System benutzt wird (das Originalquellformat »1.0«), werden sogar alle Patches des Pakets entfernt . Standardverhalten ist es, den Original-Tarball beim ersten Aufruf von origtargz beim Auschecken eines reinen Debian-Verzeichnisses zu entpacken.

ANMERKUNGEN¶

Obwohl origtargz »targz« heißt, funktioniert es mit jedem für den Tarball benutzten Komprimierungsverfahren. Ein ähnliches Werkzeug zum Entpacken von Tarballs ist uupdate(1). uupdate erstellt ein neues Arbeitsverzeichnis, entpackt den Tarball und wendet die Debian- .diff.gz-Änderungen an. Demgegenüber benutzt origtargz das aktuelle Verzeichnis und behält die VCS-Metadaten bei. Für Debian-Paketdepots, die die ganze Ursprungsquelle beibehalten, sollten andere Werkzeuge benutzt werden, um ein Upgrade des Depots von dem neuen Tarball durchzuführen. Siehe zum Beispiel git-import-orig(1) und svn-upgrade(1). origtargz ist immer noch zum Herunterladen des aktuellen Tarballs nützlich.

OPTIONEN¶

-p, --path Verzeichnis

fügt Verzeichnis der Liste von Orten hinzu, an denen nach einem existierenden Tarball gesucht wird. Wenn er gefunden wird, wird nach Möglichkeit ein harter, andernfalls ein symbolischer Verweis erzeugt.

-u, --unpack[=no|once|yes]

entpackt den heruntergeladenen Original-Tarball in das aktuelle Verzeichnis und ersetzt alles außer dem Debian-Verzeichnis. Existierende Dateien werden entfernt, mit Ausnahme der debian/ und VCS-Dateien. Aufbewahrt werden: .bzr, .bzrignore, .bzr-builddeb, .git, .gitignore, .hg, .hgignore, _darcs und .svn.

-d, --download-only

Alias für --unpack=no

-t, --tar-only

Wenn apt-get source benutzt wird, wird --tar-only daran übergeben. Standardmäßig wird die vollständige Quelle einschließlich der .dsc- und .diff.gz- oder .debian.tar.gz-Bestandteile heruntergeladen. Daher kann debdiff verwendet werden, um den Unterschied zwischen dem letzten Upload und dem nächsten zu ermitteln. Mit --tar-only wird nur die .orig.tar.*-Datei heruntergeladen.

--clean

entfernt existierende Dateien wie bei --unpack. Beachten Sie, dass dies wie --unpack die Ursprungsdateien auch dann entfernt, wenn sie im VCS gespeichert sind.

SIEHE AUCH¶

debcheckout(1), git-import-orig(1), pristine-tar(1), svn-upgrade(1), uupdate(1)

AUTOR¶

origtargz und diese Handbuchseite wurden von Christoph Berg < myon@debian.org> geschrieben.