deb-symbols

NOM

deb-symbols - Fichier d'information sur les bibliothèques partagées étendues Debian

SYNOPSIS

DEBIAN/symbols

DESCRIPTION

Les fichiers de symboles sont fournis dans les paquets binaires de Debian et leur format est un sous-ensemble des fichiers modèles de symboles utilisés par dpkg-gensymbols(1) dans les paquets source Debian, voir deb-src-symbols(5). Le format pour une entrée d'information sur les dépendances étendues avec bibliothèques partagées dans ces fichiers est le suivant :
soname-de-bibliothèque modèle-principal-de-dépendance
[| modèle-alternatif-de-dépendance]
[...]
[* nom-du-champ: valeur-du-champ]
[...]
symbole version-minimale [id-du-modèle-de-dépendance] La variable soname-de-bibliothèque est exactement la valeur du champ SONAME telle qu'exportée par objdump(1). Un modèle-de-dépendance est une dépendance où #MINVER# est dynamiquement remplacé soit par une version comme « (>= version-minimale) » soit par rien (si une dépendance quelle que soit sa version est reconnue suffisante). Chaque symbole exporté (noté nom@version, avec version réglé à « Base » si la bibliothèque n'a pas de version) est associé à une version-minimale dans son modèle de dépendance (le modèle principal de dépendance est toujours utilisé et se termine combiné avec le modèle de dépendance référencé par l' id-du-modèle-de-dépendance si présent). La première alternative au modèle de dépendance est numérotée 1, la seconde 2, etc. Les colonnes sont séparées par exactement un seul espace. Chaque entrée pour une bibliothèque peut aussi avoir des champs de méta-information. Ces champs sont enregistrés dans des lignes qui débutent par un astérisque (« * »). Actuellement, le seul champ valable est :

Build-Depends-Package

Il indique le nom du paquet « -dev » associé à la bibliothèque et est utilisé par dpkg-shlibdeps pour s'assurer que la dépendance produite est au moins aussi stricte que la dépendance de construction correspondante (depuis dpkg 1.14.13).

Build-Depends-Packages

C'est identique à Build-Depends-Package, mais accepte une liste de noms de paquets séparés par des virgules (depuis dpkg 1.20.0). Ce champ remplacera tout champ Build-Depends-Package présent et est surtout utile avec les paquets « -dev » et les métapaquets qui en dépendent, pour une période de transition.

Allow-Internal-Symbol-Groups

Il indique que les groupes de symboles internes seront ignorés, sous forme de liste séparée par des espaces, afin que les symboles contenus dans ces groupes soient inclus dans le fichier de sortie (depuis dpkg 1.20.1). Cela sera seulement nécessaire pour les paquets de chaîne d'outils qui fournissent ces symboles internes. Les groupes disponibles dépendent des systèmes et, pour les systèmes basés sur ELF et GNU, ce sont aeabi et gomp.

Ignore-Blacklist-Groups

Un alias obsolète pour Allow-Internal-Symbol-Groups (depuis dpkg 1.20.1, gérés depuis dpkg 1.17.6).

EXEMPLES

Simple fichier de symboles

 libftp.so.3 libftp3 #MINVER#
  DefaultNetbuf@Base 3.1-1-6
  FtpAccess@Base 3.1-1-6
  [...]

Fichier avancé de symboles

 libGL.so.1 libgl1
 | libgl1-mesa-glx #MINVER#
 * Build-Depends-Package: libgl1-mesa-dev
  publicGlSymbol@Base 6.3-1
  [...]
  implementationSpecificSymbol@Base 6.5.2-7 1
  [...]

VOIR AUSSI

<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, deb-src-symbols(5), dpkg-shlibdeps(1), dpkg-gensymbols(1).

TRADUCTION

Ariel VARDI <[email protected]>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à <[email protected]>.