dh - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

dh - Debhelper-Befehlssequenzer

ZUSAMMENFASSUNG

dh Reihenfolge [--mit addon[,addon ...]] [--aufführen] [Debhelper-Optionen]

BESCHREIBUNG

dh führt eine Folge von Debhelper-Befehlen aus. Die unterstützten Reihenfolges entsprechen dem
Ziele von a debian/regeln Datei: Baubogen, bauunabhängig, bauen, reinigen, install-unabhängig,
install-arch, installieren, Binär-Arch, binär-unabhängig und binär.

KORREKTUR ZIELE

A debian/regeln Datei mit dh kann den Befehl überschreiben, der in jedem Schritt in a . ausgeführt wird
Sequenz, indem Sie ein Überschreibungsziel definieren.

Überschreiben dh_Befehl, fügen Sie ein Ziel namens . hinzu überschreiben_dh_Befehl in die Regeldatei. Wenn es
würde normalerweise laufen dh_Befehl, dh wird stattdessen dieses Ziel nennen. Das Überschreibungsziel kann
Führen Sie dann den Befehl mit zusätzlichen Optionen aus oder führen Sie stattdessen völlig andere Befehle aus.
Siehe Beispiele unten.

Überschreibungsziele können auch so definiert werden, dass sie nur ausgeführt werden, wenn die Architektur abhängig ist oder
architekturunabhängige Pakete. Verwenden Sie Ziele mit Namen wie überschreiben_dh_Befehl-Bogen
und überschreiben_dh_Befehl-unabhängig. (Beachten Sie, dass Sie zur Verwendung dieser Funktion Build-Abhängig sein sollten
debhelper 8.9.7 oder höher.)

OPTIONAL

--mit addon[,addon ...]
Fügen Sie die vom angegebenen Add-On angegebenen Debhelper-Befehle an den entsprechenden Stellen im
Befehlsfolge, die ausgeführt wird. Diese Option kann mehrmals wiederholt werden, oder
mehrere Addons können durch Kommas getrennt aufgelistet werden. Dies wird verwendet, wenn ein
Drittanbieterpaket, das Debhelper-Befehle bereitstellt. Siehe die PROGRAMMIERUNG Datei für
Dokumentation über das Sequence Addon Interface.

--ohne addon
Das Gegenteil von --mit, deaktiviert die Verwendung des angegebenen Add-Ons. Diese Option kann wiederholt werden
mehr als einmal oder mehrere zu deaktivierende Addons können durch Kommas getrennt aufgelistet werden.

--aufführen, -l
Liste alle verfügbaren Addons auf.

--no-act
Gibt Befehle aus, die für eine bestimmte Sequenz ausgeführt werden würden, führt sie jedoch nicht aus.

Beachten Sie, dass dh normalerweise ausgeführte Befehle überspringt, von denen es weiß, dass sie nichts tun. Mit
--no-act, die vollständige Liste der Befehle in einer Sequenz wird gedruckt.

Andere Optionen übergeben an dh werden an jeden ausgeführten Befehl weitergegeben. Damit kann eingestellt werden
eine Option wie -v or -X or -N, sowie für speziellere Optionen.

Beispiele:

Um zu sehen, welche Befehle in einer Sequenz enthalten sind, ohne etwas zu tun:

dh binär-arch --no-act

Dies ist eine sehr einfache Regeldatei für Pakete, bei denen die Standardbefehlsfolgen
ohne zusätzliche Optionen arbeiten.

#!/usr/bin/make -f
%:
dh $@

Oft möchten Sie eine Option an einen bestimmten Debhelper-Befehl übergeben. Der einfache Weg
with ist, indem Sie ein Überschreibungsziel für diesen Befehl hinzufügen.

#!/usr/bin/make -f
%:
dh $@

override_dh_strip:
dh_strip -Xfoo

override_dh_auto_configure:
dh_auto_configure -- --with-foo --disable-bar

Manchmal die automatisierte dh_auto_configure(1) und dh_auto_build(1) kann nicht erraten, was zu tun ist
für ein seltsames Paket. Hier erfahren Sie, wie Sie beides vermeiden und stattdessen Ihre eigenen ausführen können
Befehle.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
Mach das Universum vor Freude explodieren

Ein weiterer häufiger Fall ist der Wunsch, vor oder nach einem bestimmten Vorgang manuell etwas zu tun
debhelper-Befehl ausgeführt wird.

#!/usr/bin/make -f
%:
dh $@

override_dh_fixperms:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

Wenn Ihr Paket Autotools verwendet und Sie es auffrischen möchten Konfig.sub und config.guess mit
neuere Versionen von der autotools-dev Paket zur Build-Zeit können Sie einige Befehle verwenden
bereitgestellt in autotools-dev die es automatisieren, so.

#!/usr/bin/make -f
%:
dh $@ --mit autotools_dev

Python-Tools werden aufgrund der ständigen Änderungen in diesem Bereich standardmäßig nicht von dh ausgeführt.
(Vor Kompatibilitätsstufe v9 läuft dh dh_pysupport.) So verwenden Sie dh_python2.

#!/usr/bin/make -f
%:
dh $@ --mit python2

So erzwingen Sie die Verwendung von Perls Modul::Build Build-System, das notwendig sein kann, wenn
debhelper erkennt fälschlicherweise, dass das Paket MakeMaker verwendet.

#!/usr/bin/make -f
%:
dh $@ --buildsystem=perl_build

Hier ist ein Beispiel für das Überschreiben, bei dem die dh_auto_* Befehle finden die Quelle des Pakets,
für ein Paket, bei dem sich die Quelle in einem Unterverzeichnis befindet.

#!/usr/bin/make -f
%:
dh $@ --sourcedirectory=src

Und hier ist ein Beispiel, wie man es sagt dh_auto_* Befehle zum Erstellen in einem Unterverzeichnis,
die am entfernt werden reinigen.

#!/usr/bin/make -f
%:
dh $@ --builddirectory=build

Wenn Ihr Paket parallel gebaut werden kann, verwenden Sie bitte entweder compat 10 oder pass --parallel
zu dh. Dann dpkg-buildpaket -j wird funktionieren.

#!/usr/bin/make -f
%:
dh $@ --parallel

Wenn Ihr Paket bei Verwendung mehrerer Threads nicht zuverlässig erstellt werden kann, bestehen Sie bitte
--keine-parallel zu dh (oder dem entsprechenden dh_auto_* Befehl):

#!/usr/bin/make -f
%:
dh $@ --no-parallel

So können Sie vorbeugen dh mehrere Befehle ausführen, die nicht ausgeführt werden sollen,
indem Sie für jeden Befehl leere Überschreibungsziele definieren.

#!/usr/bin/make -f
%:
dh $@

# Befehle, die nicht ausgeführt werden sollen:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Ein langer Build-Prozess für ein separates Dokumentationspaket kann mit
architekturunabhängige Überschreibungen. Diese werden beim Ausführen von build-arch übersprungen und
Binärbogenfolgen.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_build-indep:
$(MAKE) -C-Dokumente

# Keine Tests für Dokumente erforderlich
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$(MAKE) -C docs installieren

Nehmen wir zum Beispiel oben an, dass Sie eine Datei chmod müssen, aber nur beim Erstellen der
architekturabhängiges Paket, da es nicht vorhanden ist, wenn nur Dokumentation erstellt wird.

override_dh_fixperms-arch:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

INTERN

Wenn Sie neugierig sind auf dh's Interna, so funktioniert es unter der Haube.

Jeder Debhelper-Befehl zeichnet auf, wenn er erfolgreich ausgeführt wurde
debian/paket.debhelper.log. (Welcher dh_sauber löscht.) Also dh kann sagen, welche Befehle haben
bereits ausgeführt wurde, für welche Pakete, und überspringen Sie die erneute Ausführung dieser Befehle.

Jedes Mal dh ausgeführt wird, untersucht es das Protokoll und findet den letzten protokollierten Befehl, der sich im
angegebenen Reihenfolge. Es wird dann mit dem nächsten Befehl in der Sequenz fortgesetzt. Die --bis um,
--Vor, --nach und --verblieben Optionen können dieses Verhalten außer Kraft setzen.

Eine Sequenz kann auch abhängige Ziele in debian/rules ausführen. Zum Beispiel die "binäre"
Sequenz führt das Ziel "install" aus.

dh verwendet das DH_INTERNAL_OPTIONS Umgebungsvariable zum Weiterleiten von Informationen an
debhelper-Befehle, die innerhalb von Überschreibungszielen ausgeführt werden. Der Inhalt (und tatsächlich
Existenz) dieser Umgebungsvariable, wie der Name vermuten lässt, kann sich ändern
jederzeit.

Befehle im bauunabhängig, install-unabhängig und binär-unabhängig Sequenzen werden übergeben -i
Option, um sicherzustellen, dass sie nur mit architekturunabhängigen Paketen und Befehlen in der
Baubogen, install-arch und Binär-Arch Sequenzen werden übergeben -a Option, um sicherzustellen, dass sie
funktioniert nur mit architekturabhängigen Paketen.

DEPARCATED OPTIONAL

Die folgenden Optionen sind veraltet. Es ist viel besser, stattdessen Überschreibungsziele zu verwenden.
Sie sind nicht erhältlich in Kompat 10.

--bis um cmd
Führen Sie Befehle in der Reihenfolge aus, bis und einschließlich cmd, dann hör auf.

--Vor cmd
Befehle in der Reihenfolge vorher ausführen cmd, dann hör auf.

--nach cmd
Befehle in der darauffolgenden Reihenfolge ausführen cmd.

--verblieben
Führen Sie alle Befehle in der Reihenfolge aus, die noch ausgeführt werden müssen.

In den obigen Optionen cmd kann ein vollständiger Name eines Debhelper-Befehls oder eine Teilzeichenfolge sein. Es wird
Suchen Sie zuerst nach einem Befehl in der Reihenfolge, der genau dem Namen entspricht, um irgendwelche zu vermeiden
Mehrdeutigkeit. Wenn mehrere Teilzeichenfolgen-Übereinstimmungen vorhanden sind, ist die letzte in der Sequenz
benutzt.

Verwenden Sie dh online mit den onworks.net-Diensten