Gentoo Logo

Common portage problems


1.  Overview


This document deals only with major problems preventing normal operation that have affected a significant number of users in the past (or problem we expect to affect a significant number of users). If you have a problem and don't find it listed here please check if the problem is listed at bugzilla (please also search for closed/resolved bugs), and if not please file a bugreport there, even if you found a solution or workaround somewhere else.

Portage upgrades

Often the solution to a portage related problem is to simply update portage first. We recommended to do that regulary (every three or four months), as over time the portage tree will make use of features introduced by new portage releases, and that will often break old versions. We generally make sure that the tree is compatible with portage versions released in the past six months, so if you don't have version released in that timeframe it is possible that you won't be able to use the tree anymore.

The recommended way to upgrade portage is a simple emerge portage without any options, especially without the --update option as it causes some unwanted behavior for single package updates.

2.  Common problems

Receiving "!!! Cannot resolve a virtual package name to an ebuild." while updating portage cache

  • Bugreport: 114798
  • Caused by: old portage version
  • Solution: update portage and run emerge --sync again

Attempts to install any and all packages result in "!!! No package digest file found:" errors

    KeyError: 'app-dicts'
while updating portage cache

  • Bugreport: 100444
  • Caused by: old portage version
  • Solution: update portage and run emerge --sync again

Any emerge operation results in "!!! 'str' object has no attribute 'insert'"

  • Bugreport: 63400
  • Caused by: ancient portage version in combination with cascaded profiles
  • Solution: a) manually update portage or b) use a flat profile according to bug 63400, update portage and update to a current (cascaded) profile

After emerge --sync, emerge "Calculating dependencies" takes an extremely long time. Similarly, after cvs update, "RepoMan scours the neighborhood" takes an extremely long time.

  • Bugreport: 124041
  • Caused by: invalid metadata cache in /var/cache/edb/dep
  • Solution: run emerge --regen


Page updated 19 Feb 2006

Summary: This document attempts to collect all information regarding common major problems caused by inconsistencies between the portage version and the tree.

Marius Mauch

Donate to support our development efforts.

Copyright 2001-2014 Gentoo Foundation, Inc. Questions, Comments? Contact us.