Provided by: debhelper_9.20160115ubuntu3_all 
NAME
dh_install - installiert Dateien in Bauverzeichnisse von Paketen
Ü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 Paket installiert sind. Dies wird mit
--list-missing (oder --fail-missing) als Ausschlussdatei benutzt.
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.
SIEHE AUCH
debhelper(7)
Dieses Programm ist Teil von Debhelper.
ÜBERSETZUNG
Diese Übersetzung wurde mit dem Werkzeug po4a <http://po4a.alioth.debian.org/> durch Chris Leick
c.leick@vollbio.de und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt.
Bitte melden Sie alle Fehler in der Übersetzung an debian-l10n-german@lists.debian.org 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 <joeyh@debian.org>
9.20160115ubuntu3 2016-03-31 DH_INSTALL(1)