selected-packages set (Portage)

Portage - the heart of Gentoo
emerge — configuration — ebuild repository — dispatch-conf

world file — USE flags — ebuilds — profiles
upgrades — using testing packages — binary packages
tools — gentoolkit — eselect
Portage FAQ — cheat sheet — FAQ
all articles

Not to be confused with World set (Portage).

The selected-packages set contains the user-selected "world" packages that are listed in the /var/lib/portage/world file. The selected-packages set is colloquially referred to as the world file.

See also
See package sets for a list of other sets available in Gentoo

Managing the selected-packages set

Listing the selected-packages set

eix can be used to list the selected-packages set:

user $eix -c --selected-file

Emerge a package without adding it to the world file

In order to avoid problems in dependency resolution when updating the system, the /var/lib/portage/world file should contain as few dependencies as possible. So use the --oneshot (-1) option for emerging dependencies.

root #emerge --ask --oneshot <category/atom>

Checking the world file

The emaint command can be used to see if any problems exist in the world file:

user $/usr/sbin/emaint --check world

Emaint: check world        100% [============================================>]

Adding an atom without recompilation

To add a package to the selected-packages set without recompiling the package:

root #emerge --ask --noreplace <category/atom>

It will add the atom to the /var/lib/portage/world file without compiling it again.

Tips

Editing world file by hand

Though the emerge man page says that the world file can "safely" be edited by hand, Portage will aggressively rewrite that file. Comments or changes in order of packages will be lost and there will be no checking for typos.

The --deselect (-W) or --noreplace (-n) options to the emerge command may be used to add or remove packages from the world file, without actually performing package installation or removal.

See also

• Package sets — describes package sets in high detail and includes a list of all typically available sets on a Gentoo system.
• /etc/portage/sets — an optional directory that is used to create user defined package sets
• User:Sam/Portage help/Maintaining a Gentoo system#World file hygiene
• User:Vaukai/checkworldfile (alternative version)

External resources

• https://forums.gentoo.org/viewtopic-t-1075276.html - Cleaning the world file (wiki) - check the script.