DH_DWZ(1)

NAME
dh_dwz - optimiert DWARF-Fehlersuchinformationen in ELF-Binärdateien über dwz

ÜBERSICHT
dh_dwz [Debhelper-Optionen] [-XElement] [-- Parameter]

BESCHREIBUNG
dh_dwz ist ein Debhelper-Programm, das die (unkomprimierte) Größe von DWARF-Fehlersuchinformationen in ELF-Binärdateien optimiert. Dazu lässt es dwz(1) über alle ELF-Binärdateien im Paket laufen.

OPTIONEN

--dwz-multifile, --no-dwz-multifile
    Gibt an, ob dwz(1) eine Mehrfachdatei aus den ELF-Binärdateien im selben Paket erstellen soll. Falls aktiviert, wird dh_dwz, falls ein Paket mindestens zwei ELF-Binärdateien ausliefert, dwz(1) anweisen, eine Mehrfachdatei für das Paket zu erstellen.

    Standardmäßig wird dh_dwz versuchen, eine Mehrfachdatei zu erstellen, es wird jedoch ohne sie fortfahren, falls dwz(1) keine erstellt (aber dennoch erfolgreich ist). Dies kommt üblicherweise vor, wenn die Fehlersuchdateien keine Fehlersuchsymbole enthalten (z. B. ein fehlendes -g für den Compiler) oder wenn die Fehlersuchsymbole komprimiert sind (siehe Debian-Fehlerbericht #931891). Falls --dwz-multifile übergeben wurde, wird dh_dwz mit einem Fehler abbrechen, falls dwz(1) keine Mehrfachdatei erstellt.

    Beachten Sie, dass diese Optionen möglicherweise nicht funktionieren wird, falls ein Paket mehr ELF-Binärdateien enthält als auf eine einzige Befehlszeile passen. Falls dies zum Problem wird, geben Sie bitte --no-dwz-multifile an, um diese Angelegenheit zu umgehen.

    Die erstellte Mehrfachdatei wird mit objcopy --compress-debug-sections komprimiert.

    Beachten Sie bei udeb-Paketen: dh_dwz wird niemals Mehrfachdateien für udeb-Pakete erzeugen. Es wird weiterhin dwz benutzen, um die Größe der Fehlersuchdateien zu verringern, falls es welche findet.

-XElement, --exclude=Element
    schließt Dateien, die irgendwo in ihrem Dateinamen genanntes Element enthalten, vom Entfernen der Symbole aus. Sie können diese Option mehrfach benutzen, um eine Liste auszuschließender Dinge zu erstellen.

-- Parameter
    übergibt Parameter an dwz(1), wenn es ELF-Binärdateien verarbeitet. Dies ist meist nützlich, um speicherbezogene Parameter zu setzen (z.B. -l und -L).

ANMERKUNGEN
Falls die Umgebungsvariable DEB_BUILD_OPTIONS nostrip enthält, werden getreu der Debian-Richtlinie (Abschnitt 10.1. »Binaries«) keine Symbole entfernt.

Obwohl dieses Werkzeug aus technischer Sicht keine Fehlersuchinformationen aus Binärdateien entfernt, wird es dennoch übersprungen, wenn die Umgebungsvariable DEB_BUILD_OPTIONS nostrip enthält. Dies rührt daher, dass nostrip oft zum Optimieren der Bauzeit benutzt wird (z. B. für »Bau- und Test«-Zyklen), anstatt sie größenmäßig zu optimieren.

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
Niels Thykier <niels@thykier.net>