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 |
# 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
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 of strings | ['package', 'other-package'] |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.