portage - Package manager for Gentoo
New in version 1.6.
Synopsis
- Manages Gentoo packages
Requirements (on host that executes module)
- gentoolkit
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
changed_use (added in 1.8)
| no |
| Include installed packages where USE flags have changed, except when flags that the user has not enabled are added or removed (--changed-use) | |
deep | no |
| Consider the entire dependency tree of packages (--deep) | |
depclean | no |
| 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 | no |
| Prefer packages specified at PORTAGE_BINHOST in make.conf | |
jobs (added in 2.3)
| no | None | Specifies the number of packages to build simultaneously. | |
keepgoing (added in 2.3)
| no |
| Continue as much as possible after an error. | |
loadavg (added in 2.3)
| no | None | Specifies that no new builds should be started if there are other builds running and the load average is at least LOAD | |
newuse | no |
| Include installed packages where USE flags have changed (--newuse) | |
nodeps | no |
| Only merge packages but not their dependencies (--nodeps) | |
noreplace | no |
| Do not re-emerge installed packages (--noreplace) | |
oneshot | no |
| Do not add the packages to the world file (--oneshot) | |
onlydeps | no |
| 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 |
| Run emerge in quiet mode (--quiet) | |
state | no | present |
| State of the package atom |
sync | no |
| Sync package repositories first If yes, perform "emerge --sync" If web, perform "emerge-webrsync" | |
update | no |
| Update packages to the best version available (--update) | |
usepkgonly | no |
| Merge only binaries (no compiling). This sets getbinpkg=yes. | |
verbose | no |
| Run emerge in verbose mode (--verbose) |
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 "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
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/portage_module.html