.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. 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_STRIP 1"
.TH DH_STRIP 1 "2019-02-23" "12.1.1" "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_strip \- entfernt Symbole aus Programmen, gemeinsam benutzten Bibliotheken
und einigen statischen Bibliotheken
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
\&\fBdh_strip\fR [\fIDebhelper-Optionen\fR] [\fB\-X\fR\fIElement\fR]
[\fB\-\-dbg\-package=\fR\fIPaket\fR] [\fB\-\-keep\-debug\fR]
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBdh_strip\fR ist ein Debhelper-Programm, das für das Entfernen von Symbolen
aus von Programmen, gemeinsam benutzten Bibliotheken und einigen statischen
Bibliotheken, die nicht zur Fehlersuche verwandt werden, zuständig ist.
.PP
Dieses Programm untersucht Ihre Paketbauverzeichnisse und ermittelt alleine,
wovon Symbole entfernt werden müssen. Es verwendet \fBfile\fR\|(1),
Dateizugriffsrechte und Dateinamen, um herauszufinden, welche Dateien
gemeinsam benutzte Bibliotheken (\fI*.so\fR), Programme, statische Bibliotheken
(\fIlib*.a\fR) und solche zur Fehlersuche (\fIlib*_g.a\fR, \fIdebug/*.so\fR) sind und
entfernt so viele Symbole wie möglich (bei Fehlersuch-Bibliotheken werden
keine Symbole entfernt). Im Allgemeinen scheint es sehr gute Annahmen zu
treffen und in den meisten Fällen das Richtige tun.
.PP
Da es sehr schwierig ist, automatisch abzuschätzen, ob eine Datei ein Modul
ist und schwer festzustellen, wie Symbole eines Moduls entfernt werden,
bewältigt \fBdh_strip\fR derzeit nicht das Entfernen von Symbolen binärer
Module, wie etwa \fI.o\fR\-Dateien.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
.IP "\fB\-X\fR\fIElement\fR, \fB\-\-exclude=\fR\fIElement\fR" 4
.IX Item "-XElement, --exclude=Element"
schließt Dateien vom Entfernen der Symbole aus, die irgendwo in ihrem
Dateinamen \fIElement\fR enthalten. Sie können diese Option mehrfach benutzen,
um eine Liste auszuschließender Dinge zu erstellen.
.IP "\fB\-\-dbg\-package=\fR\fIPaket\fR" 4
.IX Item "--dbg-package=Paket"
\&\fBDiese Option ist nun eine Option für besondere Zwecke, die Sie
normalerweise nicht benötigen\fR. In den meisten Fällen sollte es nur wenige
Gründe geben, diese Option für neue Quellpakete zu benutzen, da Debhelper
automatisch Pakete zur Fehlersuche (»Dbgsym\-Pakete«) erzeugt. \fBFalls Sie
ein manuelles \-\-dbg\-package haben\fR, das Sie durch ein automatisch erzeugtes
Fehlersuch-Symbolpaket ersetzen möchten, sehen Sie sich bitte die Option
\&\fB\-\-dbgsym\-migration\fR an.
.Sp
veranlasst \fBdh_strip\fR Debug-Symbole als unabhängige Dateien im
Paketbauverzeichnis des angegebenen Fehlersuchpakets zu sichern, die aus den
Paketen, mit denen es arbeitet, entfernt wurden.
.Sp
Falls Ihre Pakete zum Beispiel libfoo und foo sind und Sie ein
\&\fIfoo-dbg\fR\-Paket mit Debug-Symbolen einfügen möchten, benutzen Sie
\&\fBdh_strip \-\-dbg\-package=\fR\fIfoo-dbg\fR.
.Sp
Diese Option impliziert \fB\-\-no\-automatic\-dbgsym\fR und \fIkann nicht\fR zusammen
mit \fB\-\-automatic\-dbgsym\fR oder \fB\-\-dbgsym\-migration\fR verwendet werden.
.IP "\fB\-k\fR, \fB\-\-keep\-debug\fR" 4
.IX Item "-k, --keep-debug"
\&\fBDiese Option ist nun eine Option für besondere Zwecke, die Sie
normalerweise nicht benötigen\fR. In den meisten Fällen sollte es nur wenige
Gründe geben, diese Option für neue Quellpakete zu benutzen, da Debhelper
automatisch Pakete zur Fehlersuche (»Dbgsym\-Pakete«) erzeugt. \fBFalls Sie
ein manuelles \-\-dbg\-package haben\fR, das Sie durch ein automatisch erzeugtes
Fehlersuch-Symbolpaket ersetzen möchten, sehen Sie sich bitte die Option
\&\fB\-\-dbgsym\-migration\fR an.
.Sp
Debug-Symbole werden beibehalten, aber in eine unabhängige Datei in
\&\fIusr/lib/debug/\fR im Paketbauverzeichnis aufgeteilt. \fB\-\-dbg\-package\fR ist
einfacher als diese Option zu benutzen, aber diese Option ist flexibler.
.Sp
Diese Option impliziert \fB\-\-no\-automatic\-dbgsym\fR und \fIkann nicht\fR zusammen
mit \fB\-\-ddeb\fR verwendet werden.
.IP "\fB\-\-dbgsym\-migration=\fR\fIPaketbeziehung\fR" 4
.IX Item "--dbgsym-migration=Paketbeziehung"
Diese Option wird benutzt, um von einem manuellen »\-dbg«\-Paket (das mit
\&\fB\-\-dbg\-package\fR erstellt wurde) zu einem automatisch erzeugten
Fehlersuch-Symbolpaket zu migrieren. Der Wert dieser Option sollte eine
gültige \fBReplaces\fR\- und \fBBreaks\fR\-Beziehung beschreiben, die dem
Fehlersuch-Symbolpaket hinzugefügt wird, um Dateikonflikte mit dem (nun
veralteten) \-dbg\-Paket zu vermeiden.
.Sp
Diese Option impliziert \fB\-\-automatic\-dbgsym\fR und \fIkann nicht\fR zusammen mit
\&\fB\-\-keep\-debug\fR, \fB\-\-dbg\-package\fR oder \fB\-\-no\-automatic\-dbgsym\fR verwendet
werden.
.Sp
Beispiele:
.Sp
.Vb 1
\& dh_strip \-\-dbgsym\-migration=\*(Aqlibfoo\-dbg (<< 2.1\-3~)\*(Aq
\&
\& dh_strip \-\-dbgsym\-migration=\*(Aqlibfoo\-tools\-dbg (<< 2.1\-3~), libfoo2\-dbg (<< 2.1\-3~)\*(Aq
.Ve
.IP "\fB\-\-automatic\-dbgsym\fR, \fB\-\-no\-automatic\-dbgsym\fR" 4
.IX Item "--automatic-dbgsym, --no-automatic-dbgsym"
steuert, ob \fBdh_strip\fR Fehlersuch-Symbolpakete erstellen soll, wenn
möglich.
.Sp
Die Vorgabe ist, Fehlersuch-Symbolpakete zu erstellen.
.IP "\fB\-\-ddebs\fR, \fB\-\-no\-ddebs\fR" 4
.IX Item "--ddebs, --no-ddebs"
historischer Name für \fB\-\-automatic\-dbgsym\fR und \fB\-\-no\-automatic\-dbgsym\fR
.IP "\fB\-\-ddeb\-migration=\fR\fIPaketbeziehung\fR" 4
.IX Item "--ddeb-migration=Paketbeziehung"
historischer Name für \fB\-\-dbgsym\-migration\fR
.SH "ANMERKUNGEN"
.IX Header "ANMERKUNGEN"
Falls die Umgebungsvariable \fB\s-1DEB_BUILD_OPTIONS\s0\fR \fBnostrip\fR enthält, werden
getreu der Debian-Richlinie (Abschnitt 10.1. »Binaries«) keine Symbole
entfernt. Dies wird auch das Erstellen automatischer Fehlersuch-Symbolpakete
verhindern.
.PP
Das automatische Erzeugen von Symbolpaketen zur Fehlersuche kann außerdem
durch Hinzufügen von \fBnoautodbgsym\fR zur Umgebungsvariablen
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR verhindert werden. \fBdh_strip\fR wird jedoch auch
weiterhin Fehlersuch-Links auf ELF\-Binärdateien hinzufügen, wenn dieser
Schalter gesetzt ist. Dies stellt sicher, dass das normale Deb-Paket mit
oder ohne diesen Schalter identisch ist (unter der Annahme, dass es
ansonsten »Bit\-für\-Bit« reproduzierbar ist).
.SH "KONFORM ZU"
.IX Header "KONFORM ZU"
Debian-Richlinie, Version 3.0.1
.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"
Joey Hess