DH_INSTALL(1)

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 für die Installation spezieller Dateitypen, wie Dokumentation, Beispiele, Handbuchseiten und so weiter und sie sollten nach Möglichkeit benutzt werden, da sie oft zusätzliche Programmlogik für diese besonderen Aufgaben mitbringen. Ergänzend eignet sich dh_install, 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 darüberlaufen lassen, um diese an Ort und Stelle zu verschieben. Vielleicht haben Sie auch ein großes Paket, das mehrere Binärpakete baut. Sie können dann 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.

    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, genau so, als wenn die Option --autodest genutzt würde.

    unterstützt Ersetzungsvariablen in Kompatibilitätsstufe 13 oder neuer, wie in debhelper(7) beschrieben.

debian/not-installed
    wird zusammen mit den missbilligten Optionen --list-missing und --fail-missing benutzt. Die Dokumentation dieser Datei finden Sie unter dh_missing(1).

OPTIONEN

--list-missing
    Missbilligt: Bitte verwenden Sie stattdessen dh_missing --list-missing. Falls Sie diese Option verwenden, wird dh_install dh_missing mit dieser Option aufrufen, nachdem es alle Dateien verarbeitet hat. Die Dokumentation dieser Option finden Sie unter dh_missing(1).

    Die Option wurde in Kompatibilitätsstufe 12 entfernt.

--fail-missing
    Missbilligt: Bitte verwenden Sie stattdessen dh_missing --fail-missing. Falls Sie diese Option verwenden, wird dh_install dh_missing mit dieser Option aufrufen, nachdem es alle Dateien verarbeitet hat. Die Dokumentation dieser Option finden Sie unter dh_missing(1).

    Die Option wurde in Kompatibilitätsstufe 12 entfernt.

--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 festlegen. Stattdessen wird dh_install wie folgt raten:

    debian/tmp (oder das Quellverzeichnis, wenn eines angegeben ist) wird vom Anfang des Dateinamens entfernt, falls sie vorhanden ist, und wird in den Verzeichnisanteil des Dateinamens übernommen. 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.

BEISPIELE
Hier folgen einige kleine Beispiele für Konfigurationsdateien von dh_install.

    # installiert my-prog in usr/bin (als »usr/bin/mein_Programm«)
    my-prog usr/bin

    # installiert ein Erweiterungsverzeichnis in usr/share/mein_Programm
    # (als »usr/share/mein_Programm/plugins/«)
    plugins usr/share/mein_Programm

    # installiert eine Datei mit Leerzeichen in usr/share/mein_Programm/data
    # (als »usr/share/mein_Programm/data/meine_Daten mit spaces.txt«)
    # SETZT KOMPATIBILITÄTSSTUFE 13 VORAUS, in der Ersetzungsmuster
    # verfügbar sind
    my${Space}datafile${Space}with${Space}spaces.txt usr/share/mein_Programm/data

    # installiert eine Bibliothek in das Multiarch-Bibliotheksverzeichnis
    # SETZT KOMPATIBILITÄTSSTUFE 13 VORAUS, in der Ersetzungsmuster
    # verfügbar sind
    build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}

EINSCHRÄNKUNGEN
dh_install kann keine Dateien oder Verzeichnisse umbenennen, es kann sie nur mit den Namen, die sie bereits haben, im Paketbauverzeichnisbaum an die gewünschte Stelle installieren.

Es gibt keine Möglichkeit, Ergebnisse basierend auf Bauprofilen oder Architektur auszufiltern. Ziehen Sie für Dokumentation die Verwendung von dh_installdocs oder dh_installexamples in Betracht, weil diese Hilfsprogramme für das Bauprofil nodoc zuständig sind.

Umbenennung und Filterung 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
 build/foo /usr/bin <!pkg.bar.nofoo>

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>