OldGentooWiki:Overlay

Un overlay est une branche locale de l'arbre de Portage de Gentoo. Lorsqu'un utilisateur veut modifier ce qui se trouve dans Portage (ajouter un nouveau paquet, ajouter une nouvelle version d'un paquet, appliquer un correctif, etc), il doit nécessairement passer par un overlay car la modification directe des fichiers de l'arbre de Portage peut causer des problèmes. Les overlays sont aussi utilisés pour ajouter des branches gérées par des développeurs de Gentoo qui ne sont pas encore dans l'arbre principal de Gentoo. En voici la liste.

Le moyen le plus simple d'ajouter un overlay officiel est d'utiliser le paquet layman.

Installation de Layman

Use flags

Pour utiliser des overlays gérés avec git ou subversion, Layman offre les use flags "git" et "subversion". Activez ceux dont vous avez besoin.

Installation

# emerge -av layman

Gestion des overlays

Ajout des overlays gérés par Layman à l'arbre de Portage:

# echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf

Affichage des overlays gérés par Layman:

# layman -L

Ajout d'un overlay:

# layman -a <nom-overlay>

Suppression d'un overlay:

# layman -d <nom-overlay>

Pour gérer son propre overlay (par exemple pour ajouter de nouveaux ebuilds ou appliquer des correctifs), voici la marche à suivre:

# mkdir /usr/local/portage
# mkdir /usr/local/portage/<nom-overlay>
# echo "PORTDIR_OVERLAY="/usr/local/portage/<nom-overlay>" >> /etc/make.conf

Il ne reste ensuite qu'à créer dans le dossier de l'overlay la même hiérarchie que dans l'arbre de Portage (c'est à dire <catégorie>/<paquet>/<fichiers_du_paquet>) et le tour est joué!

Un avantage important c'est que nous ne sommes pas obligés d'utiliser Layman lorsque nous voulons utiliser seulement un Overlay local.

Par exemple, le package iwl1000-ucode n'existe pas dans Portage, donc pas de problème car un bugzilla existe pour ce package en particulier.

http://bugs.gentoo.org/296352