portage - Package manager for Gentoo

Author:Yap Sok Ann

Synopsis

New in version 1.6.

Manages Gentoo packages

Options

parameter	required	default	choices	comments
deep	no		yes	Consider the entire dependency tree of packages (--deep)
depclean	no		yes	Remove packages not needed by explicitly merged packages (--depclean)If no package is specified, clean up the world's dependenciesOtherwise, --depclean serves as a dependency aware version of --unmerge
newuse	no		yes	Include installed packages where USE flags have changed (--newuse)
nodeps	no		yes	Only merge packages but not their dependencies (--nodeps)
noreplace	no		yes	Do not re-emerge installed packages (--noreplace)
oneshot	no		yes	Do not add the packages to the world file (--oneshot)
onlydeps	no		yes	Only merge packages' dependencies but not the packages (--onlydeps)
package	no			Package atom or set, e.g. sys-apps/foo or >foo-2.13 or @world
quiet	no		yes	Run emerge in quiet mode (--quiet)
state	no	present	present installed emerged absent removed unmerged	State of the package atom
sync	no		yes web	Sync package repositories firstIf yes, perform "emerge --sync"If web, perform "emerge-webrsync"
update	no		yes	Update packages to the best version available (--update)
verbose	no		yes	Run emerge in verbose mode (--verbose)

Note

Requires gentoolkit

Examples

# Make sure package foo is installed
- portage: package=foo state=present

# Make sure package foo is not installed
- portage: package=foo state=absent

# Update package foo to the "best" version
- portage: package=foo update=yes

# Sync repositories and update world
- portage: package=@world update=yes deep=yes sync=yes

# Remove unneeded packages
- portage: depclean=yes

# Remove package foo if it is not explicitly needed
- portage: package=foo state=absent depclean=yes