1 files changed, 444 insertions, 0 deletions
diff --git a/man/fr/dpkg-shlibdeps.pod b/man/fr/dpkg-shlibdeps.pod
new file mode 100644
index 0000000..dae196e
--- /dev/null
+++ b/man/fr/dpkg-shlibdeps.pod
@@ -0,0 +1,444 @@
+
+        *****************************************************
+        *           GENERATED FILE, DO NOT EDIT             *
+        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
+        *****************************************************
+
+This file was generated by po4a(7). Do not store it (in VCS, for example),
+but store the PO file used as source file by po4a-translate.
+
+In fact, consider this as a binary, and the PO file as a regular .c file:
+If the PO get lost, keeping this translation up-to-date will be harder.
+
+=encoding UTF-8
+
+=head1 NOM
+
+dpkg-shlibdeps - Générateur de variables de substitution de dépendances pour
+bibliothèques partagées
+
+=head1 SYNOPSIS
+
+B<dpkg-shlibdeps> [I<option>...] [B<-e>] I<executable> [I<option>...]
+
+=head1 DESCRIPTION
+
+B<dpkg-shlibdeps> calcule, pour les exécutables indiqués dans ses
+paramètres, les dépendances envers les bibliothèques partagées. Ces
+dépendances sont ajoutées au fichier de variables de substitution
+B<debian/substvars> sous la forme B<shlibs:>I<champ-dépendance> où
+I<champ-dépendance> est le nom du champ de dépendance. Toute autre variable
+après I<shlibs:> est supprimée du fichier.
+
+B<dpkg-shlibdeps> a deux sources possibles pour créer les informations
+concernant les dépendances, soit les fichiers I<symbols>, soit les fichiers
+I<shlibs>. Pour chaque fichier binaire qu'il analyse, B<dpkg-shlibdeps>
+recherche la liste des bibliothèques partagées qui lui sont liées. Puis,
+pour chacune d'elles il analyse soit le fichier I<symbols>, soit le fichier
+I<shlibs> (si le premier n'existe pas ou si debian/shlibs.local contient les
+dépendances appropriées). Ces deux fichiers sont censés être fournis par le
+paquet de la bibliothèque et disponibles dans
+%ADMINDIR%/info/I<paquet>.I<symbols> ou
+%ADMINDIR%/info/I<paquet>.I<shlibs>. Le nom du paquet est trouvé en deux
+S<étapes :> en cherchant le fichier de la bibliothèque sur le système, dans le
+répertoire que B<ld.so> utiliserait, puis en utilisant B<dpkg -S>
+I<fichier-bibliothèque> pour trouver le paquet qui fournit cette
+bibliothèque.
+
+=head2 Fichiers symboles
+
+Les fichiers symboles contiennent des informations de dépendances plus fines
+en fournissant les dépendances minimales pour chaque symbole de la
+bibliothèque exportée. Le script essaie de trouver un fichier de symboles
+associé à un paquet de bibliothèque dans les emplacements suivants (le
+premier trouvé est S<utilisé) :>
+
+=over 
+
+=item debian/*/DEBIAN/symbols
+
+Les informations de bibliothèque partagée générées par l'actuel processus de
+construction qui invoque aussi B<dpkg-shlibdeps>. Elles sont générées par
+B<dpkg-gensymbols>(1) et ne sont utilisées que si la bibliothèque se trouve
+dans l'arbre de construction d'un paquet. Le fichier des symboles qui
+construit l'arbre s'appuie sur les fichiers de symboles d'autres paquets
+binaires.
+
+=item %PKGCONFDIR%/symbols/I<paquet>.symbols.I<architecture>
+
+=item %PKGCONFDIR%/symbols/I<paquet>.symbols
+
+Les informations de dépendance de bibliothèque partagée principales par
+système. I<arch> est l'architecture du système actuel (obtenue par
+B<dpkg-architecture -qDEB_HOST_ARCH>).
+
+=item Affichage de “B<dpkg-query --control-path> I<paquet> symbols”
+
+Les informations de dépendance de bibliothèque partagée fournies par le
+paquet. Sauf indication contraire par le biais de B<--admindir>, ces
+fichiers sont par défaut dans %ADMINDIR%.
+
+=back
+
+Lors de l'analyse des symboles utilisés par tous les binaires,
+B<dpkg-shlibdeps> retient la (plus grande) version minimale nécessaire pour
+chaque bibliothèque. À la fin du processus, il est capable d'écrire la
+dépendance minimale pour toutes les bibliothèques utilisées (à condition que
+l'information des fichiers I<symbols> soit exacte).
+
+Comme garde-fou, un fichier de symboles peut fournir un champ
+B<Build-Depends-Package> de méta-information et B<dpkg-shlibdeps> en
+extraira la version minimale requise par le paquet correspondant depuis ce
+champ B<Build-Depends> et utilisera cette version si elle est supérieure à
+la version minimale calculée par l'examen des symboles.
+
+=head2 Fichiers Shlibs
+
+Les fichiers Shlibs associent directement une bibliothèque à une dépendance
+(sans regarder les symboles). C'est donc souvent plus puissant que les
+besoins réels mais cela reste très sûr et facile à manipuler.
+
+Les dépendances d'une bibliothèque sont recherchées à plusieurs endroits. Le
+premier fichier d'informations trouvé qui concerne la bibliothèque est
+S<utilisé :>
+
+=over 
+
+=item debian/shlibs.local
+
+Fichier particulier à un paquet remplaçant les informations qui concernent
+les dépendances envers des bibliothèques partagées.
+
+=item %PKGCONFDIR%/shlibs.override
+
+Fichier système remplaçant les informations qui concernent les dépendances
+envers des bibliothèques partagées.
+
+=item debian/*/DEBIAN/shlibs
+
+Information sur la bibliothèque partagée générée par le processus actuel de
+construction qui invoque aussi B<dpkg-shlibdeps>. Il n'est utilisé que si la
+bibliothèque se trouve dans l'arbre de construction du paquet. Le fichier
+shlibs qui construit l'arbre a priorité sur les fichiers shlibs des autres
+paquets binaires.
+
+=item Affichage de S<« B<dpkg-query> --control-path> I<paquet> S<shlibs »>
+
+Les informations de dépendance de bibliothèque partagée fournies par le
+paquet. Sauf indication contraire par le biais de B<--admindir>, ces
+fichiers sont par défaut dans %ADMINDIR%.
+
+=item %PKGCONFDIR%/shlibs.default
+
+Fichier système par défaut concernant les informations de dépendance envers
+des bibliothèques partagées.
+
+=back
+
+Les dépendances trouvées sont ensuite directement utilisées (sauf si elles
+sont filtrées parce qu'elles ont été identifiées comme étant en double, ou
+d'un niveau plus faible qu'une autre dépendance).
+
+=head1 OPTIONS
+
+B<dpkg-shlibdeps> interprète des arguments sans option comme des commandes
+exécutables, comme si on avait simplement donné B<-e>I<exécutable>.
+
+=over 
+
+=item B<-e>I<exécutable>
+
+Cette option inclut les bonnes dépendances envers les bibliothèques
+partagées que demande I<exécutable>. Cette option peut être utilisée
+plusieurs fois.
+
+=item B<-l>I<répertoire>
+
+Ajoute I<répertoire> au début de la liste des répertoires où chercher des
+bibliothèques partagées privées (depuis S<dpkg 1.17.0).> Cette option peut être
+utilisée plusieurs fois.
+
+B<Note:> Use this option instead of setting B<LD_LIBRARY_PATH>, as that
+environment variable is used to control the run-time linker and abusing it
+to set the shared library paths at build-time can be problematic when
+cross-compiling for example.
+
+=item B<-d>I<champ-dépendance>
+
+Cette option ajoute les dépendances destinées au champ S<« dépendance »> du
+fichier de contrôle I<champ-dépendance>. (Les dépendances pour ce champ sont
+dans la variable B<shlibs:>I<champ-dépendance>.)
+
+L'option B<-d>I<champ-dépendance> concerne tous les exécutables qui suivent
+l'option, jusqu'à la prochaine option B<-d>I<champ-dépendance>. Par défaut,
+I<champ-dépendance> vaut B<Depends>.
+
+Quand, dans plusieurs champs reconnus ayant trait aux dépendances comme les
+champs B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> ou B<Suggests>
+apparaît la même entrée (ou bien un ensemble d'alternatives),
+B<dpkg-shlibdeps> supprime automatiquement les dépendances dans tous les
+champs sauf celui qui représente les dépendances les plus importantes.
+
+=item B<-p>I<préfixe-pour-le-nom-des-variables>
+
+Fait commencer les variables de substitution par
+I<préfixe-pour-le-nom-des-variables>B<:> au lieu de B<shlibs:>. De même,
+toute variable de substitution commençant par
+I<préfixe-pour-le-nom-des-variables>B<:> (au lieu de B<shlibs:>) est enlevée
+du fichier de substitution des variables.
+
+=item B<-O>[I<nom-de-fichier>]
+
+Affiche les définitions des variables de substitution sur la sortie standard
+(ou I<nom-de-fichier> si spécifié, depuis S<dpkg 1.17.2),> plutôt que de les
+ajouter dans le fichier de substitution des variables qui est par défaut
+B<debian/substvars>.
+
+=item B<-t>I<type>
+
+Préférer les informations sur les dépendances des bibliothèques partagées
+qui sont étiquetées pour un type de paquet donné. Si aucune information de
+type n'est donnée, il n'utilisera pas d'information. Par défaut, le type de
+paquet est B<deb>. On peut créer une étiquette pour ces informations en les
+préfixant par le nom du type, un deux-points et une espace.
+
+=item B<-L>I<fichier-local-shlibs>
+
+Lire les informations de remplacement concernant les dépendances envers les
+bibliothèques partagées dans I<fichier-local-shlibs> au lieu de
+B<debian/shlibs.local>.
+
+=item B<-T>I<fichier-substvars>
+
+Écrire les variables de substitution dans S<I<fichier-substvars> ;> le fichier
+par défaut est B<debian/substvars>.
+
+=item B<-v>
+
+Active le mode bavard (depuis S<dpkg 1.14.8).> De nombreux messages sont
+affichés pour expliquer ce que B<dpkg-shlibdeps> fait.
+
+=item B<-x>I<package>
+
+Exclut le paquet des dépendances générées (depuis S<dpkg 1.14.8).> Cela évite
+les auto-dépendances pour les paquets fournissant des exécutables ELF
+(exécutables ou modules complémentaires de bibliothèque) qui utilisent une
+bibliothèque incluse dans ce même paquet. Cette option peut être utilisée
+plusieurs fois pour exclure plusieurs paquets.
+
+=item B<-S>I<répertoire-construction-paquet>
+
+Recherche dans I<répertoire-construction-paquet> en premier et essaie de
+trouver une bibliothèque (depuis S<dpkg 1.14.15).> C'est utile lorsque le
+paquet source construit plusieurs saveurs de la même bibliothèque et que
+vous voulez vous assurer que vous obtiendrez la dépendance d'un paquet
+binaire donné. Cette option peut être utilisée plusieurs S<fois :> les
+répertoires seront examinés dans le même ordre avant les répertoires
+d'autres paquets binaires.
+
+=item B<-I>I<répertoire-construction-paquet>
+
+Ignore I<répertoire-construction-paquet> lors de la recherche des fichiers
+shlibs, de symboles et des bibliothèques partagées (depuis
+S<dpkg 1.18.5).> Cette option peut être utilisée plusieurs fois.
+
+=item B<--ignore-missing-info>
+
+Pas d'échec si l'information de dépendance ne peut pas être trouvée pour une
+bibliothèque partagée (depuis S<dpkg 1.14.8).> L'utilisation de cette option
+est déconseillée, toutes les bibliothèques devraient fournir leurs
+informations de dépendance (que ce soit avec les fichiers shlibs, ou avec
+les fichiers symboles), même si elles ne sont pas encore utilisées par
+d'autres paquets.
+
+=item B<--warnings=>I<valeur>
+
+I<valeur> est un champ de S<« bit »> définissant l'ensemble des avertissements
+qui peuvent être émis par B<dpkg-shlibdeps> (depuis S<dpkg 1.14.17).> Le bit
+B<0> S<(valeur = 1)> active l'avertissement S<« symbole> I<sym> utilisé par le
+I<binaire> trouvé dans aucune des S<bibliothèques ».> Le bit B<1> S<(valeur = 2)>
+active l'avertissement S<« le> paquet pourrait éviter une dépendance
+S<inutile ».> Le bit B<2> S<(valeur = 4)> active l'avertissement S<« Le> I<binaire>
+ne devrait pas être lié à S<I<bibliothèque> ».> La I<valeur> par défaut est
+S<B<3> :> les deux premières mises en garde sont actives par défaut, la
+dernière ne l'est pas. Positionnez la I<valeur> S<à 7> si vous souhaitez que
+tous les avertissements soient actifs.
+
+=item B<--admindir>=I<répertoire>
+
+Changer l'endroit où se trouve la base de données de B<dpkg> (depuis
+S<dpkg 1.14.0).> Par défaut, c'est I<%ADMINDIR%>.
+
+=item B<-?>, B<--help>
+
+Affiche un message d'aide puis quitte.
+
+=item B<--version>
+
+Affiche le numéro de version puis quitte.
+
+=back
+
+=head1 ENVIRONNEMENT
+
+=over 
+
+=item B<DPKG_COLORS>
+
+Définit le mode de couleur (depuis S<dpkg 1.18.5).> Les valeurs actuellement
+acceptées sont B<auto> (par défaut), B<always> et B<never>.
+
+=item B<DPKG_NLS>
+
+Si cette variable est définie, elle sera utilisée pour décider l'activation
+de la prise en charge des langues (NLS S<– Native> Language Support), connu
+aussi comme la gestion de l'internationalisation (ou i18n) (depuis
+S<dpkg 1.19.0).> Les valeurs permises S<sont :> B<0> et B<1> (par défaut).
+
+=back
+
+=head1 DIAGNOSTICS
+
+=head2 Avertissements
+
+Depuis que B<dpkg-shlibdeps> analyse l'ensemble des symboles utilisés par
+chaque binaire généré par le paquet, il est en mesure d'émettre des
+avertissements dans plusieurs cas. Ils vous informent des choses qui peuvent
+être améliorées dans le paquet. Dans la plupart des cas, ces améliorations
+concernent directement les sources amont. Dans l'ordre d'importance
+décroissant, voici les différents avertissements que vous pouvez
+S<rencontrer :>
+
+=over 
+
+=item B<symbole> I<sym> B<utilisé par> I<binaire> B<trouvé dans aucune des
+bibliothèques.>
+
+Le symbole indiqué n'a pas été trouvé dans les bibliothèques liées au
+binaire. Le I<binaire> est probablement plutôt une bibliothèque et il doit
+être lié avec une bibliothèque supplémentaire durant le processus de
+construction (l'option B<-l>I<bibliothèque> de l'éditeur de liens).
+
+=item I<binary> B<contient une référence non résolue au symbole> S<I<sym> B<:> il
+s'agit probablement d'un greffon (plugin)>
+
+Le symbole indiqué n'a pas été trouvé dans les bibliothèques liées avec le
+fichier binaire. Le I<binaire> est très probablement un greffon (plugin) et
+le symbole est probablement fourni par le programme qui charge ce
+greffon. En théorie, un greffon n'a pas de S<« SONAME »> mais ce binaire en
+possède un et n'a pas pu être identifié en tant que tel. Cependant, le fait
+que le binaire soit stocké dans un répertoire non public est une indication
+forte qu'il ne s'agit pas d'une bibliothèque partagée normale. Si le binaire
+est vraiment un greffon, vous pouvez ignorer cet avertissement. Il existe
+cependant une possibilité qu'il s'agisse d'un vrai binaire et que les
+programmes avec lequel il est lié utilisent un RPATH afin que le chargeur
+dynamique le trouve. Dans ce cas, la bibliothèque est incorrecte et doit
+être corrigée.
+
+=item B<paquet pourrait éviter une dépendance inutile si> I<le binaire> B<n'était
+pas lié avec> I<bibliothèque> B<(il ne fait usage d'aucun de ses symboles)>
+
+Aucun des I<binaires> liés à la I<bibliothèque> n'utilise les symboles
+qu'elle fournit. En corrigeant tous les binaires, vous éviteriez la
+dépendance associée à cette bibliothèque (à moins que la même dépendance
+soit également liée à une autre bibliothèque qui est elle réellement
+utilisée).
+
+=item B<paquet pourrait éviter une dépendance inutile si> I<les binaires>
+B<n'étaient pas liés avec> I<bibliothèque> B<(ils ne font usage d'aucun de
+ses symboles)>
+
+Identique à l'avertissement précédent, pour des binaires multiples.
+
+=item I<le binaire> B<ne devrait pas être lié avec la> I<bibliothèque> B<(il ne
+fait usage d'aucun de ses symboles)>
+
+Le I<binaire> est lié à une bibliothèque dont il n'a pas besoin. Ce n'est
+pas un problème, mais de petites améliorations de performance dans le temps
+de chargement de celui-ci peuvent être obtenues en ne le liant pas à cette
+bibliothèque. Cet avertissement vérifie la même information que la
+précédente mais elle le fait pour tous les binaires au lieu de ne faire le
+contrôle qu'au niveau global sur tous les binaires analysés.
+
+=back
+
+=head2 Erreurs
+
+B<dpkg-shlibdeps> échouera s'il ne peut pas trouver de bibliothèque publique
+utilisée par un binaire ou si cette bibliothèque n'a pas d'informations sur
+les dépendances associées (soit le fichier shlibs, soit le fichier des
+symboles). Une bibliothèque publique a un SONAME et un numéro de version
+(libsomething.so.I<X>). Une bibliothèque privée (comme un module
+additionnel) ne devrait pas avoir de SONAME et n'a pas besoin d'avoir de
+version.
+
+=over 
+
+=item B<impossible de trouver la bibliothèque> I<library-soname> B<demandée par
+le> I<binaire> B<(son RPATH est S<«> I<rpath>B< »)>>
+
+Le I<binaire> utilise une bibliothèque appelée I<library-soname> mais
+B<dpkg-shlibdeps> n'a pas été en mesure de trouver cette
+bibliothèque. B<dpkg-shlibdeps> crée une liste de répertoires à vérifier de
+la manière S<suivante :> les répertoires énumérés dans le RPATH du binaire, les
+répertoires ajoutés par l'option B<-l>, les répertoires listés dans la
+variable d'environnement B<LD_LIBRARY_PATH>, les répertoires croisés
+multi-architerctures (par exemple, /lib/arm64-linux-gnu,
+/usr/lib/arm64-linux-gnu), les répertoires publics standard (/lib,
+/usr/lib), les répertoires listés dans /etc/ld.so.conf et les répertoires
+obsolètes multilib (/lib32, /usr/lib32, /lib64, /usr/lib64). Ensuite, il
+vérifie les répertoires qui sont dans l'arbre de construction du paquet
+binaire en cours d'analyse, dans l'arbre de construction du paquet indiqué
+avec l'option de ligne de commande B<-S>, dans les autres arbres de paquets
+qui contiennent un fichier DEBIAN/shlibs ou DEBIAN/symbols et enfin dans le
+répertoire racine. Si la bibliothèque n'est pas trouvée dans l'un de ces
+répertoires, alors ce message d'erreur est obtenu.
+
+Si la bibliothèque non trouvée est cependant disponible dans le répertoire
+privé de ce même paquet, alors il vous faut ajouter ce répertoire avec
+B<-l>. S'il est dans un autre paquet binaire en cours de construction, alors
+assurez-vous que le fichier shlibs/symbols de ce paquet a déjà créé et que
+B<-l> contient le répertoire approprié si c'est aussi un répertoire privé.
+
+=item B<aucune information de dépendance trouvée pour> I<la bibliothèque>
+B<(utilisée par le> I<binaire>B<).>
+
+La bibliothèque nécessaire au I<binaire> a été trouvée par B<dpkg-shlibdeps>
+dans I<fichier-bibliothèque> mais B<dpkg-shlibdeps> n'a pas été en mesure de
+trouver d'informations de dépendance pour cette bibliothèque. Pour trouver
+la dépendance, il a essayé de lier la bibliothèque à un paquet Debian avec
+l'aide de B<dpkg -S> I<fichier-bibliothèque>. Puis, il a vérifié les shlibs
+correspondants et les fichiers symboles de %ADMINDIR%/info/ et enfin les
+différents arbres des paquets construits (debian/*/DEBIAN/).
+
+Cet échec peut être causé par un shlibs ou un fichier de symboles qui serait
+mauvais ou manquant dans le paquet. Une autre cause serait que la
+bibliothèque soit construite au sein du même paquet source et que les
+fichiers shlibs n'aient pas encore été créés (dans ce cas debian/rules doit
+être modifié pour créer le shlibs avant l'appel de B<dpkg-shlibdeps>). Un
+mauvais RPATH peut aussi conduire à ce que la bibliothèque soit trouvée sous
+un nom non canonique S<(comme :> /usr/lib/openoffice.org/../lib/libssl.so.0.9.8
+au lieu de /usr/lib/libssl.so.0.9.8) qui n'est associé à aucun paquet,
+B<dpkg-shlibdeps> essaie de contourner cela en se repliant vers un nom
+canonique (en utilisant B<realpath>(3)), mais cela ne fonctionne pas
+toujours. Il est toujours préférable de bien nettoyer le RPATH du binaire
+afin d'éviter ces problèmes.
+
+L'appel de B<dpkg-shlibdeps> en mode bavard (B<-v>) fournira beaucoup plus
+d'informations sur l'endroit où il a essayé de trouver l'information sur les
+dépendances. Cela peut être utile si vous ne comprenez pas pourquoi vous
+obtenez cette erreur.
+
+=back
+
+=head1 VOIR AUSSI
+
+B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1).
+
+
+=head1 TRADUCTION
+
+Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.
+Philippe Batailler, 2006.
+Nicolas François, 2006.
+Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.