deb-symbols(5)

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

SYNOPSIS
DEBIAN/symbols

DESCRIPTION
The symbol files are shipped in Debian binary packages, and its format is a subset of the template symbol files used by dpkg-gensymbols(1) in Debian source packages, see 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]

The library-soname is exactly the value of the SONAME field as exported by objdump(1). A dependency-template is a dependency where #MINVER# is dynamically replaced either by a version check like “(>= minimal-version)” or by nothing (if an unversioned dependency is deemed sufficient).

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 <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.