341 lines
10 KiB
HTML
341 lines
10 KiB
HTML
|
||
<!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"> </A>
|
||
<H2>NOM</H2>
|
||
|
||
|
||
|
||
dh_makeshlibs - Créer automatiquement le fichier shlibs et exécuter
|
||
dpkg-gensymbols
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
|
||
|
||
<B>dh_makeshlibs</B> [<I>options_de_debhelper</I>] [<B>-m</B><I>numéro-majeur</I>]
|
||
[<B>-V</B><I>[dépendances]</I>] [<B>-n</B>] [<B>-X</B><I>élément</I>] [<B>--</B> <I>paramètres</I>]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
|
||
|
||
<B>dh_makeshlibs</B> est le programme de la suite debhelper qui automatise la
|
||
recherche des bibliothèques partagées et produit un fichier « shlibs » pour
|
||
celles qu'il trouve.
|
||
<P>
|
||
|
||
Il s'assure aussi que ldconfig est invoqué durant l'installation et la
|
||
suppression lorsqu'il trouve des bibliothèques partagées. Depuis
|
||
debhelper 9.20151004, cela est effectué par un trigger de dpkg. Dans les
|
||
anciennes versions de debhelper, <B>dh_makeshlibs</B> générait un script de
|
||
maintenance pour cela.
|
||
<P>
|
||
|
||
Since debhelper 12.3, <B>dh_makeshlibs</B> will by default add an additional
|
||
<I>udeb</I> line for udebs in the shlibs file, when the udeb has the same name
|
||
as the deb followed by a ``-udeb'' suffix (e.g. if the deb is called
|
||
``libfoo1'', then debhelper will auto-detect the udeb if it is named
|
||
``libfoo1-udeb''). Please use the <B>--add-udeb</B> and <B>--no-add-udeb</B> options
|
||
below when this auto-detection is insufficient.
|
||
<P>
|
||
|
||
If you previously used <B>--add-udeb</B> and is considering to migrate to using
|
||
the auto-detection new auto-detection feature in 12.3, then please remember
|
||
to test that the resulting <I>DEBIAN/shlibs</I> files are as expected. There
|
||
are some known corner cases, where the auto-detection is insufficient.
|
||
These include when the udeb contains library files from multiple regular deb
|
||
packages or when the packages do not follow the expected naming convention.
|
||
<A NAME="lbAE"> </A>
|
||
<H2>FICHIERS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>paquet</I>.shlibs<DD>
|
||
|
||
|
||
Si présent, installe ce fichier dans le paquet en tant que
|
||
DEBIAN/shlibs. S'il est omis, debhelper génèrera automatiquement un fichier
|
||
shlibs s'il détecte une bibliothèque.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Veuillez noter que, dans les niveaux de compatibilité 9 et précédents, ce
|
||
fichier était installé par <B><A HREF="/cgi-bin/man/man2html?1+dh_installdeb">dh_installdeb</A></B>(1) plutôt que par
|
||
<B>dh_makeshlibs</B>.
|
||
<DT id="2">debian/<I>paquet</I>.symbols<DD>
|
||
|
||
|
||
|
||
<DT id="3">debian/<I>paquet</I>.symbols.<I>arch</I><DD>
|
||
|
||
|
||
|
||
Ces fichiers de symboles, s'ils existent, sont transmis à
|
||
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1) pour être traités et installés. Préciser le nom de
|
||
l'architecture avec <I>arch</I> s'il est nécessaire de fournir des fichiers de
|
||
symboles différents pour diverses architectures.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="4"><B>-m</B><I>numéro-majeur</I>, <B>--major=</B><I>numéro-majeur</I><DD>
|
||
|
||
|
||
Utilise le numéro majeur indiqué après le paramètre <B>-m</B> afin de préciser
|
||
le numéro majeur de version de la bibliothèque, au lieu d'essayer de le
|
||
déterminer avec objdump. Ce paramètre est devenu beaucoup moins utile
|
||
qu'autrefois où ce programme se basait sur les noms des fichiers de
|
||
bibliothèque et non sur l'utilisation d'objdump.
|
||
<DT id="5"><B>-V</B>, <B>-V</B><I>dépendances</I><DD>
|
||
|
||
|
||
|
||
<DT id="6"><B>--version-info</B>, <B>--version-info=</B><I>dépendances</I><DD>
|
||
|
||
|
||
|
||
Si un fichier shlibs est créé par ce programme, cette option contrôle quelle
|
||
version sera utilisée dans la relation de dépendance.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Depuis la version 12, <B>dh_makeshlibs</B> utilise <B>-VUpstream-Version</B> par
|
||
défaut. Jusqu'à la version 11, le comportement par défaut imitait <B>-VNone</B>.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
<B>dh_makeshlibs</B> peut générer des dépendances de trois façons.
|
||
<DL COMPACT><DT id="7"><DD>
|
||
<DL COMPACT>
|
||
<DT id="8"><B>-VUpstream-Version</B><DD>
|
||
|
||
|
||
La dépendance sera de la forme « <I>paquet</I> <B>(></B>=
|
||
<I>version</I><B>)</B> ». <I>Upstream-Version</I> est sensible à la casse est doit être
|
||
écrit exactement comme cela.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
C'est une disposition conservatoire qui garantit que les dépendances des
|
||
autres paquets envers la bibliothèque partagée sont aussi strictes qu'elles
|
||
le doivent (à moins que la bibliothèque soit sujette à des changements d'<FONT SIZE="-1">ABI</FONT>
|
||
sans mise à jour des numéros de version amont).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Le revers de cela est que les paquets pourraient avoir des dépendances qui
|
||
sont trop restreintes (mais un fichier de symboles peut atténuer le
|
||
problème). Ce n'est souvent qu'un inconvénient mineur et temporaire,
|
||
préférable à un échec dû à l'oubli de la mise à jour d'une information de
|
||
dépendance.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Ce format explicite a été ajouté à debhelper/11.3. Dans les versions
|
||
précédentes, une option <B>-V</B> sans aucune information de dépendance était
|
||
utilisée (ce qui fonctionne toujours).
|
||
<DT id="9"><B>-VNone</B><DD>
|
||
|
||
|
||
La dépendance sera de la forme « <I>paquet</I> ». <I>None</I> est sensible à la
|
||
casse est doit être écrit exactement comme cela.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Ce format n'est pas sécurisé, sauf si l'amont ne modifie pas son <FONT SIZE="-1">ABI</FONT>
|
||
d'aucune façon. Cependant, la plupart des équipes amont améliorent leurs
|
||
interfaces au cours du temps, et il est recommandé d'utiliser
|
||
<B>-VUpstream-Version</B> (ou l'une des autres formes de <B>-V</B><I>dépendances</I>).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Par ailleurs, cela pourrait être suffisant si (et seulement si) le paquet
|
||
utilise le versionnement des symboles (voir <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1)) et ne
|
||
produit <I>aucun</I> paquet udeb. Les symboles ne sont pas pris en charge pour
|
||
les paquets udeb, qui ne s'appuient que sur shlibs pour la gestion des
|
||
dépendances.
|
||
<DT id="10"><B>-V</B><I>relation-paquet</I><DD>
|
||
|
||
|
||
Dans ce cas, la valeur donnée à <B>-V</B> sera utilisée comme une relation de
|
||
dépendance. <I>relation-paquet</I> devrait être de la forme « <I>paquet</I>
|
||
<B>(></B>= <I>version</I><B>)</B> ». N'oubliez pas d'inclure le nom de paquet.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Veuillez noter que debhelper utilisera la valeur <I>telle quelle</I> sans
|
||
vérification de propreté ni de modification. Dans de <I>rares</I> cas, cela est
|
||
nécessaire pour générer une dépendance sur un paquet différent que celui qui
|
||
contient la bibliothèque.
|
||
</DL>
|
||
</DL>
|
||
|
||
<DL COMPACT><DT id="11"><DD>
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Au moment de choisir une valeur pour cette option, gardez à l'esprit que si
|
||
le paquet fournit un fichier de symboles, ce dernier est souvent préféré au
|
||
fichier shlibs pour les paquets .deb habituels. Consultez
|
||
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-shlibdeps">dpkg-shlibdeps</A></B>(1) pour plus d'informations sur ce sujet.
|
||
</DL>
|
||
|
||
<DT id="12"><B>-n</B>, <B>--no-scripts</B><DD>
|
||
|
||
|
||
N'ajoutez pas l'action différée (« trigger ») même s'il semble que le paquet
|
||
en a besoin. L'option est nommée <B>--no-scripts</B> pour des raisons
|
||
historiques car <B>dh_makeshlibs</B> générait précédemment un script de
|
||
maintenance qui appelait <B>ldconfig</B>.
|
||
<DT id="13"><B>-X</B><I>élément</I>, <B>--exclude=</B><I>élément</I><DD>
|
||
|
||
|
||
Permet d'exclure du traitement des bibliothèques partagées les fichiers qui
|
||
comportent <I>élément</I> n'importe où dans leur nom.
|
||
<DT id="14"><B>--add-udeb=</B><I>udeb</I><DD>
|
||
|
||
|
||
Ajoute une ligne supplémentaire, pour les udebs, dans le fichier shlibs et
|
||
rend les udebs dépendants du paquet indiqué par <I>udeb</I> plutôt que les
|
||
rendre dépendants du paquet normal de la bibliothèque.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
This option is only useful for special cases such as when debhelper cannot
|
||
auto-detect package name of the udeb package, when the udeb will contain
|
||
libraries from multiple deb packages, or when the udeb contains libraries
|
||
<B>not</B> present in the deb package.
|
||
<DT id="15"><B>--no-add-udeb</B><DD>
|
||
|
||
|
||
Do not add any udeb lines to the shlibs file. This can be used to disable
|
||
the default auto-detection of udebs.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
This may be useful in case you do not want a shlibs file at all for the udeb
|
||
because no package will depend on it. E.g. because adding a udeb package
|
||
for the library was ``overkill'' and the library is embedded in a different
|
||
udeb package.
|
||
<DT id="16"><B>--</B> <I>paramètres</I><DD>
|
||
|
||
|
||
Fournit <I>paramètres</I> à <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gensymbols">dpkg-gensymbols</A></B>(1).
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>EXEMPLES</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="17"><B>dh_makeshlibs -VNone</B><DD>
|
||
|
||
|
||
En admettant que le paquet s'appelle <I>libtoto1</I>, cette commande produit un fichier
|
||
shlibs tel que :
|
||
libtoto 1 libtoto1
|
||
<DT id="18"><B>dh_makeshlibs -VUpstream-Version</B><DD>
|
||
|
||
|
||
En admettant que la version actuelle du paquet soit 1.1-3, cette commande produit un fichier shlibs tel que :
|
||
<BR> libtoto 1 libtoto1 (>= 1.1)
|
||
<DT id="19"><B>dh_makeshlibs -V `libtoto1 (>= 1.0)'</B><DD>
|
||
|
||
|
||
Produit un fichier shlibs tel que :
|
||
<BR> libtoto 1 libtoto1 (>= 1.0)
|
||
</DL>
|
||
<A NAME="lbAH"> </A>
|
||
<H2>VOIR AUSSI</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
Ce programme fait partie de debhelper.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>AUTEUR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>TRADUCTION</H2>
|
||
|
||
|
||
|
||
Cette traduction est maintenue à l'aide de l'outil po4a
|
||
<URL:<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>> par l'équipe francophone de traduction
|
||
de Debian.
|
||
<P>
|
||
|
||
Veuillez signaler toute erreur de traduction en écrivant à
|
||
<<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>> ou par un rapport de bogue sur le paquet
|
||
debhelper.
|
||
<P>
|
||
|
||
Vous pouvez toujours avoir accès à la version anglaise de ce document en
|
||
utilisant la commande « man -L C <section> <page_de_man> ».
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="20"><A HREF="#lbAB">NOM</A><DD>
|
||
<DT id="21"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||
<DT id="22"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||
<DT id="23"><A HREF="#lbAE">FICHIERS</A><DD>
|
||
<DT id="24"><A HREF="#lbAF">OPTIONS</A><DD>
|
||
<DT id="25"><A HREF="#lbAG">EXEMPLES</A><DD>
|
||
<DT id="26"><A HREF="#lbAH">VOIR AUSSI</A><DD>
|
||
<DT id="27"><A HREF="#lbAI">AUTEUR</A><DD>
|
||
<DT id="28"><A HREF="#lbAJ">TRADUCTION</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:05:01 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|