pacman - Manage packages with pacman
Synopsis
- Manage packages with the pacman package manager, which is used by Arch Linux and its variants.
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
force
(added in 2.0)
|
no |
|
When removing package - force remove package, without any checks. When update_cache - force redownload repo databases.
|
|
name |
no |
Name of the package to install, upgrade, or remove.
aliases: pkg, package
|
||
recurse
(added in 1.3)
|
no |
|
When removing a package, also remove its dependencies, provided that they are not required by other packages and were not explicitly installed by a user.
|
|
state |
no | present |
|
Desired state of the package.
|
update_cache |
no |
|
Whether or not to refresh the master package lists. This can be run as part of a package installation or as a separate step.
aliases: update-cache
|
|
upgrade
(added in 2.0)
|
no |
|
Whether or not to upgrade whole system
|
Examples
# Install package foo - pacman: name: foo state: present # Upgrade package foo - pacman: name: foo state: latest update_cache: yes # Remove packages foo and bar - pacman: name: foo,bar state: absent # Recursively remove package baz - pacman: name: baz state: absent recurse: yes # Run the equivalent of "pacman -Sy" as a separate step - pacman: update_cache: yes # Run the equivalent of "pacman -Su" as a separate step - pacman: upgrade: yes # Run the equivalent of "pacman -Syu" as a separate step - pacman: update_cache: yes upgrade: yes # Run the equivalent of "pacman -Rdd", force remove package baz - pacman: name: baz state: absent force: yes
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
packages |
a list of packages that have been changed
|
when upgrade is set to yes | list | ['package', 'other-package'] |
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/pacman_module.html