man-pages/de/man1/dh_makeshlibs.1.html
2021-03-31 01:06:50 +01:00

354 lines
11 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DH_MAKESHLIBS</TITLE>
</HEAD><BODY>
<H1>DH_MAKESHLIBS</H1>
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
dh_makeshlibs - erstellt automatisch die Shlibs-Datei und ruft
dpkg-gensymbols auf
<A NAME="lbAC">&nbsp;</A>
<H2>ÜBERSICHT</H2>
<B>dh_makeshlibs</B> [<I>Debhelper-Optionen</I>] [<B>-m</B><I>Hauptnummer</I>]
[<B>-V</B><I>[Abhängigkeiten]</I>] [<B>-n</B>] [<B>-X</B><I>Element</I>] [<B>--</B> <I>Parameter</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>BESCHREIBUNG</H2>
<B>dh_makeshlibs</B> ist ein Debhelper-Programm, das automatisch nach gemeinsam
benutzten Bibliotheken sucht und eine Shlibs-Datei für die Dateien erzeugt,
die es findet.
<P>
Es wird außerdem sicherstellen, das Ldconfig während des Installierens und
Entfernens aufgerufen wird, wenn es gemeinsam benutzte Bibliotheken
findet. Seit Debhelper 9.20151004wird dies mittels eines Dpkg-Auslösers
erledigt. In älteren Versionen von Debhelper würde <B>dh_makeshlibs</B> zu
diesem Zweck ein Betreuerskript erzeugen.
<P>
seit Debhelper 12.3 wird <B>dh_makeshlibs</B> standardmäßig eine zusätzliche
<I>udeb</I>-Zeile in der Datei shlibs hinzufügen, wenn das Udeb denselben Namen
wie das Deb gefolgt von einer »-udeb«-Endung hat (z.B. falls das Deb
»libfoo1« heißt, dann wird Debhelper das Udeb automatisch erkennen, falls es
»libfoo1-udeb« heißt). Bitte benutzen Sie die nachfolgenden Optionen
<B>--add-udeb</B> und <B>--no-add-udeb</B>, wenn diese automatische Erkennung nicht
ausreicht.
<P>
Falls Sie vorher <B>--add-udeb</B> 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
<I>DEBIAN/shlibs</I>-Dateien wie erwartet sind. Es gibt einige bekannte
Ausnahmefälle, in denen die automatische Erkennung nicht ausreicht. Diese
beinhalten, wenn das Udeb Bibliotheksdateien aus mehreren normalen
Deb-Paketen enthält oder wenn die Pakete nicht der erwarteten
Namensübereinkunft folgen.
<A NAME="lbAE">&nbsp;</A>
<H2>DATEIEN</H2>
<DL COMPACT>
<DT id="1">debian/<I>Paket</I>.shlibs<DD>
installiert, falls vorhanden, diese Datei in das Paket als
DEBIAN/shlibs. Falls es weggelassen wird, erzeugt Debhelper automatisch eine
Shlibs-Datei falls es irgendwelche Bibliotheken entdeckt.
<P>
Beachten Sie, dass diese Datei in Kompatibilitätsmodi 9 und älter durch
<B><A HREF="/cgi-bin/man/man2html?1+dh_installdeb">dh_installdeb</A></B>(1) anstatt durch <B>dh_makeshlibs</B> installiert wurde.
<DT id="2">debian/<I>Paket</I>.symbols<DD>
<DT id="3">debian/<I>Paket</I>.symbols.<I>Architektur</I><DD>
Diese Symboldateien werden, falls Sie vorhanden sind, zur Verarbeitung und
Installation an <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1) übergeben. Benutzen Sie die für die
<I>Architektur</I> spezifischen Dateinamen, falls Sie mehrere unterschiedliche
Symbole für unterschiedliche Architekturen bereitstellen müssen.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONEN</H2>
<DL COMPACT>
<DT id="4"><B>-m</B><I>Hauptnummer</I>, <B>--major=</B><I>Hauptnummer</I><DD>
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, wie es früher zu den schlimmen alten Zeiten war, als
dieses Programm nach Bibliotheksdateinamen suchte, anstatt Objdump zu
verwenden.
<DT id="5"><B>-V</B>, <B>-V</B><I>Abhängigkeiten</I><DD>
<DT id="6"><B>--version-info</B>, <B>--version-info=</B><I>Abhängigkeiten</I><DD>
Falls durch dieses Programm eine Shlibs-Datei erzeugt wurde, steuert diese
Option, welche Version in der Abhängigkeitsbeziehung benutzt werden soll.
<P>
Auf Kompatibilitätsstufe 12 und höher ist die Voreinstellung von
<B>dh_makeshlibs</B> <B>-VUpstream-Version</B>. Auf Kompatibilitätsstufe 11 und
niedriger verhält sich die Voreinstellung wie <B>-VNone</B>.
<P>
Das Werkzeug <B>dh_makeshlibs</B> kann Abhängigkeiten in drei Varianten
erzeugen:
<DL COMPACT><DT id="7"><DD>
<DL COMPACT>
<DT id="8"><B>-VUpstream-Version</B><DD>
Die Abhängigkeit wird »<I>Paketname</I> <B>(&gt;</B>= <I>Paketversion</I><B>)</B>«
lauten. Beachten Sie, dass <I>VUpstream-Version</I> Groß- und Kleinschreibung
berücksichtigt und genau wie hier gezeigt geschrieben werden muss.
<P>
Dies ist eine behutsame Einstellung, die immer sicherstellt, dass gemeinsam
benutzte Bibliothekabhängigkeiten anderer Pakete mindestens so eng sind, wie
erforderlich (es sei denn, Ihre Bibliothek ist anfällig, das <FONT SIZE="-1">ABI</FONT> zu ändern,
ohne die Versionsnummer der Ursprungsautoren zu aktualisieren).
<P>
Die Kehrseite ist, dass Pakete mit Abhängigkeiten enden, die in einigen
Fällen zu eng sind (beachten Sie, dass eine Symboldatei dieses Problem
abschwächen kann). Dies ist oft eine kleine, vorübergehende Unannehmlichkeit
und normalerweise viel besser als mit den Problemen umzugehen, die durch das
Vergessen der Mitpflege von Abhängigkeitsinformationen verursacht werden.
<P>
Diese eindeutige Form wurde in Debhelper/11.3 hinzugefügt. In früheren
Versionen wurde stattdessen ein <B>-V</B> ohne irgendwelche
Abhängigkeitsinformationen benutzt (und diese Form funktioniert immer noch).
<DT id="9"><B>-VNone</B><DD>
Die Abhängigkeit wird »<I>Paketname</I>« lauten. Beachten Sie, dass <I>None</I> die
Groß- und Kleinschreibung berücksichtigt und daher genau wie hier gezeigt
geschrieben werden muss.
<P>
Diese Form ist im Allgemeinen unsicher, es sei denn, die Ursprungsautoren
erweitern das <FONT SIZE="-1">ABI</FONT> in keiner Weise. Die meisten Ursprungsautoren verbessern
jedoch ihre Schnittstellen mit der Zeit und es wird Paketierern empfohlen,
<B>-VUpstream-Version</B> (oder eine der anderen Formen von
<B>-V</B><I>Abhängigkeiten</I>) zu verwenden.
<P>
Alterantiv kann dies ausreichen, falls (und nur falls) das Paket
Symbolversionierung verwendet (siehe <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1)) und <I>keine</I>
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.
<DT id="10"><B>-V</B><I>Paketbeziehung</I><DD>
In diesem Fall wird der an <B>-V</B> übergebene Wert als Abhängigkeitsbeziehung
benutzt. Die <I>Paketbeziehung</I> sollte generell die Form
»<I>irgendein-Paketname</I> <B>(&gt;</B>= <I>irgendeine-Paketversion)</I> haben. Denken
Sie daran, den Paketname beizufügen.
<P>
Beachten Sie, dass Debhelper diesen Wert so benutzen wird, <I>wie er ist</I>,
ohne Prüfung, ob er vernünftig ist und ohne Änderung. In <I>seltenen
Sonder</I>fällen ist dies erforderlich, um eine Abhängigkeit zu einem anderen
Paket zu erzeugen als dem, das die Bibliothek enthält.
</DL>
</DL>
<DL COMPACT><DT id="11"><DD>
<P>
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 <B><A HREF="/cgi-bin/man/man2html?1+dpkg-shlibdeps">dpkg-shlibdeps</A></B>(1).
</DL>
<DT id="12"><B>-n</B>, <B>--no-scripts</B><DD>
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
<B>--noscripts</B> genannt, da <B>dh_makeshlibs</B> früher Betreuerskripte erzeugen
würde, die <B>ldconfig</B> aufriefen.
<DT id="13"><B>-X</B><I>Element</I>, <B>--exclude=</B><I>Element</I><DD>
schließt Dateien aus, die irgendwo in ihrem Datei- oder Verzeichnisnamen
<I>Element</I> enthalten, als Bibliotheken betrachtet zu werden.
<DT id="14"><B>--add-udeb=</B><I>Udeb</I><DD>
erstellt eine zusätzliche Zeile für Udebs in der Shlibs-Datei und benutzt
<I>Udeb</I> als Paketnamen für Udebs als Abhängigkeit, an Stelle des regulären
Bibliothekpakets.
<P>
Diese Option ist nur für Sonderfälle nützlich, beispielsweise wenn Debhelper
den Paketnamen des Udeb-Pakets nicht automatisch ermitteln kann, wenn das
Udeb Bibliotheken aus mehreren Deb-Paketen enthalten wird oder wenn das Udeb
Bibliotheken enthält, die <B>nicht</B> im Deb-Paket enthalten sind.
<DT id="15"><B>--no-add-udeb</B><DD>
Fügen Sie der Shlibs-Datei keine Udeb-Zeilen hinzu. Dies kann benutzt
werden, um die voreingestellte automatische Erkennung von Udebs zu
deaktivieren.
<P>
Dies kann nützlich sein, falls Sie gar keine Shlibs-Datei für das Udeb
wollen, da kein Paket davon abhängt. Z.B. weil das Hinzufügen eines
Udeb-Pakets für die Bibliothek übertrieben wäre und die Bibliothek in ein
anderes Udeb-Paket eingebettet ist.
<DT id="16"><B>--</B> <I>Parameter</I><DD>
übergibt <I>Parameter</I> an <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1).
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>BEISPIELE</H2>
<DL COMPACT>
<DT id="17"><B>dh_makeshlibs -VNone</B><DD>
unter der Annahme dass dies ein Paket mit Namen <I>libfoobar1</I> sei, wird eine Shlibs-Datei
erzeugt, die ungefähr so aussieht:
<BR>&nbsp;libfoobar&nbsp;1&nbsp;libfoobar1
<DT id="18"><B>dh_makeshlibs -VUpstream-Version</B><DD>
unter der Annahme, dass die aktuelle Version des Pakets 1.1-3 ist, wird eine
Shlibs-Datei erzeugt, die in etwa wie folgt aussieht:
<BR>&nbsp;libfoobar&nbsp;1&nbsp;libfoobar1&nbsp;(&gt;=&nbsp;1.1)
<DT id="19"><B>dh_makeshlibs -V 'libfoobar1 (&gt;= 1.0)'</B><DD>
erzeugt eine Shlibs-Datei, die in etwa so aussieht:
<BR>&nbsp;&nbsp;libfoobar&nbsp;1&nbsp;libfoobar1&nbsp;(&gt;=&nbsp;1.0)
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>SIEHE AUCH</H2>
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
<P>
Dieses Programm ist Teil von Debhelper.
<A NAME="lbAI">&nbsp;</A>
<H2>ÜBERSETZUNG</H2>
Diese Übersetzung wurde mit dem Werkzeug
<B>po4a</B>
&lt;<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>&gt;
durch Chris Leick
<I><A HREF="mailto:c.leick@vollbio.de">c.leick@vollbio.de</A></I>
und das deutsche Debian-Übersetzer-Team im
Dezember 2011 erstellt.
<P>
Bitte melden Sie alle Fehler in der Übersetzung an
<I><A HREF="mailto:debian-l10n-german@lists.debian.org">debian-l10n-german@lists.debian.org</A></I>
oder als Fehlerbericht an das Paket
<I>debhelper</I>.
<P>
Sie können mit dem folgenden Befehl das englische
Original anzeigen
man -L en Abschnitt Handbuchseite
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTOR</H2>
Joey Hess &lt;<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="20"><A HREF="#lbAB">NAME</A><DD>
<DT id="21"><A HREF="#lbAC">ÜBERSICHT</A><DD>
<DT id="22"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
<DT id="23"><A HREF="#lbAE">DATEIEN</A><DD>
<DT id="24"><A HREF="#lbAF">OPTIONEN</A><DD>
<DT id="25"><A HREF="#lbAG">BEISPIELE</A><DD>
<DT id="26"><A HREF="#lbAH">SIEHE AUCH</A><DD>
<DT id="27"><A HREF="#lbAI">ÜBERSETZUNG</A><DD>
<DT id="28"><A HREF="#lbAJ">AUTOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:04:56 GMT, March 31, 2021
</BODY>
</HTML>