Utiliser plusieurs branches ensemble
Updated 7 Novembre 2026
Cette page s'applique à Portage 3.0.82 et Calculate Utilities 3.8.
Les programmes de l'arbre Portage se répartissent entre deux branches, la branche stable et la branche de test. La variable ACCEPT_KEYWORDS définit lesquelles le système considère comme acceptables, tandis que les fichiers de mots-clés et de masques décident du sort des paquets pris individuellement. Les bases de Portage sont décrites sur la page Introduction to Portage.
Utiliser une branche
Stable
La variable ACCEPT_KEYWORDS détermine quelle branche de logiciels le système utilise. Par défaut, Calculate Linux est configuré pour la branche stable : la variable prend la valeur de votre architecture - pour les systèmes 64 bits, il s'agit de amd64. Vous n'avez pas besoin de la définir explicitement dans la configuration.
La branche stable engendre moins souvent de l'instabilité et d'autres problèmes, c'est pourquoi il est conseillé aux utilisateurs prudents d'y rester, en n'ouvrant que ponctuellement les versions de test des paquets - la marche à suivre est décrite dans la section Utilisation conjointe de paquets stables et de paquets de test.
Testing
Осторожно: тестовая ветвь
Les logiciels utilisés depuis la branche de test peuvent entraîner des problèmes de stabilité, un traitement incorrect des paquets (par exemple des dépendances erronées ou manquantes), des révisions fréquentes des ebuilds - et donc des recompilations fréquentes - ainsi que des paquets qui se révèlent défaillants de manière inattendue. Les utilisateurs qui ne sont pas prêts à traiter eux-mêmes ce genre de problèmes devraient rester sur la branche stable, plus rigoureusement testée.
Si vous avez quand même besoin des logiciels les plus récents, le système est basculé sur la branche de test
/etc/portage/make.conf/custom
ACCEPT_KEYWORDS="~amd64"
Профиль не переключают
La branche ne se choisit pas avec eselect profile : dans la sortie de eselect profile list, à côté de dizaines de profils Gentoo "bruts", le profil marqué comme actif est celui de la distribution - [59] distros:CLD/amd64/20 (stable) *. Les paquets binaires du miroir et les modèles du fichier world dépendent de lui ; changer de profil endommagera la distribution. Configurer le système passe par les drapeaux USE, les mots-clés et les masques dans les fichiers de /etc/portage (plus de détails sur les drapeaux USE sur la page Variables USE).
Le serveur de paquets binaires de la distribution ne contient que des versions stables. Par exemple, nano est représenté dans l'arbre par trois versions (9.2, ~9.3, 9999), alors que l'index du serveur ne contient que nano-9.2. Donc, pour les paquets de la branche de test, attendez-vous à une compilation depuis le code source sur votre propre machine - pour la méthode d'installation binaire, voir la page Fonctionnalités Portage.
Après le passage de la branche stable à la branche de test, la mise à jour courante du système (cl-update) fera passer de nombreux paquets - souvent des centaines - aux versions actuelles en amont. C'est normal. Gardez à l'esprit : après un passage sur la branche de test, le retour vers la branche stable peut être difficile - sauf à restaurer une sauvegarde. Si vous trouvez un bogue dans un paquet, signalez-le aux mainteneurs - par exemple sur le forum Calculate - afin qu'il soit connu et corrigé dans les mises à jour.
Utilisation conjointe de paquets stables et de paquets de test
package.accept_keywords
Vous pouvez autoriser la branche de test pour des paquets individuels en gardant le reste du système stable. Pour cela, ajoutez la catégorie et le nom du paquet dans le fichier /etc/portage/package.accept_keywords ou dans un fichier du répertoire du même nom - dans Calculate ce répertoire existe déjà ; il suffit d'y créer un fichier portant n'importe quel nom.
Par exemple, pour rendre la branche de test disponible pour un seul paquet :
/etc/portage/package.accept_keywords/testing
<category>/<package> ~amd64
Remplacez [HTML_REMOVED]/[HTML_REMOVED] par la catégorie et le nom du paquet pour lequel vous ouvrez la branche de test. Le nom du fichier reflète sa finalité. Les catégories, noms et versions de paquets des exemples de cette section sont illustratifs : remplacez-les par ceux dont votre système a besoin.
Tester des versions individuelles
Si vous avez besoin d'une version précise de la branche de test, mais que les versions ultérieures ne doivent pas en être tirées, indiquez la version avec l'opérateur = dans package.accept_keywords. Les plages de versions se définissent avec les opérateurs <=, <, > ou >=.
La règle est sans ambiguïté : si des informations de version sont indiquées, l'opérateur doit être utilisé ; si aucune version n'est indiquée - l'opérateur ne doit pas être utilisé.
Par exemple, pour autoriser l'installation d'une seule version précise d'un paquet depuis la branche de test :
/etc/portage/package.accept_keywords/testing
=<category>/<package>-<version>
Remplacez [HTML_REMOVED]/[HTML_REMOVED]-[HTML_REMOVED] par la catégorie, le nom et le numéro de version dont vous avez besoin.
emerge подскажет строку сам
Les options emerge par défaut de Calculate incluent --autounmask : quand un paquet manque de mot-clé ou de masque, emerge affiche les lignes toutes prêtes après la liste des paquets et s'interrompt aussitôt. Copiez-les dans un fichier du répertoire approprié - ou utilisez --autounmask-write, et alors emerge écrira lui-même les entrées nécessaires, en tenant compte de la protection de la configuration. Pour plus d'informations, voir la page Fonctionnalités Portage.
Paquets masqués
package.unmask
Размаскировка — на вашей совести
Les développeurs ne masquent pas les paquets sans raison. Les questions causées par des paquets démasqués par vous-même ne sont généralement pas traitées par le support : ces signalements risquent d'être ignorés ou fermés avec le statut WONTFIX. Faites preuve de prudence.
Les masques sont définis dans les fichiers package.mask du répertoire des profils - par défaut /var/db/repos/gentoo/profiles/. Quand vous essayez d'installer un paquet masqué, emerge signale le masquage et, en règle générale, sa raison. Si vous êtes prêt à accepter le risque, ajoutez exactement la même ligne que celle du masque dans /etc/portage/package.unmask (dans le fichier, ou dans un fichier du répertoire du même nom, qui existe déjà dans Calculate) :
/etc/portage/package.unmask/manual
=<category>/<package>-<version>
Remplacez [HTML_REMOVED]/[HTML_REMOVED]-[HTML_REMOVED] par la ligne exacte du masque : vous la verrez dans le message d'emerge - démasquez avec une copie de cette ligne exacte, et non de mémoire. Le nom du fichier dans le répertoire est à votre discrétion. Les données de l'exemple sont illustratives.
Блокировка диапазоном
Si une entrée de package.mask couvre une plage de versions, ne démasquez que les versions dont vous avez réellement besoin - les opérateurs de version sont décrits dans la section Tester des versions individuelles.
package.mask
Enfin, vous pouvez empêcher Portage d'installer un paquet ou une version précise - c'est ce que signifie masquer. Pour masquer, ajoutez la ligne nécessaire avec les qualificatifs dans /etc/portage/package.mask (dans le fichier, ou dans un fichier du répertoire du même nom, qui existe par défaut) :
/etc/portage/package.mask/manual
><category>/<package>-<version>
Remplacez [HTML_REMOVED]/[HTML_REMOVED]-[HTML_REMOVED] par la catégorie, le nom et le numéro de version au-delà desquels les mises à jour sont indésirables ; le signe > devant le nom est un opérateur de comparaison de versions - c'est lui qui masque tout ce qui est plus récent que la version indiquée. Le nom du fichier dans le répertoire est à votre discrétion. Une telle ligne interdira d'installer toutes les versions du paquet plus récentes que celle indiquée - par exemple, c'est ainsi que l'on empêche les sources du noyau de se mettre à jour. Les données de l'exemple sont illustratives.