.\" -*- 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_MAKESHLIBS 1"
.TH DH_MAKESHLIBS 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_makeshlibs \- erstellt automatisch die Shlibs\-Datei und ruft dpkg\-gensymbols auf
.SH ÜBERSICHT
.IX Header "ÜBERSICHT"
\&\fBdh_makeshlibs\fR [\fIDebhelper-Optionen\fR] [\fB\-m\fR\fIMajor\fR] [\fB\-V\fR\fI[Abhängigkeiten]\fR] [\fB\-n\fR] [\fB\-X\fR\fIElement\fR] [\fB\-\-\fR\ \fIParameter\fR]
.SH BESCHREIBUNG
.IX Header "BESCHREIBUNG"
\&\fBdh_makeshlibs\fR ist ein Debhelper-Programm, das automatisch nach gemeinsam benutzten Bibliotheken sucht und für die gefundenen Bibliotheken eine Shlibs-Datei erzeugt.
.PP
Es stellt außerdem sicher, dass Ldconfig während der Installation und Entfernung aufgerufen wird, wenn es gemeinsam benutzte Bibliotheken findet. Seit Debhelper 9.20151004 wird dafür ein Dpkg\-Auslösers eingesetzt. In älteren Versionen von Debhelper würde \fBdh_makeshlibs\fR zu diesem Zweck ein Betreuerskript erzeugen.
.PP
Seit Debhelper 12.3 wird \fBdh_makeshlibs\fR standardmäßig in der Datei shlibs eine zusätzliche \fIudeb\fR\-Zeile eintragen, wenn das Udeb denselben Namen wie das Deb hat, gefolgt von einer »\-udeb«\-Endung (wenn z. B. das Deb »libfoo1« heißt, dann wird Debhelper ein Udeb namens »libfoo1\-udeb« automatisch erkennen. Bitte benutzen Sie die nachfolgenden Optionen \fB\-\-add\-udeb\fR und \fB\-\-no\-add\-udeb\fR, wenn diese automatische Erkennung nicht ausreicht.
.PP
Falls Sie vorher \fB\-\-add\-udeb\fR benutzt haben und mit dem Gedanken spielen, auf die neue automatische Erkennungsfunktionalität in 12.3 zu migrieren, dann denken Sie bitte daran zu testen, ob die resultierenden \fIDEBIAN/shlibs\fR\-Dateien wie erwartet ausfallen. Es gibt einige bekannte Ausnahmefälle, in denen die automatische Erkennung nicht ausreicht. Dazu zählt u. a., dass das Udeb Bibliotheksdateien aus mehreren normalen Deb-Paketen enthält oder dass die Pakete nicht der erwarteten Namensübereinkunft folgen.
.SH DATEIEN
.IX Header "DATEIEN"
.IP debian/\fIPaket\fR.shlibs 4
.IX Item "debian/Paket.shlibs"
installiert, falls vorhanden, diese Datei in das Paket als DEBIAN/shlibs. Falls es weggelassen wird, erzeugt Debhelper automatisch eine Shlibs-Datei wenn es irgendwelche Bibliotheken entdeckt.
.Sp
Beachten Sie, dass diese Datei in Kompatibilitätsmodi 9 und älter durch \fBdh_installdeb\fR\|(1) anstatt durch \fBdh_makeshlibs\fR installiert wurde.
.IP debian/\fIPaket\fR.symbols 4
.IX Item "debian/Paket.symbols"
.PD 0
.IP debian/\fIPaket\fR.symbols.\fIArchitektur\fR 4
.IX Item "debian/Paket.symbols.Architektur"
.PD
Diese Symboldateien werden, falls sie vorhanden sind, zur Verarbeitung und Installation an \fBdpkg\-gensymbols\fR\|(1) übergeben. Benutzen Sie die für die \fIArchitektur\fR spezifischen Dateinamen, falls Sie mehrere unterschiedliche Symbole für unterschiedliche Architekturen bereitstellen müssen.
.SH OPTIONEN
.IX Header "OPTIONEN"
.IP "\fB\-m\fR\fIHauptnummer\fR, \fB\-\-major=\fR\fIHauptnummer\fR" 4
.IX Item "-mHauptnummer, --major=Hauptnummer"
benutzt die nach dem Parameter \-m angegebene Hauptnummer, anstatt zu versuchen, die Hauptnummer der Bibliothek mit Objdump zu erraten. Dies ist weit weniger nützlich als früher zu den schlechten alten Zeiten, als dieses Programm nach Bibliotheksdateinamen suchte, anstatt Objdump zu verwenden.
.IP "\fB\-V\fR, \fB\-V\fR\fIAbhängigkeiten\fR" 4
.IX Item "-V, -VAbhängigkeiten"
.PD 0
.IP "\fB\-\-version\-info\fR, \fB\-\-version\-info=\fR\fIAbhängigkeiten\fR" 4
.IX Item "--version-info, --version-info=Abhängigkeiten"
.PD
Falls durch dieses Programm eine Shlibs-Datei erzeugt wurde, steuert diese Option, welche Version in der Abhängigkeitsbeziehung benutzt werden soll.
.Sp
Auf Kompatibilitätsstufe 12 und höher ist die Voreinstellung von \fBdh_makeshlibs\fR \fB\-VUpstream\-Version\fR. Auf Kompatibilitätsstufe 11 und niedriger verhält sich die Voreinstellung wie \fB\-VNone\fR.
.Sp
Das Werkzeug \fBdh_makeshlibs\fR kann Abhängigkeiten in drei Varianten erzeugen:
.RS 4
.IP \fB\-VUpstream\-Version\fR 4
.IX Item "-VUpstream-Version"
Die Abhängigkeit wird »\fIPaketname\fR \fB(>\fR= \fIPaketversion\fR\fB)\fR« lauten. Beachten Sie, dass \fIVUpstream-Version\fR Groß\- und Kleinschreibung berücksichtigt und genau wie hier gezeigt geschrieben werden muss.
.Sp
Dies ist eine zurückhaltende Einstellung, die immer sicherstellt, dass die Abhängigkeiten von gemeinsam benutzten Bibliotheken anderer Pakete mindestens so eng sind wie erforderlich (es sei denn, in Ihrer Bibliothek wird gern das ABI geändert, ohne die Versionsnummer der Ursprungsautoren zu aktualisieren).
.Sp
Die Kehrseite ist, dass Pakete mit Abhängigkeiten enden können, die in einigen Fällen zu eng sind (beachten Sie, dass eine Symboldatei dieses Problem entschärfen kann). Dies ist aber oft eine kleine, vorübergehende Unannehmlichkeit und normalerweise viel besser als der Rattenschwanz an Problemen, der entsteht, wenn vergessen wird, die Abhängigkeitsinfos mitzupflegen.
.Sp
Diese eindeutige Form wurde in Debhelper/11.3 hinzugefügt. In früheren Versionen wurde stattdessen ein \fB\-V\fR ohne irgendwelche Abhängigkeitsinformationen benutzt (und diese Form funktioniert immer noch).
.IP \fB\-VNone\fR 4
.IX Item "-VNone"
Die Abhängigkeit wird »\fIPaketname\fR« lauten. Beachten Sie, dass \fINone\fR die Groß\- und Kleinschreibung berücksichtigt und daher genau wie hier gezeigt geschrieben werden muss.
.Sp
Diese Form ist im Allgemeinen unsicher, es sei denn, die Ursprungsautoren erweitern das ABI in keiner Weise. Die meisten Ursprungsautoren verbessern jedoch ihre Schnittstellen mit der Zeit und es wird Paketierern empfohlen, \fB\-VUpstream\-Version\fR (oder eine der anderen Formen von \fB\-V\fR\fIAbhängigkeiten\fR) zu verwenden.
.Sp
Alterantiv kann dies ausreichen, falls (und nur falls) das Paket Symbolversionierung verwendet (siehe \fBdpkg\-gensymbols\fR\|(1)) und \fIkeine\fR Udeb-Pakete baut. Beachten Sie, dass Symbole nicht von Udeb-Paketen unterstützt werden, die sich bei der Behandlung von Abhängigkeiten ausschließlich auf Shlibs verlassen.
.IP \fB\-V\fR\fIPaketbeziehung\fR 4
.IX Item "-VPaketbeziehung"
In diesem Fall wird der an \fB\-V\fR übergebene Wert als Abhängigkeitsbeziehung benutzt. Die \fIPaketbeziehung\fR sollte generell die Form »\fIirgendein-Paketname\fR \fB(>\fR= \fIirgendeine-Paketversion)\fR haben. Denken Sie daran, den Paketnamen beizufügen.
.Sp
Beachten Sie, dass Debhelper diesen Wert so benutzen wird, \fIwie er ist\fR, ohne zu prüfen, ob er vernünftig und ohne Änderung ist. In \fIseltenen Sonderfällen\fR ist das erforderlich, um eine Abhängigkeit zu einem anderen Paket zu erzeugen als dem, das die Bibliothek enthält.
.RE
.RS 4
.Sp
Wenn ein Wert für diese Option gewählt wird, denken Sie bitte daran, dass eine Symboldatei generell den Vorzug gegenüber der Shlibs-Datei für normale .deb\-Pakete erhält, falls das Paket eine solche bereitstellt. Weitere Informationen über dieses Thema finden Sie unter \fBdpkg\-shlibdeps\fR\|(1).
.RE
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Fügen Sie den Auslöser »ldconfig« selbst dann nicht hinzu, wenn das Paket ihn scheinbar benötigt. Diese Option wird aus historischen Gründen \fB\-\-noscripts\fR genannt, da \fBdh_makeshlibs\fR früher Betreuerskripte erzeugt hatte, die \fBldconfig\fR aufriefen.
.IP "\fB\-X\fR\fIElement\fR, \fB\-\-exclude=\fR\fIElement\fR" 4
.IX Item "-XElement, --exclude=Element"
schließt Dateien aus, die irgendwo in ihrem Datei\- oder Verzeichnisnamen \fIElement\fR enthalten, als gemeinsam benutzte Bibliotheken betrachtet zu werden.
.IP \fB\-\-add\-udeb=\fR\fIUdeb\fR 4
.IX Item "--add-udeb=Udeb"
erstellt eine zusätzliche Zeile für Udebs in der Shlibs-Datei und benutzt \fIUdeb\fR als Paketnamen für Udebs als Abhängigkeit, anstelle des regulären Bibliothekpakets.
.Sp
Diese Option eignet sich nur für Sonderfälle, beispielsweise wenn Debhelper den Paketnamen des Udeb-Pakets nicht automatisch ermitteln kann, das Udeb Bibliotheken aus mehreren Deb-Paketen enthalten wird oder das Udeb Bibliotheken enthält, die \fBnicht\fR im Deb-Paket enthalten sind.
.IP \fB\-\-no\-add\-udeb\fR 4
.IX Item "--no-add-udeb"
fügt der Shlibs-Datei keine Udeb-Zeilen hinzu. Damit kann die voreingestellte automatische Erkennung von Udebs deaktiviert werden.
.Sp
Dies kann nützlich sein, wenn Sie gar keine Shlibs-Datei für das Udeb wollen, weil kein Paket davon abhängt; bspw. weil das Hinzufügen eines Udeb-Pakets für die Bibliothek übertrieben wäre und die Bibliothek in ein anderes Udeb-Paket eingebettet ist.
.IP "\fB\-\-\fR \fIParameter\fR" 4
.IX Item "-- Parameter"
übergibt \fIParameter\fR an \fBdpkg\-gensymbols\fR\|(1).
.SH BEISPIELE
.IX Header "BEISPIELE"
.IP "\fBdh_makeshlibs \-VNone\fR" 4
.IX Item "dh_makeshlibs -VNone"
Angenommen, dies sei ein Paket mit Namen \fIlibfoobar1\fR, wird eine Shlibs-Datei
erzeugt, die ungefähr so aussieht:
libfoobar 1 libfoobar1
.IP "\fBdh_makeshlibs \-VUpstream\-Version\fR" 4
.IX Item "dh_makeshlibs -VUpstream-Version"
Angenommen, dies sei die aktuelle Version des Pakets 1.1\-3, wird eine
Shlibs-Datei erzeugt, die in etwa wie folgt aussieht:
libfoobar 1 libfoobar1 (>= 1.1)
.IP "\fBdh_makeshlibs \-V 'libfoobar1 (>= 1.0)'\fR" 4
.IX Item "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
erzeugt eine Shlibs-Datei, die in etwa so aussieht:
libfoobar 1 libfoobar1 (>= 1.0)
.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