Attachment #79688 for bug #122680

View | Details | Raw Unified | Return to bug 122680
Collapse All | Expand All




</author>

<abstract>
Ce document guidera les utilisateurs de Gentoo Linux pour mettre GCC à jour.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>8</version>
<date>2006-02-09</date>

<chapter id="intro">
<title>Introduction</title>

jour au moment où une nouvelle version supprime un bogue qui vous ennuie, une
nouvelle fonctionalité dont vous avez besoin a été ajoutée, ou si vous voulez
simplement garder votre système à jour. Si les cas précédents ne vous
correspondent pas, vous pouvez retarder votre mise a jour sans craintes tant que
votre version de GCC est supportée par les développeurs de Gentoo.
</p>


</p>

<p>
Ce guide va documenter les étapes nécessaires pour mettre à jour en douceur le
compilateur utilisé par votre machine Gentoo. Une section spécifique est dédiée
à <uri link="#upgrade-3.3-to-3.4">la mise à jour de GCC depuis la version 3.3 à
la 3.4 ou supérieure</uri>, et aux problèmes avec <c>libstdc++</c>. Une autre
section spécifique vise les utilisateurs qui <uri link="#first-install">
installent Gentoo</uri> à partir d'une image du stage3, après qu'une nouvelle
version majeure ou mineure de GCC ait été rendue publique.
</p>

<note>
Notez bien que la mise à jour de GCC 3.4 vers 4.0 ou plus ne nécessite pas de
gros changements à faire par l'utilisateur, puisque GCC 3.4 et 4.0 utilisent
la même ABI. Il suffit que <c>gcc-config</c> soit utilisé pour choisir le
compilateur désiré.
</note>

</body>
</section>
</chapter>

<chapter id="upgrade-general">
<title>Instructions générales pour la mise à jour</title>
<section>
<title>Introduction</title>
<body>

<impo>
Si vous recherchez des instructions spécifiques pour la mise à jour de GCC 3.3
vers GCC 3.4 ou supérieur, veuillez consulter la <uri 
link="#upgrade-3.3-to-3.4">section dédiée</uri>.
</impo>

<impo>
Si vous recherchez des instructions spécifiques pour les mises à jour de GCC
lors d'une nouvelle installation, veuillez consulter la <uri
link="#first-install">section dédiée</uri>.
</impo>

<p>
En général, les mises à jour servant à <e>corriger les bogues</e>, comme de GCC
3.3.5 à 3.3.6, devraient être sans risques -- il suffit d'installer la nouvelle
version, de modifier votre système afin d'utiliser le nouveau GCC et de
recompiler le seul paquet affecté, <c>libtool</c>. Cependant,
quelques mises à jour de GCC cassent la compatibilité binaire&nbsp;; dans ces
cas, une recompilation des paquets affectés (ou même de la chaîne de
compilation complète et du système) pourrait être requise.

Souvenez-vous, nous avons dit que la mise à jour de GCC ne serait pas
automatique.  Il y a tout de même une exception&nbsp;: les mises à jour servant
à supprimer des bogues, comme de la version 3.3.5 à la 3.3.6 si vous n'utilisez
pas le flag USE "multislot" autorisant les deux versions à coexister sur un
seul système.  Multislot est désactivé par défaut, car il n'a pas grand intérêt
pour les utilisateurs.
</p>

<pre caption="Mise à jour de GCC">
# <i>emerge -uav gcc</i>

<comment>(Veuillez remplacer "i686-pc-linux-gnu-3.4.4" par votre paramètre
CHOST et la version de GCC vers laquelle vous venez de mettre à jour)</comment>
# <i>gcc-config i686-pc-linux-gnu-3.4.4</i>
# <i>source /etc/profile</i>

<comment>(Recompilation de libtool)</comment>
# <i>emerge --oneshot -av libtool</i>
</pre>

<p>
On peut maintenant recompiler la chaîne de compilation, puis world, afin de
s'assurer que tous les paquets seront recompilés par le nouveau GCC.
</p>

<pre caption="Recompilation du système">
# <i>emerge -eav system</i>
# <i>emerge -eav world</i>
</pre>

désinstaller)&nbsp;:
</p>

<pre caption="Désinstallation des anciennes versions de GCC">
# <i>emerge -aC =sys-devel/gcc-3.3*</i>
</pre>


</chapter>

<chapter id="upgrade-3.3-to-3.4">
<title>Mise à jour de la version 3.3 à la version 3.4 ou supérieure</title>
<section>
<title>Introduction</title>
<body>

<p>
La mise à jour de GCC 3.3 à 3.4 ou supérieure n'est pas sans soucis, car l'ABI
C++ a changé entre les deux versions. Il faut également s'occuper d'un
problème qui va survenir avec la bibliothèque <c>libstdc++</c>.
</p>

</body>

</impo>

<p>
Vous avez le choix entre deux possibilités pour mettre votre système à jour. La
<uri link="#upgrade-3.3-to-3.4-revdep-rebuild">première méthode</uri> est la
plus rapide et requiert l'utilisation de l'outil <c>revdep-rebuild</c> du
paquet <c>gentoolkit</c> alors que la <uri link="#upgrade-3.3-to-3.4-emerge-e">
seconde</uri> recompile le système entier à partir de zéro. Le système utilisera
ainsi les nouvelles fonctionnalités de GCC. Le choix entre ces deux possibilités
vous appartient. Dans la plupart des cas, la première méthode est suffisante.
</p>

</body>

état.
</p>

<pre caption="Installation de gentoolkit et mise à jour de GCC">
# <i>emerge -an gentoolkit</i>
# <i>emerge -uav gcc</i>
# <i>gcc-config i686-pc-linux-gnu-3.4.4</i>
# <i>source /etc/profile</i>

<comment>(Recompilation de libtool)</comment>
# <i>emerge --oneshot -av libtool</i>
</pre>

<note>
Nous supposons dans cet exemple que vous utilisez la variable
<c>CHOST="i686-pc-linux-gnu"</c>. Si vous utilisez un autre CHOST, veuillez
adapter la ligne gcc-config en conséquence.
</note>

<p>

</pre>

<note>
Il est possible que vous rencontriez des problèmes avec des paquets dont la
version n'existe plus, car ils sont dépassés ou masqués au moment où vous
mettez à jour. Si c'est le cas, vous pouvez utiliser l'option
<c>--package-names</c> de <c>revdep-rebuild</c>. Elle permet de recompiler
les paquets en se basant sur leur nom, plutôt que leur désignation complète
composée du nom et de la version exacte.
</note>

<p>
Pour permettre la compatibilité avec les anciens binaires d'applications C++,
<c>sys-libs/libstdc++-v3</c> doit être installé sur votre système.
<c>sys-libs/libstdc++-v3</c> a besoin d'être installé avant de désinstaller GCC
3.3.
</p>

<pre caption="Installation de libstdc++-v3 et désinstallation de l'ancienne
version de GCC">
# <i>emerge --oneshot sys-libs/libstdc++-v3</i>
# <i>emerge -aC =sys-devel/gcc-3.3*</i>
</pre>

du compilateur à la nouvelle. 
</p>

<pre caption="Mise à jour de GCC">
# <i>emerge -uav gcc</i>
# <i>gcc-config i686-pc-linux-gnu-3.4.4</i>
# <i>source /etc/profile</i>

</pre>

<note>
Nous supposons dans cet exemple que vous utilisez la variable
<c>CHOST="i686-pc-linux-gnu"</c>. Si vous utilisez un autre CHOST, veuillez
adapter la ligne gcc-config en conséquence.
</note>

<p>
Pour permettre la compatibilité avec les anciens binaires d'applications
C++, <c>sys-libs/libstdc++-v3</c> doit être installé sur votre système.
</p>

<pre caption="Installation de libstdc++-v3">
# <i>emerge --oneshot sys-libs/libstdc++-v3</i>
</pre>


Cela va prendre du temps en fonction du nombre de paquets que vous avez
installés, car votre chaîne de compilation entière et ses fichiers système
seront recompilés, suivis de chaque paquet de votre système, incluant la chaîne
de compilation. Cela est nécessaire pour s'assurer que chaque paquet, y compris
ceux de la chaîne de compilation elle-même, auront été compilés avec la
nouvelle chaîne de compilation.
</p>

<pre caption="Recompilation de system et world">
# <i>emerge -e system</i>
# <i>emerge -e world</i>
</pre>

</section>
</chapter>

<chapter id="first-install">
<title>Mise à jour de GCC à l'installation du système</title>
<section>
<title>Introduction</title>
<body>

<p>
La mise à jour de GCC sur un système après l'installation d'une image de stage3
est assez simple. Un des avantage qu'ont les utilisateurs qui installent un
nouveau système est qu'ils n'ont pas beaucoup de logiciels installés qui ont
des liens avec les anciennes versions de GCC. L'exemple suivant sert pour la
mise à jour de GCC 3.3 à 3.4 ou supérieur. Certaines passages seront différents
si vous mettez à jour depuis d'autres version de GCC. Par exemple, les noms des
bibliothèques utilisées avec <c>revdep-rebuild</c> plus bas sont spécifiques à
GCC 3.3, ainsi que le besoin d'installer <c>libstdc++-v3</c>.
</p>

<p>
Si vous n'avez pas encore fait de modifications a votre système, il suffit de
quelques étapes pour le mettre à jour vers une nouvelle version de GCC. Comme
pour la mise à jour de GCC 3.3 vers 3.4, vous avez deux solutions. Cependant,
ce cas de figure est moins compliqué puisque il y a peu de différences entre
les deux solutions. La <uri link="#first-install-revdep-rebuild">première
méthode</uri> est plus rapide et utilise l'outil <c>revdep-rebuild</c> du paquet
<c>gentoolkit</c>, comme la procédure précedente. L'utilisation de
revdep-rebuild n'entraîne la recompilation que pour les paquets qui ont un
lien avec les librairies de GCC, tandis que <uri link="#first-install-emerge-e">
la seconde méthode</uri> entraîne la recompilation de tout le système et
prend donc beaucoup plus de temps. Cette seconde méthode n'est jamais utile
et est seleument documentée à des fins d'exhaustivité.
</p>

<p>
Les premières étapes sont communes aux deux méthodes, et doivent être accomplies
dans tous les cas.
</p>

<pre caption="Mise à jour de GCC">
# <i>emerge -uav gcc</i>
# <i>gcc-config i686-pc-linux-gnu-3.4.4</i>
# <i>source /etc/profile</i>

<comment>(Recompilation de libtool)</comment>
# <i>emerge --oneshot -av libtool</i>
</pre>

<note>
Nous supposons dans cet exemple que vous utilisez la variable
<c>CHOST="i686-pc-linux-gnu"</c>. Si vous utilisez un autre CHOST, veuillez
adapter la ligne gcc-config en conséquence.
</note>

<p>
Pour permettre la compatibilité avec les anciens binaires d'applications C++,
<c>sys-libs/libstdc++-v3</c> doit être installé sur votre système.
</p>

<pre caption="Installation de libstdc++-v3">
# <i>emerge --oneshot sys-libs/libstdc++-v3</i>
</pre>

</body>
</section>

<section id="first-install-revdep-rebuild">
<title>Utilisation de revdep-rebuild</title>
<body>

<p>
Cette méthode nécessite que vous installiez d'abord <c>gentoolkit</c> si vous
ne l'avez pas déjà fait. Nous utiliserons <c>revdep-rebuild</c> pour rechercher
les paquets installés que nous devrons recompiler, et les recompiler.
</p>

<pre caption="Installation de gentoolkit et utilisation de revdep-rebuild">
# <i>emerge -an gentoolkit</i>
# <i>revdep-rebuild --library libstdc++.so.5 -- -p -v</i>
# <i>revdep-rebuild --library libstdc++.so.5</i>
</pre>

<note>
Il est possible que vous rencontriez des problèmes avec des paquets dont la
version n'existe plus, car ils sont dépassés ou masqués au moment où vous
mettez à jour. Si c'est le cas, vous pouvez utiliser l'option
<c>--package-names</c> de <c>revdep-rebuild</c>. Elle permet de recompiler les
paquets en se basant sur leur nom, plutôt que leur désignation complète composée
du nom et de la version exacte.
</note>

</body>
</section>
<section id="first-install-emerge-e">
<title>Utilisation de emerge -e</title>
<body>

<p>
Cette méthode, bien que plus lente, va recompiler tout le système pour s'assurer
que tout a bien été compilé avec votre nouveau compilateur. Ce n'est pas
nécessaire, mais c'est une solution valide si vous avez modifié les CFLAGS ou
d'autres variables de make.conf qui ont un effet sur la compilation.
</p>

<pre caption="Mise à jour de GCC">
# <i>emerge -uav gcc</i>
# <i>gcc-config i686-pc-linux-gnu-3.4.4</i>
# <i>source /etc/profile</i>

<comment>(Recompilation de libtool)</comment>
# <i>emerge --oneshot -av libtool</i>
</pre>

<note>
Nous supposons dans cet exemple que vous utilisez la variable
<c>CHOST="i686-pc-linux-gnu"</c>. Si vous utilisez un autre CHOST, veuillez
adapter la ligne gcc-config en conséquence.
</note>

<p>
Pour permettre la compatibilité avec les anciens binaires d'applications C++,
<c>sys-libs/libstdc++-v3</c> doit être installé sur votre système.
</p>

<pre caption="Installation de libstdc++-v3">
# <i>emerge --oneshot sys-libs/libstdc++-v3</i>
</pre>

<p>
Puisque nous accomplissons la mise à jour après une installation initiale, il
est inutile de recompiler la cible world comme on devrait le faire pour une
mise à jour d'un système déjà installé. Cependant, vous pouvez choisir de faire
une mise à jour de world au lieu de seulement system, pour être certain que
tous les paquets soient mis à jour.
</p>

<pre caption="Recompilation de system">
# <i>emerge -e system</i>
</pre>

<p>
Il est également possible de désinstaller les anciennes versions de GCC sans
risques à ce stade. Veuillez remplacer <c>VOTRE-NOUVELLE-VERSION-DE-GCC</c>
avec la version vers laquelle vous avez mis à jour:
</p>

<pre caption="Désinstallation des anciennes versions de GCC">
# <i>emerge -aC "&lt;sys-devel/gcc-VOTRE-NOUVELLE-VERSION-DE-GCC"</i>
</pre>

</body>
</section>
</chapter>

<chapter id="common-pitfalls">
<title>Pièges connus</title>
<section>

<p>
Il est important de désactiver <c>distcc</c> durant la mise à jour. Mélanger
les versions de compilateurs sur vos nœuds <e>provoquera</e> des problèmes au
niveau de la compilation.  Vous pouvez garder ccache activé étant donné que les
objets en cache seront invalidés automatiquement.
</p>

<p>
Utilisez toujours la même version de GCC pour votre noyau et les modules
additionnels du noyau.  Une fois votre "world" recompilé avec votre nouveau GCC,
les modules externes (comme <c>app-emulation/qemu-softmmu</c>) échoueront lors
de leur chargement. Il suffit de recompiler votre noyau pour résoudre ce
problème.
</p>

<p>
Si vous mettez à jour une machine SPARC, n'oubliez pas de relancer <c>silo -f
</c> après avoir recompilé world afin d'éviter d'eventuels problèmes.
</p>

</body>
</section>
<section>

/etc/env.d/gcc/i686-pc-linux-gnu-3.3.5: No such file or directory</e>, essayez
alors de supprimer <path>/etc/env.d/gcc/config-i686-pc-linux-gnu</path> et
lancez de nouveau <c>gcc-config</c>, suivi de <c>source /etc/profile</c>.  Ne
faites pas cela si vous utilisez la compilation croisée.
</p>

<p>
Si un paquet échoue durant <c>emerge -e system</c> ou <c>emerge -e world</c>,
vous pouvez relancer l'opération avec la commande <c>emerge --resume</c>. Si un
paquet continue d'échouer, passez au paquet suivant avec la commande <c>emerge
--resume --skipfirst</c>. Ne lancez aucun autre emerge entre temps, car cela
effacerait les informations qui permettent la relance.
</p>

<p>

<c>GCC_SPECS</c> et relancez la mise à jour de GCC&nbsp;:
</p>

<pre caption="Restauration de la configuration d'origine">
# <i>gcc-config 1</i>
# <i>source /etc/profile</i>
# <i>unset GCC_SPECS</i>

Return to bug 122680