portage – Package manager for Gentoo

From Get docs
Ansible/docs/2.7/modules/portage module


portage – Package manager for Gentoo

New in version 1.6.


Synopsis

  • Manages Gentoo packages

Requirements

The below requirements are needed on the host that executes this module.

  • gentoolkit

Parameters

Parameter Choices/Defaults Comments

changed_use

boolean

added in 1.8

  • no

  • yes

Include installed packages where USE flags have changed, except when

flags that the user has not enabled are added or removed

(--changed-use)

deep

boolean

  • no

  • yes

Consider the entire dependency tree of packages (--deep)

depclean

boolean

  • no

  • yes

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

boolean

  • no

  • yes

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

boolean

added in 2.3

  • no

  • yes

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

boolean

  • no

  • yes

Include installed packages where USE flags have changed (--newuse)

nodeps

boolean

  • no

  • yes

Only merge packages but not their dependencies (--nodeps)

noreplace

boolean

  • no

  • yes

Do not re-emerge installed packages (--noreplace)

oneshot

boolean

  • no

  • yes

Do not add the packages to the world file (--oneshot)

onlydeps

boolean

  • no

  • yes

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

boolean

  • no

  • yes

Run emerge in quiet mode (--quiet)

quietbuild

boolean

added in 2.6

  • no

  • yes

Redirect all build output to logs alone, and do not display it

on stdout (--quiet-build)

quietfail

boolean

added in 2.6

  • no

  • yes

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

-

  • present

  • installed
  • emerged
  • absent
  • removed
  • unmerged
  • latest

State of the package atom

sync

-

  • web
  • yes
  • no

Sync package repositories first

If yes, perform "emerge --sync"

If web, perform "emerge-webrsync"

update

boolean

  • no

  • yes

Update packages to the best version available (--update)

usepkgonly

boolean

  • no

  • yes

Merge only binaries (no compiling). This sets getbinpkg=yes.

verbose

boolean

  • no

  • yes

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

Authors

  • William L Thomson Jr (@wltjr)
  • Yap Sok Ann (@sayap)
  • Andrew Udvare

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/portage_module.html