ÜBERSICHT

dh_install [-XElement] [--autodest] [--sourcedir=Verz] [Debhelper-Optionen] [Datei|Verz … Ziel]

BESCHREIBUNG

dh_install ist ein Debhelper-Programm, das die Installation von Paketen in Bauverzeichnisse handhabt. Es gibt viele dh_install*-Befehle, die die Installation spezieller Dateitypen, wie Dokumentation, Beispiele, Handbuchseiten und so weiter handhaben und sie sollten, wenn möglich, benutzt werden, da sie oft zusätzliche Informationen für diese besonderen Aufgaben mitbringen. Ergänzend ist dh_install nützlich, um alles andere zu installieren, für das keine zusätzliche Logik benötigt wird. Es ist ein Ersatz für den alten Befehl dh_movefiles.

Dieses Programm kann auf eine von zwei Arten benutzt werden. Falls Sie nur eine oder zwei Dateien haben, die das Makefile der Originalautoren nicht für Sie installiert, können Sie dh_install dafür ausführen, um diese an Ort und Stelle zu verschieben. Zum Anderen könnten Sie ein großes Paket haben, das mehrere Binärpakete baut. Sie können das Makefile der Originalautoren nehmen, um alles in debian/tmp zu installieren und dann dh_install verwenden, um dann Dateien und Verzeichnisse in ihre passenden Paketbauverzeichnisse zu kopieren.

Ab Debhelper-Kompatibilitätsstufe 7 wird dh_install in debian/tmp nach Dateien suchen, wenn es sie nicht im aktuellen Verzeichnis findet (oder wo auch immer Sie ihm mit --sourcedir aufgetragen haben, zu suchen).

DATEIEN

debian/Paket.install

Listet die Dateien auf, die in jedes Paket installiert werden und das Verzeichnis, in das sie installiert werden sollen. Das Format ist ein Satz von Zeilen, bei der jede Zeile eine oder mehrere zu installierende Dateien aufführt und am Zeilenende mitteilt, in welches Verzeichnis sie installiert werden sollen. Die Namen der Dateien (oder Verzeichnisse) sollten relativ zum aktuellen Verzeichnis angegeben werden, während das Installationsverzeichnis relativ zum Bauverzeichnis des Pakets angegeben wird. Sie können Platzhalter in den Namen der zu installierenden Dateien benutzen (im Modus v3 und darüber).

Beachten Sie, falls Sie genau einen Dateinamen oder ein Platzhaltermuster allein auf einer Zeile ohne ein ausdrückliches Ziel aufführen, wird dh_install automatisch das Ziel abschätzen, sogar wenn dieser Schalter nicht gesetzt ist.

debian/not-installed

listet die Dateien auf, die absichtlich in keinem Binärpaket installiert sind. Pfade, die in dieser Datei aufgeführt werden, werden bei der Prüfung per --list-missing (oder --fail-missing) ignoriert.

Bitte vergessen Sie nicht, dass Dh_install Platzhalter in dieser Datei nicht expandiert.

OPTIONEN

--list-missing

Diese Option veranlasst dh_install, aufzuzeichnen, welche Dateien es installiert und diese Liste am Ende mit den Dateien im Quellverzeichnis zu vergleichen. Falls irgendwelche der Dateien (oder symbolischen Verweise) nicht irgendwo im Quellverzeichnis installiert wurden, wird es diesbezüglich auf der Standardfehlerausgabe warnen.

Dies könnte nützlich sein, falls Sie ein großes Paket haben und sicherstellen möchten, dass Sie keine neu hinzugefügten Dateien in neuen Veröffentlichungen der Originalautoren übersehen.

Beachten Sie, dass nicht bezüglich Dateien gewarnt wird, die mittels der Option -X ausgeschlossen wurden.

--fail-missing

Diese Option ist wie --list-missing, außer dass sie, wenn eine Datei fehlt, nicht nur die fehlenden Dateien auflistet, sondern auch mit einem Rückgabewert ungleich Null fehlschlägt.

-XElement, --exclude=Element

schließt Dateien von der Installation aus, die irgendwo in ihrem Dateinamen Element enthalten

--sourcedir=Verz

sucht im angegebenen Verzeichnis nach Dateien, die installiert werden sollen.

Beachten Sie, dass dies nicht das Gleiche wie die Option --sourcedirectory ist, die von dh_auto_*-Befehlen benutzt wird. Sie benötigen diese Option selten, da dh_install in Debhelper-Kompatibilitätsstufe 7 und darüber automatisch in debian/tmp nach Dateien sucht.

--autodest

wird als Zielverzeichnis angenommen, um Dinge darin zu installieren. Falls dies angegeben wurde, sollten Sie keine Zielverzeichnisse in debian/Paket.install-Dateien oder auf der Befehlszeile angeben. Stattdessen wird dh_install wie folgt raten:

debian/tmp (oder das Quellverzeichnis, wenn eines angegeben ist) wird vom Anfang des Dateinamens entfernt, falls es vorhanden ist, und es wird in den Verzeichnisanteil des Dateinamens installiert. Wenn also der Dateiname debian/tmp/usr/bin ist, dann wird dieses Verzeichnis nach debian/Paket/usr/ kopiert. Falls der Dateiname debian/tmp/etc/passwd ist, wird es nach debian/Paket/etc/ kopiert.

<Datei|Verz … Zielverz

listet zu installierende Dateien (oder Verzeichnisse) auf und wohin sie installiert werden sollen. Die Dateien werden in das erste Paket installiert, auf das sich dh_install auswirkt.

EINSCHRÄNKUNGEN

dh_install kann keine Dateien oder Verzeichnisse umbenennen, es kann sie nur mit den Namen, die sie bereits haben, im Paketbauverzeichnisbaum dorthin installieren, wo Sie es wünschen.

Umbenennen kann jedoch durch Verwenden von dh-exec mit der Kompatibilitätsstufe 9 oder höher erreicht werden. Eine debian/package.install-Beispieldatei, die dh-exec verwendet, könnte wie folgt aussehen:

 #!/usr/bin/dh-exec
 debian/default.conf => /etc/my-package/start.conf

Bitte vergessen Sie nicht die folgenden drei Dinge:

• Das Paket muss Kompatibilitätsstufe 9 oder höher verwenden (siehe debhelper(7)).
• Das Paket muss eine Bauabhängigkeit zu Dh-exec haben.
• Die Installationsdatei muss als ausführbar markiert sein.

ÜBERSETZUNG

Diese Übersetzung wurde mit dem Werkzeug po4a <http://po4a.alioth.debian.org/> durch Chris Leick [email protected] und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt.

Bitte melden Sie alle Fehler in der Übersetzung an [email protected] oder als Fehlerbericht an das Paket debhelper.

Sie können mit dem folgenden Befehl das englische Original anzeigen man -L en Abschnitt Handbuchseite

AUTOR

Joey Hess <[email protected]>