Manage packages with the pacman package manager, which is used by Arch Linux and its variants.
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. | ||
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. | |
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
For more information on what this means please read Extras Modules
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.