User Tools

Site Tools




Common tasks

# list and read eselect news
eselect news list
eselect news read <item>
# list and set gentoo profiles
eselect profile list
eselect profile set <profile-num>
# Example location for a profile: /usr/portage/profiles/targets/desktop/gnome/
# list runlevels-config
rc-config list
# add daemon/service to runlevel (e.g. default)
rc-update add sshd default
# emerge *temporarily* with other use-flags
USE="-X" emerge -va vim
# enable bash-completion for e.g. vim (globally)
eselect bashcomp enable --global vim
# emerge package without adding to world
emerge -1 <atom>      # -1 is alias for --oneshot
# add already installed package to world-file without re-emerging it
emerge --noreplace <atom>
# remove package from world-file without unmerging it
emerge --deselect <atom>
# clean distfiles (instead of doing "rm /usr/portage/distfiles/*")
eclean distfiles


emerge --update --deep --with-bdeps=y --newuse world


emerge -va app-portage/eix

Update index


Simple search

eix holdingnuts


emerge -va app-portage/gentoolkit   # -> equery



Show reverse dependencies of package:

qdepends -Q misc-foo/bar

Alternatively use --tree on emerge.


# world file
# package specific use flags

Note: Changes

  • /etc/portage/package.accept_keywords replaces /etc/portage/package.keywords
  • dispatch-conf is preferred over etc-update


  • on gcc-upgrade # (not needed anymore!)
  • gcc-config <version> changes the current cc/gcc profile
  • eselect python set <slot> plus python-updater on python major upgrade
  • revdep-rebuild finds broken dependencies and reemerges the packages which rely on them
  • lafilefixer --justfixit fixes .la libtool archives to list libraries
  • portage:
    • emaint --check world and emaint --fix world
    • less /var/log/portage/elog for reading emerge.log (or use GUI-tool app-portage/elogviewer [untested])
    • eix-test-obsolete tests for redundancy and errors in /etc/portage
  • module-rebuild, module-rebuild populate and module-rebuild rebuild (emerge -av sys-kernel/module-rebuild)
gentoo.txt · Last modified: 2014-06-08 11:48 CEST by dominik