Manpages

NOM

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

SYNOPSIS

symboles

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.

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 est présent). La première alternative au modèle de dépendance est numérotée 1, la seconde 2, etc.

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).

Ignore-Blacklist-Groups

Il indique que les groupes blacklistés 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.17.6). Cela sera seulement nécessaire pour les paquets de chaîne d’outils qui fournissent ces symboles blacklistés. Les groupes disponibles dépendent des systèmes et, pour les systèmes basés sur ELF et GNU, ce sont aeabi et gomp.

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
dpkg-shlibdeps(1), dpkg-gensymbols(1).