= Gentoo Cheat Sheet =

Some common operations you need to do to administer a gentoo machine

== Sync methods ==

{{{
#sync main gentoo repo
emerge --sync
#sync overlays managed with layman
layman -S
  }}}

== Managing packages ==

{{{
#install and allow to be managed by portage
emerge www-client/firefox
#install without adding to world file
emerge --oneshot www-client/firefox

#remove a package
emerge --deselect www-client/firefox
#actually clean up no longer installed packages
emerge --depclean

#update entire system
emerge --ask --verbose --update --changed-use --deep @world

#apply --autounmask changes
dispatch-conf
  }}}
  
== Troubleshooting ==

{{{
#check for missing libraries and rebuild them
revdep-rebuild -v

#check which packages depend on the given package
#ie what does firefox depend on?
equery d www-client/firefox
  }}}

== Use flags ==

Use flags are kept in /etc/portage/package.use/

== Overlays ==

{{{
#list all existing overlays
layman -L
#list installed overlays
layman -l

#add an overlay
layman -a OVERLAY
#remove an overlay
layman -d OVERLAY
  }}}

[[index]]