summaryrefslogtreecommitdiffstats
path: root/man/fr/deb-symbols.pod
blob: 02e9eac1d39734013ad5a9ef46bc8868b8c728d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
        *****************************************************
        *           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

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

=head1 SYNOPSIS

B<DEBIAN/symbols>

=head1 DESCRIPTION

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

Z<>
 I<soname-de-bibliothèque> I<modèle-principal-de-dépendance>
 [| I<modèle-alternatif-de-dépendance>]
 [...]
 [* I<nom-du-champ>: I<valeur-du-champ>]
 [...]
  I<symbole> I<version-minimale> [I<id-du-modèle-de-dépendance>]

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

Chaque I<symbole> exporté (noté I<nom>@I<version>, avec I<version> réglé à « Base » si la bibliothèque n'a pas de version) est associé à une I<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'I<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 :

=over 

=item B<Build-Depends-Package>

Il indique le nom du paquet « -dev » associé à la bibliothèque et est utilisé par B<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).

=item B<Build-Depends-Packages>

C'est identique à B<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 B<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.

=item B<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 B<aeabi> et B<gomp>.

=item B<Ignore-Blacklist-Groups>

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

=back

=head1 EXEMPLES

=head2 Simple fichier de symboles

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

=head2 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
  [...]

=head1 VOIR AUSSI

L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, L<deb-src-symbols(5)>, L<dpkg-shlibdeps(1)>, L<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>.