User:Feng/World file (Portage)

The world set, also referred to as @world in Portage development, encompasses the system set and the selected set.

Packages belonging to the world set are listed by default into the /var/lib/portage/world file.

It is the world file, together with the profile and /etc/portage (including make.conf) settings, that defines what software is installed on a system.

Later, when a world update is requested (through emerge -uDN @world or similar command), Portage will use the world file as the base for its update calculations.

Checking

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% [============================================>]

Keep it clean

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.

Warning
The application qdepends has several known bugs. In particular, see the bug #390749.

Dependencies already listed in this file can be found using the qdepends -Q command and be collected in a file say /tmp/deselect:

Important
The following script may have several issues so check the data carefully.

CODE checkworldfile

'"`UNIQ--pre-00000002-QINU`"'

Entries collected in /tmp/deselect can be cross-checked using the --depclean option:

user $emerge -pv --depclean $(< /tmp/deselect)

The emerge --deselect option will remove these entries without unmerging them.

root #emerge --ask --deselect $(< /tmp/deselect)

In case emerge --depclean -p indicates some needed or wanted package would be unmerged, those can be re-added using the --noreplace option:

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

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

See also

• Knowledge Base: Remove orphaned packages - The process of finding orphaned dependencies explained.
• The system set package set.
• /etc/portage/sets
• The selected set package set.

External resources

• https://forums.gentoo.org/viewtopic-t-1042252-start-11.html Forum thread