This handbook has been replaced by a newer version and is not maintained anymore.
[ << ]
[ < ]
[ Home ]
[ > ]
[ >> ]
5. Diverting from the Official Tree
5.a. Using a Portage Tree Subset
You can selectively update certain categories/packages and ignore the other
categories/packages. We achieve this by having rsync exclude
categories/packages during the emerge --sync step.
You need to define the name of the file that contains the exclude patterns in
the PORTAGE_RSYNC_EXTRA_OPTS variable in your /etc/portage/make.conf.
Code Listing 1.1: Defining the exclude file in /etc/portage/make.conf
Code Listing 1.2: Excluding all games in /etc/portage/rsync_excludes
Note however that this may lead to dependency issues since new, allowed packages
might depend on new but excluded packages.
5.b. Adding Unofficial Ebuilds
Defining a Portage Overlay Directory
You can ask Portage to use ebuilds that are not officially available through the
Portage tree. Create a new directory (for instance
/usr/local/portage) in which you store the 3rd-party ebuilds. Use
the same directory structure as the official Portage tree!
Then define PORTDIR_OVERLAY in /etc/portage/make.conf and have it
point to the previously defined directory. When you use Portage now, it will
take those ebuilds into account as well without removing/overwriting those
ebuilds the next time you run emerge --sync.
Working with Several Overlays
For the powerusers who develop on several overlays, test packages before they
hit the Portage tree or just want to use unofficial ebuilds from various
sources, the app-portage/layman package brings you
layman, a tool to help you keep the overlay repositories up to date.
First install and configure layman as shown in the Overlays Users' Guide, and add your
desired repositories with layman -a <overlay-name>.
Suppose you have two repositories called java (for the in-development
java ebuilds) and entapps (for the applications developed in-house for
your enterprise). You can update those repositories with the following
Code Listing 2.1: Using layman to update all repositories
# layman -S
For more information on working with overlays, please read man layman and
the layman/overlay users'
5.c. Non-Portage Maintained Software
Using Portage with Self-Maintained Software
In some cases you want to configure, install and maintain software yourself
without having Portage automate the process for you, even though Portage
can provide the software titles. Known cases are kernel sources and nvidia
drivers. You can configure Portage so it knows that a certain package is
manually installed on your system. This process is called injecting and
supported by Portage through the
For instance, if you want to inform Portage about
gentoo-sources-22.214.171.124 which you've installed manually, add the
following line to /etc/portage/profile/package.provided:
Code Listing 3.1: Example line for package.provided
[ << ]
[ < ]
[ Home ]
[ > ]
[ >> ]
The contents of this document, unless otherwise expressly stated, are licensed under the CC-BY-SA-2.5 license. The Gentoo Name and Logo Usage Guidelines apply.