.\" -*- 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_STRIP 1" .TH DH_STRIP 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_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 von Programmen, gemeinsam benutzten Bibliotheken und einigen statischen Bibliotheken, die nicht während der Ausführung verwendet werden, zuständig ist. .PP Dieses Programm untersucht Ihre Paketbauverzeichnisse und ermittelt selbsttätig, wo 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) enthalten 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 wird in fast allen Fällen das Richtige tun. .PP Da es sehr schwierig ist, automatisch festzustellen, ob eine Datei ein Modul enthält und wie die Symbole eines Moduls entfernt werden, bearbeitet \fBdh_strip\fR derzeit binären 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, 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\-\-dbg\-package=\fR\fIPaket\fR 4 .IX Item "--dbg-package=Paket" \&\fBDiese Option ist nun eine Option für besondere Zwecke und Sie benötigensie normalerweise nicht\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 die Debug-Symbole, die es aus den bearbeiteten Paketen entfernt hat, als einzelne Dateien im Paketbauverzeichnis des angegebenen Fehlersuchpakets zu sichern. .Sp Falls zum Beispiel Ihre Pakete libfoo und foo sind und Sie ein \fIfoo-dbg\fR\-Paket mit Debug-Symbolen mitliefern 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 und Sie benötigensie normalerweise nicht\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 unabhängige Dateien in \fIusr/lib/debug/\fR im Paketbauverzeichnis aufgeteilt. \fB\-\-dbg\-package\fR ist einfacher zu benutzen als diese Option, 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; diese wird dem Fehlersuch-Symbolpaket hinzugefügt werden, 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 \fBDEB_BUILD_OPTIONS\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 \fBDEB_BUILD_OPTIONS\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