dpkg-source – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

dpkg-source – Debian-Quellpaket-Manipulationstool (.dsc).

ZUSAMMENFASSUNG

dpkg-Quelle [zu erhalten...] Befehl

BESCHREIBUNG

dpkg-Quelle packt und entpackt Debian-Quellarchive.

Keiner dieser Befehle ermöglicht die Kombination mehrerer Optionen zu einer, und das ist auch nicht der Fall
Ermöglicht die Angabe des Werts für eine Option in einem separaten Argument.

BEFEHLE

-x, --Extrakt Dateinamen.dsc [Ausgabe Verzeichnis]
Extrahieren Sie ein Quellpaket (--Extrakt seit Dpkg 1.17.14). Ein Nicht-Optionsargument
muss angegeben werden, der Name der Debian-Quellcodeverwaltungsdatei (.dsc). Eine optionale
Ein zweites Nicht-Optionsargument kann angegeben werden, um das Verzeichnis anzugeben, in das extrahiert werden soll
Quellpaket zu, dieses darf nicht existieren. Wenn kein Ausgabeverzeichnis angegeben ist, wird die
Das Quellpaket wird in ein Verzeichnis mit dem Namen extrahiert Quelle-Version unter dem Strom
Arbeitsverzeichnis.

dpkg-Quelle liest die Namen der anderen Dateien, aus denen das Quellpaket besteht
aus der Steuerdatei; Es wird davon ausgegangen, dass sie sich im selben Verzeichnis wie die befinden .dsc.

Für die Dateien im extrahierten Paket werden Berechtigungen und Besitzrechte festgelegt
zu denen, die zu erwarten gewesen wären, wenn die Dateien und Verzeichnisse einfach gewesen wären
erstellt wurde - Verzeichnisse und ausführbare Dateien werden 0777 sein und einfache Dateien werden es sein
sei 0666, beide modifiziert durch die umask der Extraktoren; wenn das übergeordnete Verzeichnis setgid ist
dann sind es auch die extrahierten Verzeichnisse und alle Dateien und Verzeichnisse
erbt seine Gruppeneigentümerschaft.

Wenn das Quellpaket ein nicht standardmäßiges Format verwendet (derzeit sind dies alle Formate).
außer „1.0“), wird sein Name in gespeichert debian/source/format so, dass die
Die folgenden Builds des Quellpakets verwenden standardmäßig dasselbe Format.

-b, --bauen Verzeichnis [formatspezifische-Parameter]
Erstellen Sie ein Quellpaket (--bauen seit Dpkg 1.17.14). Das erste Nicht-Optionsargument
wird als Name des Verzeichnisses verwendet, das den debianisierten Quellbaum enthält (d. h
mit einem Debian-Unterverzeichnis und möglicherweise Änderungen an den Originaldateien). Es hängt davon ab
Das Quellpaketformat, das zum Erstellen des Pakets verwendet wurde. Weitere Parameter können sein
akzeptiert.

dpkg-Quelle erstellt das Quellpaket mit dem ersten darin gefundenen Format
Geordnete Liste: das mit angegebene Format --Format Befehlszeilenoption, die
Format angegeben in debian/source/format, „1.0“. Der Fallback auf „1.0“ ist
veraltet ist und irgendwann in der Zukunft entfernt wird, sollten Sie dies immer tun
Dokumentieren Sie das gewünschte Quellformat in debian/source/format. Siehe Sektion SOURCE
PAKET FORMATEN für eine ausführliche Beschreibung der verschiedenen Quellpaketformate.

--print-format Verzeichnis
Drucken Sie das Quellformat aus, das zum Erstellen des Quellpakets verwendet würde, wenn
dpkg-Quelle --bauen Verzeichnis aufgerufen wurde (unter den gleichen Bedingungen und mit den gleichen
Parameter; seit Dpkg 1.15.5).

--before-build Verzeichnis
Führen Sie den entsprechenden Hook des Quellpaketformats aus (seit Dpkg 1.15.8). Das
Hook wird vor jedem Build des Pakets aufgerufen (dpkg-buildpaket nennt es sehr
schon früh debian/regeln reinigen). Dieser Befehl ist idempotent und kann aufgerufen werden
mehrmals. Nicht alle Quellformate implementieren etwas in diesem und jenen Hooks
die normalerweise den Quellbaum für den Build vorbereiten, indem sie beispielsweise sicherstellen, dass dies der Fall ist
Die Debian-Patches werden angewendet.

--after-build Verzeichnis
Führen Sie den entsprechenden Hook des Quellpaketformats aus (seit Dpkg 1.15.8). Das
Hook wird nach jedem Build des Pakets aufgerufen (dpkg-buildpaket nennt es zuletzt).
Dieser Befehl ist idempotent und kann mehrfach aufgerufen werden. Nicht alle Quellformate
Implementieren Sie etwas in diesem Hook, und diejenigen, die dies tun, verwenden es normalerweise, um etwas rückgängig zu machen
--before-build hat getan.

--verpflichten [Verzeichnis] ... ...
Zeichnen Sie Änderungen im entpackten Quellbaum auf Verzeichnis (seit Dpkg 1.16.1). Das
Der Befehl kann je nach Quellformat zusätzliche Parameter annehmen. Es wird
Fehler bei Formaten, bei denen dieser Vorgang keine Bedeutung hat.

-?, --help
Zeigen Sie die Verwendungsmeldung an und beenden Sie den Vorgang.

--Version
Version anzeigen und beenden.

OPTIONAL

Generisch bauen Optionen
-cKontrolldatei
Gibt die Hauptquellcodeverwaltungsdatei an, aus der Informationen gelesen werden sollen. Die Standardeinstellung ist
Debian / Kontrolle. Bei Angabe mit relativem Pfadnamen wird dieser beginnend bei interpretiert
das Verzeichnis der obersten Ebene des Quellbaums.

-lChangelog-Datei
Gibt die Änderungsprotokolldatei an, aus der Informationen gelesen werden sollen. Die Standardeinstellung ist
Debian/Änderungsprotokoll. Bei Angabe mit relativem Pfadnamen wird dieser beginnend bei interpretiert
das Verzeichnis der obersten Ebene des Quellbaums.

-FChangelog-Format
Gibt das Format des Änderungsprotokolls an. Sehen dpkg-parsechangelog(1) zur Information
über alternative Formate.

--format=Wert
Verwenden Sie das angegebene Format zum Erstellen des Quellpakets (seit Dpkg 1.14.17). Es tut
überschreibt jedes angegebene Format debian/source/format.

-VName=Wert
Legen Sie eine Ausgabesubstitutionsvariable fest. Sehen deb-substvars(5) für eine Diskussion von
Ausgabesubstitution.

-Tsubstvars-Datei
Substitutionsvariablen einlesen substvars-Datei; Standardmäßig wird keine Datei gelesen.
Diese Option kann mehrfach verwendet werden, um Substitutionsvariablen aus mehreren zu lesen
Dateien (seit Dpkg 1.15.6).

-DFeld=Wert
Überschreiben oder fügen Sie ein Ausgabesteuerdateifeld hinzu.

-UFeld
Entfernen Sie ein Ausgabesteuerdateifeld.

-ZWerkzeugen, --Kompression=Werkzeugen
Geben Sie die Komprimierung an, die für erstellte Tarballs und Diff-Dateien verwendet werden soll (--Kompression
seit Dpkg 1.15.5). Beachten Sie, dass diese Option nicht dazu führt, dass vorhandene Tarballs gelöscht werden
neu komprimiert, betrifft es nur neue Dateien. Unterstützte Werte sind: gzip, bzip2, lzma
und xz. Der Standardwert ist xz für Formate 2.0 und neuer, und gzip für Format 1.0. xz
wird erst seit Dpkg 1.15.5 unterstützt.

-zGrad des , --Kompressionsstufe=Grad des
Zu verwendende Komprimierungsstufe (--Kompressionsstufe seit Dpkg 1.15.5). Wie mit -Z it
betrifft nur neu erstellte Dateien. Unterstützte Werte sind: 1 zu 9, beste und schnell.
Die Standardeinstellung ist 9 für gzip und bzip2, 6 für xz und lzma.

-i[Regex], --diff-ignore[=Regex]
Sie können einen regulären Perl-Ausdruck angeben, um Dateien abzugleichen, aus denen Sie herausgefiltert werden möchten
die Liste der Dateien für das Diff (--diff-ignore seit Dpkg 1.15.6). (Diese Liste ist
wird durch einen Suchbefehl generiert.) (Wenn das Quellpaket als Version 3 erstellt wird
Quellpaket mithilfe eines VCS, dies kann verwendet werden, um nicht festgeschriebene Änderungen zu ignorieren
bestimmte Dateien. Mit -i.* werden alle ignoriert.)

Das -i Die Option allein aktiviert diese Einstellung mit einem Standard-Regex (unter Beibehaltung aller
Änderung des Standard-Regex durch eine vorherige Verwendung von --extend-diff-ignore)
Dadurch werden Steuerdateien und Verzeichnisse der häufigsten Revision herausgefiltert
Steuerungssysteme, Sicherungs- und Auslagerungsdateien und Libtool-Build-Ausgabeverzeichnisse. Dort
kann nur einer von mehreren aktiven regulären Ausdrücken sein -i Optionen werden nur von der letzten akzeptiert
Wirkung.

Dies ist sehr hilfreich beim Ausschneiden überflüssiger Dateien, die im Diff enthalten sind.
Wenn Sie beispielsweise Ihre Quelle in einem Revisionskontrollsystem verwalten und eine verwenden möchten
Auschecken, um ein Quellpaket zu erstellen, ohne die zusätzlichen Dateien einzuschließen und
Verzeichnisse, die es normalerweise enthält (z. B. CVS/, .cvsignore, .svn/). Der
Der Standard-Regex ist bereits sehr umfassend, aber wenn Sie ihn ersetzen müssen, bitte
Beachten Sie, dass es standardmäßig mit jedem Teil eines Pfads übereinstimmen kann. Wenn Sie also mit dem übereinstimmen möchten
Ob Sie den Anfang eines Dateinamens oder nur vollständige Dateinamen angeben möchten, Sie müssen die erforderlichen Angaben machen
Anker (z. B. '(^|/)', '($|/)') selbst.

--extend-diff-ignore=Regex
Der angegebene reguläre Perl-Ausdruck erweitert den von verwendeten Standardwert
--diff-ignore und sein aktueller Wert, falls gesetzt (seit Dpkg 1.15.6). Dies geschieht durch
verketten „|Regex” auf den vorhandenen Wert. Diese Option ist bequem zu verwenden
debian/source/options um einige automatisch generierte Dateien vom automatischen Patch auszuschließen
Generation.

-I[Dateimuster], --tar-ignore[=Dateimuster]
Wenn diese Option angegeben ist, wird das Muster an übergeben Teer(1) ist --ausschließen
Option, wenn sie zum Generieren einer .orig.tar- oder .tar-Datei aufgerufen wird (--tar-ignore da
dpkg 1.15.6). Zum Beispiel, -ICVS lässt tar CVS-Verzeichnisse überspringen, wenn
Generieren einer .tar.gz-Datei. Die Option kann zur Auflistung mehrmals wiederholt werden
mehrere Muster auszuschließen.

-I fügt von selbst Standard hinzu --ausschließen Optionen, die Steuerdateien herausfiltern und
Verzeichnisse der gängigsten Revisionskontrollsysteme, Backup- und Swap-Dateien und
Libtool erstellt Ausgabeverzeichnisse.

Hinweis: Obwohl sie ähnliche Zwecke verfolgen, -i und -I haben eine sehr unterschiedliche Syntax und
Semantik. -i kann nur einmal angegeben werden und akzeptiert einen Perl-kompatiblen regulären Ausdruck
Dies wird mit dem vollständigen relativen Pfad jeder Datei abgeglichen. -I kann mehrfach angegeben werden
mal und verwendet ein Dateinamenmuster mit Shell-Platzhaltern. Das Muster wird auf das angewendet
vollständigen relativen Pfad, sondern auch für jeden Teil des Pfads einzeln. Die genaue Semantik von
Teer --ausschließen Option ist etwas kompliziert, sehen Sie
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Der Standard-Regex und die Standardmuster für beide Optionen sind in der Ausgabe von zu sehen --help
Befehl.

Generisch Extrakt Optionen
--keine Kopie
Kopieren Sie keine Original-Tarballs in die Nähe des extrahierten Quellpakets (da dpkg
1.14.17).

--no-check
Überprüfen Sie Signaturen und Prüfsummen nicht vor dem Entpacken (seit Dpkg 1.14.17).

--require-valid-signature
Weigern Sie sich, das Quellpaket zu entpacken, wenn es keine OpenPGP-Signatur enthält
kann (seit Dpkg 1.15.0) entweder mit dem des Benutzers überprüft werden Trustedkeys.gpg Schlüsselbund,
einen der herstellerspezifischen Schlüsselringe oder einen der offiziellen Debian-Schlüsselringe
(/usr/share/keyrings/debian-keyring.gpg und
/usr/share/keyrings/debian-maintainers.gpg).

--ignore-bad-version
Wandelt die Überprüfung der fehlerhaften Quellpaketversion in eine nicht schwerwiegende Warnung um (seit dpkg
1.17.7). Diese Option sollte nur beim Extrahieren alter Quellen erforderlich sein
Pakete mit fehlerhaften Versionen, nur aus Gründen der Abwärtskompatibilität.

SOURCE PAKET FORMATEN

Wenn Sie nicht wissen, welches Quellformat Sie verwenden sollen, sollten Sie wahrscheinlich entweder „3.0 (Quilt)“ wählen.
oder „3.0 (nativ)“. Weitere Informationen dazu finden Sie unter https://wiki.debian.org/Projects/DebSrc3.0
Bereitstellung dieser Formate in Debian.

Format: 1.0
Ein Quellpaket in diesem Format besteht entweder aus a .orig.tar.gz verbunden mit a .diff.gz
oder eine einzelne .tar.gz (in diesem Fall soll das Paket sein nativen).

Extrahieren

Das Extrahieren eines nativen Pakets ist eine einfache Extraktion des einzelnen Tarballs im Ziel
Verzeichnis. Das Extrahieren eines nicht-nativen Pakets erfolgt, indem es zunächst entpackt wird .orig.tar.gz und
Anschließend wird der darin enthaltene Patch angewendet .diff.gz Datei. Der Zeitstempel aller gepatchten Dateien
wird auf die Extraktionszeit des Quellpakets zurückgesetzt (dies vermeidet Zeitstempelabweichungen).
zu Problemen, wenn automatisch generierte Dateien gepatcht werden). Das Diff kann neue Dateien erstellen (die
Das gesamte Debian-Verzeichnis wird auf diese Weise erstellt), es können jedoch keine Dateien entfernt werden (leere Dateien werden entfernt).
übrig bleiben).

Building

Beim Erstellen eines nativen Pakets wird lediglich ein einziger Tarball mit dem Quellverzeichnis erstellt.
Zum Erstellen eines nicht-nativen Pakets muss der ursprüngliche Tarball in einem separaten Paket extrahiert werden
„.orig“-Verzeichnis und Neugenerierung des .diff.gz durch Vergleich des Quellpakets Verzeichnis
mit dem .orig-Verzeichnis.

Bauen Optionen (mit --bauen):

Wenn ein zweites Nicht-Optionsargument angegeben wird, sollte es der Name der Originalquelle sein
Verzeichnis oder Tarfile oder die leere Zeichenfolge, wenn das Paket ein Debian-spezifisches ist und so
hat keine Debianisierungsunterschiede. Wenn kein zweites Argument angegeben wird, dann dpkg-Quelle aussehen wird
für die ursprüngliche Quell-Tardatei package_upstream-version.orig.tar.gz oder das Original
Quellverzeichnis Verzeichnis.orig abhängig von -sX Argumente.

-Sa, -sp, -sk, -so und -sr überschreibt keine vorhandenen TAR-Dateien oder Verzeichnisse. Wenn das ist
dann gewünscht -sA, -sP, -sK, -su und -Herr sollte stattdessen verwendet werden.

-sk Gibt an, dass die Originalquelle standardmäßig als TAR-Datei erwartet wird package_upstream-
Version.orig.tar.Erweiterung. Diese Originalquelle bleibt als erhalten
tarfile oder kopieren Sie es in das aktuelle Verzeichnis, falls es noch nicht vorhanden ist. Der Tarball
wird ausgepackt Verzeichnis.orig für die Generierung des Diff.

-sp Like -sk werde das Verzeichnis aber danach wieder entfernen.

-so Gibt an, dass die Originalquelle standardmäßig als Verzeichnis erwartet wird Paket-
Upstream-Version.orig und dpkg-Quelle erstellt ein neues Original-Quellarchiv
davon.

-sr Like -so Dieses Verzeichnis wird jedoch entfernt, nachdem es verwendet wurde.

-ss Gibt an, dass die Originalquelle sowohl als Verzeichnis als auch als verfügbar ist
Tardatei. dpkg-Quelle wird das Verzeichnis zum Erstellen des Diffs verwenden, die TAR-Datei jedoch dazu
erstellen Sie die .dsc. Diese Option muss mit Vorsicht verwendet werden – wenn das Verzeichnis und die TAR-Datei
nicht übereinstimmen, wird ein fehlerhaftes Quellarchiv generiert.

-schn Gibt an, dass nicht nach einer Originalquelle gesucht und kein Diff generiert werden soll. Der
Das zweite Argument, falls angegeben, muss die leere Zeichenfolge sein. Dies wird für Debian verwendet.
spezifische Pakete, die keine separate Upstream-Quelle haben und daher über eine verfügen
Keine Debianisierungsunterschiede.

-Sa or -sA
Gibt an, dass nach dem ursprünglichen Quellarchiv als TAR-Datei oder als Verzeichnis gesucht werden soll.
Das zweite Argument, falls vorhanden, kann entweder oder die leere Zeichenfolge sein (dies ist äquivalent).
zur Verwendung von -schn). Wenn eine TAR-Datei gefunden wird, wird sie entpackt, um das Diff zu erstellen
Entfernen Sie es anschließend (dies entspricht -sp); Wenn ein Verzeichnis gefunden wird, wird es gefunden
Packen Sie es, um die Originalquelle zu erstellen, und entfernen Sie es anschließend (das ist gleichbedeutend).
zu -sr); Wenn keines von beiden gefunden wird, wird davon ausgegangen, dass das Paket nicht debianisiert ist
diffs, nur ein einfaches Quellarchiv (dies ist äquivalent zu -schn). Wenn beides
werden dann gefunden dpkg-Quelle ignoriert das Verzeichnis und überschreibt es, wenn -sA wurde
angegeben (dies entspricht -sP) oder einen Fehler auslösen, wenn -Sa angegeben wurde. -sA
ist die Vorgabe.

--abort-on-upstream-changes
Der Prozess schlägt fehl, wenn das generierte Diff Änderungen an Dateien außerhalb von enthält
debian-Unterverzeichnis (seit Dpkg 1.15.8). Diese Option ist nicht zulässig
debian/source/options kann aber verwendet werden debian/source/local-options.

Extrahieren Optionen (mit --Extrakt):

In allen Fällen wird der vorhandene ursprüngliche Quellbaum entfernt.

-sp Wird beim Extrahieren verwendet, bleibt die Originalquelle (falls vorhanden) als TAR-Datei übrig.
Wenn es sich nicht bereits im aktuellen Verzeichnis befindet oder vorhanden ist, aber
Wenn eine andere Datei vorhanden ist, wird sie dorthin kopiert. (Dieser is Standard).

-so Entpackt den ursprünglichen Quellbaum.

-schn Stellt sicher, dass die Originalquelle weder in das aktuelle Verzeichnis kopiert wird noch
unverpackt. Jeder ursprüngliche Quellbaum, der sich im aktuellen Verzeichnis befand, ist noch vorhanden
entfernt.

Um so -sX Optionen schließen sich gegenseitig aus. Wenn Sie mehr als eine angeben, nur die letzte
werden verwendet.

--skip-debianization
Überspringt die Anwendung des Debian-Diffs über den Upstream-Quellen (da dpkg
1.15.1).

Format: 2.0
Extraktion wird seit Dpkg 1.13.9 unterstützt, Erstellung wird seit Dpkg 1.14.8 unterstützt. Auch bekannt
als Perücke&Stift. Dieses Format wird nicht für eine weit verbreitete Verwendung empfohlen, das Format „3.0 (Quilt)“
ersetzt es. Wig&pen war die erste Spezifikation eines Quellpakets der neuen Generation
Format.

Das Verhalten dieses Formats ist das gleiche wie das Format „3.0 (Quilt)“, außer dass es
verwendet keine explizite Liste von Patches. Alle Dateien drin debian/patches/ passend zum Perl
regulärer Ausdruck [\w-]+ müssen gültige Patches sein: Sie werden zum Zeitpunkt der Extraktion angewendet.

Beim Erstellen eines neuen Quellpakets werden alle Änderungen an der Upstream-Quelle in einem Patch gespeichert
namens zz_debian-diff-auto.

Format: 3.0 (einheimisch)
Unterstützt seit Dpkg 1.14.17. Dieses Format ist eine Erweiterung des nativen Paketformats as
im 1.0-Format definiert. Es unterstützt alle Komprimierungsmethoden und ignoriert sie standardmäßig
alle VCS-spezifischen Dateien und Verzeichnisse sowie viele temporäre Dateien (siehe Standardwert).
verbunden sein mit -I Option in der --help Ausgang).

Format: 3.0 (Decke)
Unterstützt seit Dpkg 1.14.17. Ein Quellpaket in diesem Format enthält mindestens eine
Original-Tarball (.orig.tar.ext woher ext kann sein gz, bz2, lzma und xz) und ein Debian
Tarball (.debian.tar.ext). Es kann auch zusätzliche Original-Tarballs enthalten
(.orig-Komponente.Teer.ext). Komponente darf nur alphanumerische Zeichen und Bindestriche enthalten
('-').

Extrahieren

Zuerst wird der Haupt-Original-Tarball extrahiert, dann werden alle weiteren Original-Tarballs extrahiert
extrahiert in Unterverzeichnisse, die nach dem benannt sind Komponente Teil ihres Dateinamens (jeder vorab)
bestehendes Verzeichnis wird ersetzt). Der Debian-Tarball wird zusätzlich zur Quelle extrahiert
Verzeichnis nach vorheriger Entfernung aller bereits vorhandenen Debian Verzeichnis. Beachten Sie, dass das Debian
Der Tarball muss Folgendes enthalten: Debian Unterverzeichnis, es kann aber auch Binärdateien außerhalb enthalten
dieses Verzeichnisses (siehe --include-binaries Möglichkeit).

Alle in aufgeführten Patches debian/patches/debian.series or debian/patches/series sind dann
angewandt. Wenn die erstere Datei verwendet wird und die letztere nicht existiert (oder ein symbolischer Link ist),
dann wird Letzteres durch einen Symlink zu Ersterem ersetzt. Dies soll die Nutzung vereinfachen
of Steppdecke um den Patch-Satz zu verwalten. Beachten Sie jedoch, dass während dpkg-Quelle analysiert
Korrekte Seriendateien mit expliziten Optionen für die Patch-Anwendung (auf jedem gespeichert).
Zeile nach dem Patch-Dateinamen und einem oder mehreren Leerzeichen), werden diese Optionen ignoriert und
Erwarten Sie immer Patches, die mit dem angewendet werden können -p1 Option Flicken. Es wird also emittieren
eine Warnung, wenn solche Optionen gefunden werden und der Build wahrscheinlich fehlschlägt.

Der Zeitstempel aller gepatchten Dateien wird auf den Extraktionszeitpunkt des Quellpakets zurückgesetzt
(Dadurch werden Zeitstempelverzerrungen vermieden, die zu Problemen führen, wenn automatisch generierte Dateien gepatcht werden.)

Gegensätzlich zu SteppdeckeBeim Standardverhalten wird erwartet, dass Patches ohne Probleme angewendet werden.
Ist dies nicht der Fall, sollten Sie solche Patches mit aktualisieren Steppdecke, oder dpkg-Quelle werden wir
Beim Versuch, sie anzuwenden, ist ein Fehler aufgetreten.

ähnlich zu SteppdeckeStandardmäßig können die Patches auch Dateien entfernen.

Die Datei .pc/applied-patches wird erstellt, wenn einige Patches während des angewendet wurden
Extraktion.

Building

Alle im aktuellen Verzeichnis gefundenen Original-Tarballs werden in eine temporäre Datei extrahiert
indem Sie der gleichen Logik wie beim Entpacken folgen, wird das Debian-Verzeichnis kopiert
im temporären Verzeichnis und alle Patches außer dem automatischen Patch
(Debian-Änderungen-Version or Debian-Änderungen, es hängt davon ab --single-debian-patch) sind
angewandt. Das temporäre Verzeichnis wird mit dem Quellpaketverzeichnis verglichen. Wenn das
diff ist nicht leer, der Build schlägt fehl, es sei denn --single-debian-patch or --auto-commit wurde
verwendet. In diesem Fall wird der Unterschied im automatischen Patch gespeichert. Wenn der automatische Patch ist
erstellt/gelöscht, es wird der Seriendatei und der hinzugefügt/entfernt Steppdecke Metadaten.

Jede Änderung an einer Binärdatei ist in einem Diff nicht darstellbar und führt daher zu einem Fehler
es sei denn, der Betreuer hat sich bewusst dafür entschieden, diese geänderte Binärdatei in die Datei aufzunehmen
Debian-Tarball (durch Auflisten in debian/source/include-binaries). Der Build wird ebenfalls fehlschlagen
wenn es Binärdateien im Debian-Unterverzeichnis findet, es sei denn, sie wurden auf die Whitelist gesetzt
bis debian/source/include-binaries.

Das aktualisierte Debian-Verzeichnis und die Liste der geänderten Binärdateien werden dann zum Generieren verwendet
der Debian-Tarball.

Das automatisch generierte Diff umfasst auch keine Änderungen an VCS-spezifischen Dateien
viele temporäre Dateien (siehe Standardwert für -i Option in der --help Ausgabe). In
insbesondere, die .pc Verzeichnis, das von verwendet wird Steppdecke wird bei der Generierung der Automatik ignoriert
patch.

Hinweis: dpkg-Quelle --before-build (und --bauen) stellt sicher, dass alle in der aufgeführten Patches
Seriendateien werden angewendet, sodass bei einem Paketaufbau immer alle Patches angewendet werden. Es tut
Dies können Sie erreichen, indem Sie nicht angewendete Patches finden (sie sind im aufgeführt). Serie Datei, aber nicht in
.pc/applied-patches), und wenn der erste Patch in diesem Satz ohne Fehler angewendet werden kann, ist es
werde sie alle anwenden. Die Option --keine-Vorbereitung kann verwendet werden, um dieses Verhalten zu deaktivieren.

Aufnahme Änderungen

--verpflichten [Verzeichnis] [Patch-Name] [Patch-Datei]
Erstellt einen Patch, der den lokalen Änderungen entspricht, die nicht von verwaltet werden
Steppdecke Patch-System und integriert es unter dem Namen in das Patch-System Patch-Name.
Fehlt der Name, wird dieser interaktiv abgefragt. Wenn Patch-Datei gegeben ist, es
wird als Patch verwendet, der den zu integrierenden lokalen Änderungen entspricht. Einmal
integriert, wird ein Editor gestartet, mit dem Sie die Metainformationen im bearbeiten können
Patch-Header.

Bestehen Patch-Datei ist vor allem nach einem Build-Fehler nützlich, der dies vorab generiert hat
Datei, und aus diesem Grund wird die angegebene Datei nach der Integration entfernt. Beachten Sie auch
dass die in der Patch-Datei enthaltenen Änderungen bereits auf den Baum angewendet werden müssen
und dass die durch den Patch geänderten Dateien keine zusätzlichen Unaufzeichnungen enthalten dürfen
ändert.

Wenn die Patch-Generierung geänderte Binärdateien erkennt, werden diese automatisch aktualisiert
hinzugefügt zu debian/source/include-binaries damit sie im Debian-Tarball landen
(genau wie dpkg-Quelle --include-binaries --bauen würdest du).

Bauen Optionen

--allow-version-of-quilt-db=Version
Erlauben dpkg-Quelle um das Quellpaket zu erstellen, wenn die Version von Steppdecke Metadaten
ist die angegebene, auch wenn dpkg-Quelle weiß nichts davon (da dpkg
1.15.5.4). Tatsächlich besagt dies, dass die gegebene Version des Steppdecke Metadaten sind
kompatibel mit der Version 2, die dpkg-Quelle unterstützt derzeit. Die Version von
Steppdecke Metadaten werden gespeichert .pc/.version.

--include-removal
Ignorieren Sie entfernte Dateien nicht und fügen Sie sie in den automatisch generierten Patch ein.

--include-timestamp
Fügen Sie einen Zeitstempel in den automatisch generierten Patch ein.

--include-binaries
Fügen Sie alle geänderten Binärdateien im Debian-Tarball hinzu. Fügen Sie sie auch hinzu
debian/source/include-binaries: Sie werden in nachfolgenden Builds standardmäßig hinzugefügt
und diese Option wird daher nicht mehr benötigt.

--keine-Vorbereitung
Versuchen Sie nicht, den Build-Baum vorzubereiten, indem Sie offensichtlich Patches anwenden
nicht angewendet (seit Dpkg 1.14.18).

--single-debian-patch
Verwenden Sie die debian/patches/debian-changes statt debian/patches/debian-changes-Version
für den Namen des automatischen Patches, der während des Builds generiert wird (seit Dpkg 1.15.5.4).
Diese Option ist besonders nützlich, wenn das Paket in einem VCS verwaltet wird und a
Patch-Set kann nicht zuverlässig generiert werden. Stattdessen der aktuelle Diff mit Upstream
sollten in einem einzigen Patch gespeichert werden. Die Option würde eingebaut werden
debian/source/local-options und würde von einem begleitet werden
debian/source/local-patch-header Datei, die erklärt, wie die Debian-Änderungen am besten durchgeführt werden können
überprüft, beispielsweise im verwendeten VCS.

--create-empty-orig
Erstellen Sie den Haupt-Original-Tarball automatisch als leer, wenn er fehlt und ggf
Es gibt zusätzliche Original-Tarballs (seit Dpkg 1.15.6). Diese Option ist
soll verwendet werden, wenn das Quellpaket nur ein Bündel mehrerer Upstream-Pakete ist
Software und wo es keine „Haupt“-Software gibt.

--no-unapply-patches, --unapply-patches
Standardmäßig dpkg-Quelle wird die Patches im automatisch entfernen --after-build
Haken, wenn es sie während angewendet hat --before-build (--unapply-patches seit dpkg
1.15.8, --no-unapply-patches seit Dpkg 1.16.5). Diese Optionen ermöglichen es Ihnen
den Patch-Unanwendungsprozess zwangsweise deaktivieren oder aktivieren. Diese Optionen sind
nur reingelassen debian/source/local-options damit alle generierten Quellpakete
haben standardmäßig das gleiche Verhalten.

--abort-on-upstream-changes
Der Prozess schlägt fehl, wenn ein automatischer Patch generiert wurde (seit Dpkg 1.15.8).
Mit dieser Option kann sichergestellt werden, dass alle Änderungen ordnungsgemäß aufgezeichnet wurden
getrennte Steppdecke Patches vor der Erstellung des Quellpakets. Diese Option ist nicht vorhanden
erlaubt in debian/source/options kann aber verwendet werden debian/source/local-options.

--auto-commit
Der Vorgang schlägt nicht fehl, wenn ein automatischer Patch generiert wurde, sondern schon
sofort in der aufgezeichnet Steppdecke Serie.

Extrahieren Optionen

--skip-debianization
Überspringt die Extraktion des Debian-Tarballs über den Originalquellen (seit dpkg
1.15.1).

--skip-patches
Wenden Sie am Ende der Extraktion keine Patches an (seit Dpkg 1.14.18).

Format: 3.0 (Benutzerdefiniert)
Unterstützt seit Dpkg 1.14.17. Dieses Format ist etwas Besonderes. Es handelt sich nicht um eine echte Quelle
Paketformat, kann aber zum Erstellen von Quellpaketen mit beliebigen Dateien verwendet werden.

Bauen Optionen

Alle Nicht-Optionsargumente werden als Dateien zur Integration in das generierte Quellpaket verwendet.
Sie müssen vorhanden sein und liegen vorzugsweise im aktuellen Verzeichnis. Es muss mindestens eine Datei vorhanden sein
gegeben.

--target-format=Wert
Erforderlich. Definiert das tatsächliche Format des generierten Quellpakets. Das generierte
Die .dsc-Datei enthält diesen Wert Format Feld und nicht „3.0 (benutzerdefiniert)“.

Format: 3.0 (git)
Unterstützt seit Dpkg 1.14.17. Dieses Format ist experimentell.

Ein Quellpaket in diesem Format besteht aus einem einzelnen Bundle eines Git-Repositorys .git zu
enthält die Quelle eines Pakets. Möglicherweise gibt es auch eine .gitshallow Dateilistenrevisionen für
ein flacher Git-Klon.

Extrahieren

Das Bundle wird als Git-Repository in das Zielverzeichnis geklont. Wenn da ein ... ist
gitshallow-Datei, sie wird installiert als .git/shallow im geklonten Git-Repository.

Beachten Sie, dass im neuen Repository standardmäßig derselbe Zweig ausgecheckt ist wie zuvor
in der Originalquelle ausgecheckt. (Normalerweise „Master“, aber es könnte alles sein.) Beliebig
Weitere Filialen finden Sie unter Fernbedienungen/Ursprung/.

Building

Bevor wir fortfahren, werden einige Überprüfungen durchgeführt, um sicherzustellen, dass wir keine nicht-
Nicht festgeschriebene Änderungen wurden ignoriert.

Git-Bundle(1) wird verwendet, um ein Bundle des Git-Repositorys zu generieren. Standardmäßig alle
Zweige und Tags im Repository sind im Bundle enthalten.

Bauen Optionen

--git-ref=ref
Ermöglicht die Angabe einer Git-Referenz, die in das Git-Bundle aufgenommen werden soll. Durch Verwenden wird die Standardeinstellung deaktiviert
Verhalten beim Einbeziehen aller Zweige und Tags. Kann mehrfach angegeben werden. Der
ref kann der Name eines Zweigs oder Tags sein, der einbezogen werden soll. Es kann sich auch um einen beliebigen Parameter handeln
das kann weitergegeben werden git-rev-Liste(1). Um beispielsweise nur den Master einzubeziehen
Zweig, Verwendung --git-ref=Meister. Um alle Tags und Zweige außer dem einzuschließen
private Filiale, Nutzung --git-ref=--alle --git-ref=^privat

--git-length=Anzahl
Erstellt einen flachen Klon mit einem auf die angegebene Anzahl gekürzten Verlauf
Überarbeitungen.

Format: 3.0 (bzr)
Unterstützt seit Dpkg 1.14.17. Dieses Format ist experimentell. Es wird ein einzelner Tarball generiert
Enthält das BZR-Repository.

Extrahieren

Der Tarball wird entpackt und dann wird bzr zum Auschecken des aktuellen Zweigs verwendet.

Building

Bevor wir fortfahren, werden einige Überprüfungen durchgeführt, um sicherzustellen, dass wir keine nicht-
Nicht festgeschriebene Änderungen wurden ignoriert.

Anschließend wird der VCS-spezifische Teil des Quellverzeichnisses in ein temporäres Verzeichnis kopiert
Verzeichnis. Bevor dieses temporäre Verzeichnis in einen Tarball gepackt wird, sind verschiedene Aufräumarbeiten erforderlich
getan, um Platz zu sparen.

DIAGNOSE

nicht Quelle Format angegeben in debian/source/format
Die Datei debian/source/format sollte immer vorhanden sein und das gewünschte Quellformat angeben.
Aus Gründen der Abwärtskompatibilität wird das Format „1.0“ angenommen, wenn die Datei nicht existiert, außer Sie
Darauf sollte man sich nicht verlassen: irgendwann in der Zukunft dpkg-Quelle wird so geändert, dass es fehlschlägt
wenn diese Datei nicht existiert.

Der Grund dafür ist, dass das Format „1.0“ nicht mehr das empfohlene Format ist, was Sie normalerweise tun sollten
Wählen Sie eines der neueren Formate („3.0 (quilt)“, „3.0 (nativ)“), aber dpkg-Quelle wird nicht tun
dies automatisch für Sie. Wenn Sie weiterhin das alte Format verwenden möchten, sollten Sie dies tun
machen Sie es explizit und geben Sie „1.0“ ein debian/source/format.

diff modifiziert Folgende flussaufwärts Dateien
Bei Verwendung des Quellformats „1.0“ ist es normalerweise keine gute Idee, die Originaldateien direkt zu ändern
da die Änderungen am Ende verborgen und größtenteils undokumentiert in der Datei .diff.gz bleiben. Stattdessen du
sollte Ihre Änderungen als Patches im Debian-Verzeichnis speichern und sie zur Build-Zeit anwenden.
Um diese Komplexität zu vermeiden, können Sie auch das Format „3.0 (Quilt)“ verwenden, das dies bietet
nativ.

kann keine vertreten Übernehmen zu Datei
Änderungen an Upstream-Quellen werden normalerweise mit Patch-Dateien gespeichert, aber nicht alle Änderungen können dies tun
mit Patches dargestellt werden: Sie können nur den Inhalt von Klartextdateien ändern. Wenn du
Versuchen Sie, eine Datei durch etwas eines anderen Typs zu ersetzen (z. B. durch Ersetzen einer einfachen Datei).
Datei mit einem Symlink oder einem Verzeichnis), erhalten Sie diese Fehlermeldung.

neu erstellt leer Datei Datei werden wir nicht be vertreten in diff
Mit Patchdateien können keine leeren Dateien erstellt werden. Daher wird diese Änderung nicht im erfasst
Quellpaket und Sie werden davor gewarnt.

ausführbar Modus Dauerwellen of Datei werden wir nicht be vertreten in diff
Patchdateien zeichnen keine Berechtigungen von Dateien auf und daher auch keine ausführbaren Berechtigungen
im Quellpaket gespeichert. Diese Warnung erinnert Sie daran.

besondere Modus Dauerwellen of Datei werden wir nicht be vertreten in diff
Patchdateien zeichnen keine Berechtigungen von Dateien auf und geänderte Berechtigungen gelten daher nicht
im Quellpaket gespeichert. Diese Warnung erinnert Sie daran.

FILE FORMATEN

debian/source/format
Diese Datei enthält in einer einzigen Zeile das Format, das zum Erstellen der Quelle verwendet werden soll
Paket (mögliche Formate sind oben beschrieben). Es sind keine führenden oder nachgestellten Leerzeichen zulässig.

debian/source/include-binaries
Diese Datei enthält eine Liste von Binärdateien (eine pro Zeile), die in die Datei aufgenommen werden sollen
Debian-Tarball. Führende und nachfolgende Leerzeichen werden entfernt. Zeilen beginnend mit '#' sind
Kommentare und werden übersprungen. Leerzeilen werden ignoriert.

debian/source/options
Diese Datei enthält eine Liste langer Optionen, die automatisch dem vorangestellt werden sollten
Satz von Befehlszeilenoptionen von a dpkg-Quelle --bauen or dpkg-Quelle --print-format Anruf.
Optionen wie --Kompression und --Kompressionsstufe sind für diese Datei gut geeignet.

Jede Option sollte in einer separaten Zeile stehen. Leere Zeilen und Zeilen, die mit ' beginnen#' sind
ignoriert. Die Führung '--' sollte entfernt werden und kurze Optionen sind nicht zulässig. Optional
Um das ' sind Leerzeichen erlaubt='-Symbol und optionale Anführungszeichen sind um den Wert herum zulässig.
Hier ist ein Beispiel für eine solche Datei:

# Lassen Sie dpkg-source eine debian.tar.bz2 mit maximaler Komprimierung erstellen
Komprimierung = „bzip2“
Komprimierungsstufe = 9
# debian/patches/debian-changes als automatischen Patch verwenden
Single-Debian-Patch
# Änderungen an der Konfiguration ignorieren.{sub,guess}
extension-diff-ignore = "(^|/)(config.sub|config.guess)$"

Hinweis: Format Optionen in dieser Datei nicht akzeptiert werden, sollten Sie verwenden debian/source/format
stattdessen.

debian/source/local-options
Genau wie debian/source/options außer dass die Datei nicht in der generierten Datei enthalten ist
Quellpaket. Es kann nützlich sein, eine Präferenz zu speichern, die an den Betreuer oder an den Betreuer gebunden ist
VCS-Repository, in dem das Quellpaket verwaltet wird.

debian/source/local-patch-header und debian/source/patch-header
Freiformtext, der über dem automatisch generierten Patch in den Formaten „2.0“ oder „XNUMX“ platziert wird
„3.0 (Steppdecke)“. lokaler-Patch-Header ist nicht im generierten Quellpaket enthalten, während
Patch-Header ist.

debian/patches/series
Diese Datei listet alle Patches auf, die (in der angegebenen Reihenfolge) zusätzlich angewendet werden müssen
Upstream-Quellpaket. Führende und nachfolgende Leerzeichen werden entfernt. Zeilen beginnend mit
'#' sind Kommentare und werden übersprungen. Leerzeilen werden ignoriert. Die übrigen Zeilen beginnen mit a
Patch-Dateiname (relativ zu debian/patches/ Verzeichnis) bis zum ersten Leerzeichen
oder das Zeilenende. Optional Steppdecke Optionen können bis zum Ende der Zeile oder bis zur ersten folgen
'#', dem ein oder mehrere Leerzeichen vorangestellt sind (was den Beginn eines Kommentars bis zum Ende markiert).
Linie).

Verwenden Sie dpkg-source online über die Dienste von onworks.net