diff options
Diffstat (limited to 'man/fr/dpkg-shlibdeps.pod')
| -rw-r--r-- | man/fr/dpkg-shlibdeps.pod | 52 |
1 files changed, 33 insertions, 19 deletions
diff --git a/man/fr/dpkg-shlibdeps.pod b/man/fr/dpkg-shlibdeps.pod index 74a47bb..8eb3258 100644 --- a/man/fr/dpkg-shlibdeps.pod +++ b/man/fr/dpkg-shlibdeps.pod @@ -24,11 +24,11 @@ B<dpkg-shlibdeps> [I<option>...] [B<-e>] I<exécutable> [I<option>...] 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. +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 é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é) :> +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 utilisé) : =over @@ -56,7 +56,7 @@ As a safe-guard measure, a symbols file can provide a B<Build-Depends-Package> o 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é :> +Les dépendances d'une bibliothèque sont recherchées à plusieurs endroits. Le premier fichier d'informations trouvé qui concerne la bibliothèque est utilisé : =over @@ -72,7 +72,7 @@ Fichier système remplaçant les informations qui concernent les dépendances en 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 »> +=item Affichage de « B<dpkg-query --control-path> I<paquet> 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%. @@ -96,25 +96,35 @@ Cette option inclut les bonnes dépendances envers les bibliothèques partagées =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. +Ajoute I<répertoire> au début de la liste des répertoires où chercher des bibliothèques partagées privées (depuis 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>.) +Cette option ajoute les dépendances destinées au champ « 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<--package=>I<package> + +Define the package name. + +When specified, the package name will be used to change defaults based on the binary package metadata in F<debian/control>. + +If the package is B<Essential: yes>, then the default dependency field is B<Pre-Depends>, otherwise B<Depends>. The default package type is set from the B<Package-Type> field. The package is added to the set of packages excluded by B<-x>. + +Option supported since dpkg 1.22.7. + =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>. +Affiche les définitions des variables de substitution sur la sortie standard (ou I<nom-de-fichier> si spécifié, depuis 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> @@ -130,27 +140,27 @@ Lire les informations de remplacement concernant les dépendances envers les bib =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. +Active le mode bavard (depuis 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. +Exclut le paquet des dépendances générées (depuis 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. +Recherche dans I<répertoire-construction-paquet> en premier et essaie de trouver une bibliothèque (depuis 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 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. +Ignore I<répertoire-construction-paquet> lors de la recherche des fichiers shlibs, de symboles et des bibliothèques partagées (depuis 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. +Pas d'échec si l'information de dépendance ne peut pas être trouvée pour une bibliothèque partagée (depuis 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> (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> (valeur = 2) active l'avertissement S<« le> paquet pourrait éviter une dépendance S<inutile ».> Le bit B<2> (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> à 7 si vous souhaitez que tous les avertissements soient actifs. +I<valeur> est un champ de « bit » définissant l'ensemble des avertissements qui peuvent être émis par B<dpkg-shlibdeps> (depuis dpkg 1.14.17). Le bit B<0> (valeur = 1) active l'avertissement « symbole I<sym> utilisé par le I<binaire> trouvé dans aucune des bibliothèques ». Le bit B<1> (valeur = 2) active l'avertissement « le paquet pourrait éviter une dépendance inutile ». Le bit B<2> (valeur = 4) active l'avertissement « Le I<binaire> ne devrait pas être lié à I<bibliothèque> ». La I<valeur> par défaut est 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> à 7 si vous souhaitez que tous les avertissements soient actifs. =item B<--admindir>=I<répertoire> @@ -170,13 +180,17 @@ Afficher le numéro de version puis quitter. =over +=item B<DEB_HOST_ARCH> + +Sets the host architecture. This affects the objects and symbols files searched for and their default search pathnames. + =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>. +Définit le mode de couleur (depuis 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 – 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). +Si cette variable est définie, elle sera utilisée pour décider l'activation de la prise en charge des langues (NLS – Native Language Support), connu aussi comme la gestion de l'internationalisation (ou i18n) (depuis dpkg 1.19.0). Les valeurs permises sont : B<0> et B<1> (par défaut). =back @@ -184,7 +198,7 @@ Si cette variable est définie, elle sera utilisée pour décider l'activation d =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 :> +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 rencontrer : =over @@ -196,7 +210,7 @@ Le symbole indiqué n'a pas été trouvé dans les bibliothèques liées au bina =item I<binary> B<contient une référence non résolue au symbole> 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. +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 « 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)> @@ -223,9 +237,9 @@ B<dpkg-shlibdeps> échouera s'il ne peut pas trouver de bibliothèque publique u =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> B<(son RPATH est «> 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. +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 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é. |