path: root/man/fr/dpkg-gensymbols.pod

        *****************************************************
        *           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

dpkg-gensymbols - Création des fichiers de symboles (information de
dépendances de bibliothèques partagées)

=head1 SYNOPSIS

B<dpkg-gensymbols> [I<option>...]

=head1 DESCRIPTION

B<dpkg-gensymbols> analyse un répertoire temporaire de construction (par
défaut debian/tmp), y recherche les bibliothèques et crée un fichier
I<symbols> qui les décrit. Si ce fichier n'est pas vide, il est installé
dans le sous-répertoire DEBIAN du répertoire de construction afin de pouvoir
être inclus dans les informations de contrôle du paquet.

Lors de la création de ces fichiers, il utilise en entrée certains fichiers
de symboles fournis par le responsable. Il recherche les fichiers suivants
(en utilisant le premier S<trouvé) :>

=over 

=item *

debian/I<paquet>.symbols.I<arch>

=item *

debian/symbols.I<arch>

=item *

debian/I<paquet>.symbols

=item *

debian/symbols

=back

L'intérêt principal de ces fichiers est de fournir la version minimale
associée à chaque symbole fourni par les bibliothèques. En général, cela
correspond à la première version du paquet qui a fourni ce symbole, mais
cette valeur peut être augmentée manuellement par le responsable si
l'interface binaire applicative (ABI) du symbole est étendue sans casser la
compatibilité avec les versions précédentes. La tenue à jour de ces fichiers
est à la charge du responsable du paquet, avec l'aide de
B<dpkg-gensymbols>. 

Quand les fichiers de symboles créés sont différents de ceux fournis par le
responsable, B<dpkg-gensymbols> affichera les différences entre les deux
versions. Si ces différences sont trop importantes, le programme peut même
se terminer en échec (le nombre de différences tolérées peut être réglé avec
l'option B<-c>).

=head1 TENUE À JOUR DES FICHIERS SYMBOLES

The base interchange format of the symbols file is described in
B<deb-symbols>(5), which is used by the symbols files included in binary
packages. These are generated from template symbols files with a format
based on the former, described in B<deb-src-symbols>(5)  and included in
source packages.

The symbols files are really useful only if they reflect the evolution of
the package through several releases. Thus the maintainer has to update them
every time that a new symbol is added so that its associated minimal version
matches reality.

The diffs contained in the build logs can be used as a starting point, but
the maintainer, additionally, has to make sure that the behaviour of those
symbols has not changed in a way that would make anything using those
symbols and linking against the new version, stop working with the old
version.

In most cases, the diff applies directly to the debian/I<package>.symbols
file. That said, further tweaks are usually needed: it's recommended for
example to drop the Debian revision from the minimal version so that
backports with a lower version number but the same upstream version still
satisfy the generated dependencies.  If the Debian revision can't be dropped
because the symbol really got added by the Debian specific change, then one
should suffix the version with ‘B<~>’.

Avant d'appliquer le correctif au fichier de symboles, le responsable doit
contrôler qu'il est correct. Les symboles publics sont supposés ne jamais
disparaître et le correctif ne devrait donc qu'ajouter des lignes.

Note that you can put comments in symbols files.

N'oubliez pas de vérifier si les anciennes versions des symboles ne doivent
pas être incrémentées. Il n'y a pas de moyen pour que B<dpkg-gensymbols>
prévienne de cela. Appliquer aveuglement le fichier de différences ou
supposer qu'il n'y a rien à changer, s'il n'y a pas de fichier de
différences, sans vérifier s'il y a ces modifications, peut faire que des
paquets, avec des dépendances lâches, prétendent qu'ils peuvent fonctionner
avec des paquets plus anciens avec lesquels ils ne peuvent fonctionner. Cela
introduira des bogues difficiles à trouver avec des mises à niveau
(partielles).

=head2 Bonnes pratiques de gestion des bibliothèques

Une bibliothèque bien maintenue offre les possibilités S<suivantes :>

=over 

=item *

son interface de programmation (API) est stable (les symboles publics ne
sont jamais supprimés et les changements ne concernent que des ajouts de
nouveaux symboles publics) et les modifications provoquant une
incompatibilité doivent être combinées avec un changement de S<SONAME ;>

=item *

idéalement, elle utilise le versionnage des symboles pour garantir la
stabilité de l'interface applicative binaire (ABI) malgré ses modifications
internes et l'extension de son S<API ;>

=item *

elle n'exporte pas les symboles privés (afin de contourner cela, de tels
symboles peuvent être étiquetés comme optionnels).

=back

En maintenant le fichier de symboles, il est facile d'en voir apparaître et
disparaître. Cependant, il est plus difficile de contrôler la présence
d'éventuelles modifications d'API ou ABI. En conséquence, le responsable
doit contrôler soigneusement le journal des modifications amont, à la
recherche de cas où une saine gestion des bibliothèques peut avoir été
omise. Si des problèmes potentiels sont découverts, l'auteur amont doit être
averti(e) car une correction en amont est meilleure qu'un travail spécifique
au paquet Debian.

=head1 OPTIONS

=over 

=item B<-P>I<répertoire-construction-paquet>

Analyse de I<répertoire-construction-paquet>, plutôt que debian/tmp.

=item B<-p>I<paquet>

Définit le nom du paquet. Requis si plus d'un paquet binaire est indiqué
dans debian/control (ou s'il n'y a pas de fichier debian/control).

=item B<-v>I<version>

Définit la version du paquet. La valeur par défaut est la version extraite
de debian/changelog. Ce paramètre est requis si le programme est lancé en
dehors de l'arborescence source d'un paquet.

=item B<-e>I<fichier-bibliothèque>

N'analyse que les bibliothèques explicitement mentionnées au lieu de
rechercher toutes les bibliothèques publiques. Les motifs du shell peuvent
être utilisés pour l'expansion des chemins d'accès (voir la page de manuel
de B<File::Glob>(3perl) pour plus d'informations) dans
I<fichier-bibliothèque> pour établir une correspondance avec plusieurs
bibliothèques avec un seul paramètre (afin d'éviter d'utiliser plusieurs
options B<-e>).

=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.19.1).> 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<-I>I<nom-de-fichier>

Utilise I<nom-de-fichier> comme fichier de référence pour créer le fichier
de symboles à intégrer dans le paquet lui-même.

=item B<-O>[I<nom-de-fichier>]

Affiche le fichier de symboles créé sur la sortie standard ou dans le
I<nom-de-fichier>, si spécifié, plutôt que dans B<debian/tmp/DEBIAN/symbols>
(ou I<répertoire-construction-paquet>B</DEBIAN/symbols> si B<-P> est
présent). Si I<nom-de-fichier> existe déjà, son contenu sera utilisé comme
base pour le fichier créé. Cette fonctionnalité permet de mettre à jour le
fichier de symboles pour qu'il corresponde à une nouvelle version amont de
la bibliothèque.

=item B<-t>

Écrit le fichier de symboles en mode modèle plutôt que dans un format
compatible avec B<deb-symbols>(5). La différence majeure réside dans le fait
que les noms de symboles et les étiquettes sont écrits dans leur forme
d'origine au lieu d'être interprétés, avec réduction des étiquettes en mode
de compatibilité. De plus, certains symboles peuvent être omis lors de
l'écriture d'un fichier B<deb-symbols>(5) standard (selon les règles de
traitement des étiquettes) alors que tous les symboles sont écrits lors de
la création d'un modèle de fichier de symboles.

=item B<-c>I<[0-4]>

Définit les contrôles à effectuer lors de la comparaison du fichier de
symboles créé en utilisant le fichier de modèle comme point de départ. Le
niveau par défaut S<est 1.> Plus le niveau est augmenté, plus le nombre de
contrôles effectués est important. Chaque niveau de contrôle comporte les
contrôles effectués pour les niveaux inférieurs. Le S<niveau 0> n'échoue
jamais. Le S<niveau 1> échoue si certains symboles ont disparu. Le S<niveau 2>
échoue si de nouveaux symboles ont été ajoutés. Le S<niveau 3> échoue si
certaines bibliothèques ont disparu. Le S<niveau 4> échoue si des bibliothèques
ont été ajoutées.

Cette valeur peut être remplacée par la valeur de la variable
d'environnement B<DPKG_GENSYMBOLS_CHECK_LEVEL>.

=item B<-q>

Fonctionne en mode silencieux et ne crée jamais de fichier de différences
entre le fichier de symboles créé et le fichier modèle utilisé comme point
de départ. N'affiche également aucun avertissement à propos de bibliothèques
nouvelles ou disparues ou de symboles nouveaux ou disparus. Cette option ne
désactive que l'affichage informatif, mais pas les contrôles eux-mêmes (voir
l'option B<-c>).

=item B<-a>I<arch>

Définit I<arch> comme architecture lors du traitement des fichiers de
symboles. Cette option permet de créer un fichier de symboles ou un fichier
de différences pour n'importe quelle architecture, à condition que les
fichiers binaires correspondants soient déjà disponibles.

=item B<-d>

Active le mode bavard. De nombreux messages sont affichés pour expliquer ce
que B<dpkg-gensymbols> fait.

=item B<-V>

Active le mode bavard. Le fichier de symboles créé contiendra les symboles
dépréciés sous forme de commentaires. De plus, en mode modèle, les motifs de
symboles seront suivis de commentaires affichant les symboles réels qui
correspondent au motif.

=item B<-?>, B<--help>

Affiche un message d'aide puis quitte.

=item B<--version>

Affiche le numéro de version puis quitte.

=back

=head1 ENVIRONNEMENT

=over 

=item B<DPKG_GENSYMBOLS_CHECK_LEVEL>

Remplace le niveau de vérification de commande, même si l'argument en ligne
de commande B<-c> a été donné (notez que cela va à l'encontre de la
convention générale qui veut que les arguments en ligne de commande ont la
préséance sur les variables d'environnement).

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

=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 S<– 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).

=back

=head1 VOIR AUSSI

L<https://people.redhat.com/drepper/symbol-versioning>,
L<https://people.redhat.com/drepper/goodpractice.pdf>,
L<https://people.redhat.com/drepper/dsohowto.pdf>, B<deb-src-symbol>(5),
B<deb-symbols>(5), B<dpkg-shlibdeps>(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>.