New in version 1.6.
Parameter |
Choices/Defaults |
Comments |
|---|---|---|
|
changed_use
(added in 1.8) |
|
Include installed packages where USE flags have changed, except when
flags that the user has not enabled are added or removed
(--changed-use)
|
|
deep
|
|
Consider the entire dependency tree of packages (--deep)
|
|
depclean
|
|
Remove packages not needed by explicitly merged packages (--depclean)
If no package is specified, clean up the world's dependencies
Otherwise, --depclean serves as a dependency aware version of --unmerge
|
|
getbinpkg
|
|
Prefer packages specified at PORTAGE_BINHOST in make.conf
|
|
jobs
(added in 2.3) |
|
Specifies the number of packages to build simultaneously.
Since version 2.6: Value of 0 or False resets any previously added
--jobs setting values
|
|
keepgoing
(added in 2.3) |
|
Continue as much as possible after an error.
|
|
loadavg
(added in 2.3) |
|
Specifies that no new builds should be started if there are
other builds running and the load average is at least LOAD
Since version 2.6: Value of 0 or False resets any previously added
--load-average setting values
|
|
newuse
|
|
Include installed packages where USE flags have changed (--newuse)
|
|
nodeps
|
|
Only merge packages but not their dependencies (--nodeps)
|
|
noreplace
|
|
Do not re-emerge installed packages (--noreplace)
|
|
oneshot
|
|
Do not add the packages to the world file (--oneshot)
|
|
onlydeps
|
|
Only merge packages' dependencies but not the packages (--onlydeps)
|
|
package
|
|
Package atom or set, e.g.
sys-apps/foo or >foo-2.13 or @world |
|
quiet
|
|
Run emerge in quiet mode (--quiet)
|
|
quietbuild
(added in 2.6) |
|
Redirect all build output to logs alone, and do not display it
on stdout (--quiet-build)
|
|
quietfail
(added in 2.6) |
|
Suppresses display of the build log on stdout (--quiet-fail)
Only the die message and the path of the build log will be
displayed on stdout.
|
|
state
|
|
State of the package atom
|
|
sync
|
|
Sync package repositories first
If yes, perform "emerge --sync"
If web, perform "emerge-webrsync"
|
|
update
|
|
Update packages to the best version available (--update)
|
|
usepkgonly
|
|
Merge only binaries (no compiling). This sets getbinpkg=yes.
|
|
verbose
|
|
Run emerge in verbose mode (--verbose)
|
# 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 "latest" version ( os specific alternative to latest )
- portage:
package: foo
update: yes
# Install package foo using PORTAGE_BINHOST setup
- portage:
package: foo
getbinpkg: yes
# Re-install world from binary packages only and do not allow any compiling
- portage:
package: '@world'
usepkgonly: 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
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.