.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_DWZ 1"
.TH DH_DWZ 1 2024-03-27 13.15.3 Debhelper
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_dwz \- optimiert DWARF\-Fehlersuchinformationen in ELF\-Binärdateien über dwz
.SH ÜBERSICHT
.IX Header "ÜBERSICHT"
\&\fBdh_dwz\fR [\fIDebhelper-Optionen\fR] [\fB\-X\fR\fIElement\fR] [\fB\-\-\fR\ \fIParameter\fR]
.SH BESCHREIBUNG
.IX Header "BESCHREIBUNG"
\&\fBdh_dwz\fR ist ein Debhelper-Programm, das die (unkomprimierte) Größe von DWARF-Fehlersuchinformationen in ELF\-Binärdateien optimiert. Dazu lässt es \fBdwz\fR\|(1) über alle ELF\-Binärdateien im Paket laufen.
.SH OPTIONEN
.IX Header "OPTIONEN"
.IP "\fB\-\-dwz\-multifile\fR, \fB\-\-no\-dwz\-multifile\fR" 4
.IX Item "--dwz-multifile, --no-dwz-multifile"
Gibt an, ob \fBdwz\fR\|(1) eine \fIMehrfachdatei\fR aus den ELF\-Binärdateien im selben Paket erstellen soll. Falls aktiviert, wird \fBdh_dwz\fR, falls ein Paket mindestens zwei ELF\-Binärdateien ausliefert, \fBdwz\fR\|(1) anweisen, eine Mehrfachdatei für das Paket zu erstellen.
.Sp
Standardmäßig wird \fBdh_dwz\fR versuchen, eine Mehrfachdatei zu erstellen, es wird jedoch ohne sie fortfahren, falls \fBdwz\fR\|(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 \fB\-\-dwz\-multifile\fR übergeben wurde, wird \fBdh_dwz\fR mit einem Fehler abbrechen, falls \fBdwz\fR\|(1) keine Mehrfachdatei erstellt.
.Sp
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 \fB\-\-no\-dwz\-multifile\fR an, um diese Angelegenheit zu umgehen.
.Sp
Die erstellte Mehrfachdatei wird mit \fBobjcopy \-\-compress\-debug\-sections\fR komprimiert.
.Sp
Beachten Sie bei \fBudeb\fR\-Paketen: \fBdh_dwz\fR wird niemals Mehrfachdateien für \fBudeb\fR\-Pakete erzeugen. Es wird weiterhin \fBdwz\fR benutzen, um die Größe der Fehlersuchdateien zu verringern, falls es welche findet.
.IP "\fB\-X\fR\fIElement\fR, \fB\-\-exclude=\fR\fIElement\fR" 4
.IX Item "-XElement, --exclude=Element"
schließt Dateien, die irgendwo in ihrem Dateinamen genanntes \fIElement\fR enthalten, vom Entfernen der Symbole aus. Sie können diese Option mehrfach benutzen, um eine Liste auszuschließender Dinge zu erstellen.
.IP "\fB\-\-\fR \fIParameter\fR" 4
.IX Item "-- Parameter"
übergibt \fIParameter\fR an \fBdwz\fR\|(1), wenn es ELF\-Binärdateien verarbeitet. Dies ist meist nützlich, um speicherbezogene Parameter zu setzen (z.B. \-l und \-L).
.SH ANMERKUNGEN
.IX Header "ANMERKUNGEN"
Falls die Umgebungsvariable \fBDEB_BUILD_OPTIONS\fR \fBnostrip\fR enthält, werden getreu der Debian-Richlinie (Abschnitt 10.1. »Binaries«) keine Symbole entfernt.
.PP
Obwohl dieses Werkzeug aus technischer Sicht keine Fehlersuchinformationen aus Binärdateien entfernt, wird es dennoch übersprungen, wenn die Umgebungsvariable \fBDEB_BUILD_OPTIONS\fR \fBnostrip\fR enthält. Dies rührt daher, dass \fBnostrip\fR oft zum Optimieren der Bauzeit benutzt wird (z. B. für »Bau\- und Test«\-Zyklen), anstatt sie größenmäßig zu optimieren.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBdebhelper\fR\|(7)
.PP
Dieses Programm ist Teil von Debhelper.
.SH ÜBERSETZUNG
.IX Header "ÜBERSETZUNG"
Diese Übersetzung wurde mit dem Werkzeug
\&\fBpo4a\fR
durch Chris Leick
\&\fIc.leick@vollbio.de\fR
und das deutsche Debian\-Übersetzer\-Team im
Dezember 2011 erstellt.
.PP
Bitte melden Sie alle Fehler in der Übersetzung an
\&\fIdebian\-l10n\-german@lists.debian.org\fR
oder als Fehlerbericht an das Paket
\&\fIdebhelper\fR.
.PP
Sie können mit dem folgenden Befehl das englische
Original anzeigen
man\ \-L\ en\ Abschnitt\ Handbuchseite
.SH AUTOR
.IX Header "AUTOR"
Niels Thykier